use cot\modules\files\services\FileService;

Спасибо за помощь! Заработало. Файлы прикрепляет, теперь нужно осознать, что с этим можно еще сделать.

use cot\modules\files\models\File;

Примерно так:

<?php

use cot\modules\files\models\File;

defined('COT_CODE') or die('Wrong URL.');

Для каждого товара, может быть одно или несколько изображений.

Несколько

Fatal error: Uncaught Error: Class "File" not found in ...

Я так понимаю нужно еще дополнительно класс File подключить?

Такого подключения не достаточно?

require_once cot_incfile('files', 'module'); 

 И еще вдогонку вопрос, по коду не понял. Для каждого товара, может быть одно или несколько изображений.  Я это учитываю, и у меня переменная - $id_attach, которая считает количество изображений для каждого товара. Как эту переменную учитывать, на примере Вашего кода?
 

 $imageFileName = 'image-'. $id . '-' .  $id_attach . '-' . uniqid() . '.jpg';

if (@copy('http://someserver.com/somefile.jpg','./somefile.jpg')) {
        echo "File copied from remote!";
} else {
    $errors = error_get_last(); 
    echo 'COPY ERROR: ' . $errors['type']; 
    echo '<br />\n' . $errors['message'];
}

Сэкономите память не загружая в нее данные, которые не собираетесь обрабатывать. Фактически файл при скачивании все равно будет загружен в память, но при сохранении на диск память будет освобождена. И это не расходует память, выделяемую скрипту на выполнение.

// Проверяем, сохранилось ли изображение
if (file_exists($fullImagePath))

Это лишнее. Функция copy() вернет TRUE в случае успеха и FALSE в противном случае. Достаточно проверить результат выполнения функции.

PHP в режиме командной строки как правило не имеет ограничений по памяти и времени выполнения. Этот компонент позволяет запускать Cotonti из командной строки.

Не накапливайте в памяти ненужные данные. После обработки каждого товара в памяти не должно оставаться "мусора". Ненужные более данные должны быть удалены или перезаписаны следующим товаром.

Модуль файлов используется в основном для удобной загрузки файлов и привязки их к объектам (страницы, посты, товары и т.п.) через веб интерфейс и для удобного вывода файлов в веб интерфейсе. Загрузка у Вас автоматизирована. Если вы не собираетесь выводить каталог товаров в браузер - особого смысла нет.

Если он все же нужен, у него нет отдельного метода для сохранения файла, который существует локально (надо бы сделать). Но можно написать примерно так:
 

// $fullImagePath - Путь к файлу локально из Вашего примера

$file = new File();
$file->original_name = $originalName; // Исходное имя файла (используется для отображения пользователю)
$file->user_id = $uid;
$file->source = 'shop';
$file->source_id = $product->id; // ID сохраненного товара
$file->ext = mb_strtolower(cot_filesGetExtension($fullImagePath));
$file->mime_type = mime_content_type($fullImagePath);
$file->is_img = 1;
$file->size = filesize($fullImagePath));


Cot::$db->beginTransaction();
try {
	$fileId = $file->save();
	if (!fileId) {
		throw new Exception('Ошибка при сохранении');
	}
	
	// Path relative to files root directory
	$relativeFileName = FileService::generateFileRelativePath($objFile);
	$file->path = dirname($relativeFileName);
	$file->file_name = basename($relativeFileName);
	$file->filesystem_name = FileService::getFilesystemName($file->source, $file->source_field);
	 
	// Path relative to site root directory
	$fileFullName = Cot::$cfg['files']['folder'] . '/' . $relativeFileName;
	if (!@rename($fullImagePath, $fileFullName)) {
		throw new Exception('Ошибка при сохранении');
	} 
	 
	$file->save();
	 
    Cot::$db->commit();
} catch(\Throwable $e) {
    Cot::$db->rollBack();
    // не удалось сохранить файл;
}

// Получаем содержимое изображения
$imageContent = fetchImage((string)$pictureUrl);

// Генерируем уникальное имя файла
$imageFileName = 'image_' . uniqid() . '.jpg';
$fullImagePath = $savePath . '/' . $imageFileName;   /////////////////

// Сохраняем изображение в файл
file_put_contents($fullImagePath, $imageContent);

// Проверяем, сохранилось ли изображение
if (file_exists($fullImagePath)) 
{
    if (cot_module_active('files')) 
    {
        require_once cot_incfile('files', 'module'); 
        ......
    }

}

P.S. Хочу учесть, один нюанс. Товары уже загружены, теперь нужно прикрепить изображение к ним. Я изначально разделил обработку на добавление категорий, потом товаров и теперь изображений. Вообще вся задача обработки xml-файла ресурсоёмкая. Что еще посоветуете сделать, чтобы процесс ускорить и минимизировать ресурсы сервера? В том числе и при обработке изображений?