PrestaShop开发：通过PHP代码为商品添加多张图片的实现方法

你现有代码仅支持单图上传的核心原因是：仅创建了1个Image实例、仅调用了1次图片拷贝方法，要支持多图上传只需将单图处理逻辑改造为循环遍历多URL列表即可，无需改动其他商品字段保存逻辑。

改造要点 #

• 调整入参结构：将原单个urlImage字段替换为多图片节点，推荐XML结构为<images><image>图片URL1</image><image>图片URL2</image></images>，同时保留对旧版单urlImage传参的兼容
• 循环内每次新建Image实例：不可复用同一个实例对象，否则会覆盖已生成的图片记录
• 封面图唯一规则：仅将遍历到的第一张图片cover属性设为true，其余图片设为false，避免商品主图冲突
• 异常兜底：单张图片拉取/保存失败时直接跳过，不中断整个商品保存流程，同时删除残留的空图片数据库记录

改造后完整代码 #

$xml = simplexml_load_file('php://input');
$product = new Product($xml->id);
$product->category = [2, 7];
$product->id_category_default = (int)$xml->id_category_default; // 分类设置
$product->name = $xml->name; // 商品名称
$product->price = $xml->price; // 商品售价
$product->unit_price = $xml->unit_price; // 单位价格
$product->wholesale_price = $xml->wholesale_price; // 批发价
$product->tax_rate = $xml->tax_rate; // 税率
$product->ecotax = $xml->ecotax; // 环保税
$product->ean13 = $xml->ean13; // 商品条码
$product->description = $xml->description; // 详细描述
$product->description_short = $xml->description_short; // 短描述
$product->reference = $xml->reference; // 商品参考号
$product->weight = $xml->weight; // 重量
$product->height = $xml->height; // 高度
$product->width = $xml->width; // 宽度
$product->depth = $xml->depth; // 深度
$product->minimal_quantity = (int)$xml->minimal_quantity; // 最小起订量
$product->available_date = $xml->available_date; // 上架日期
$product->delivery_in_stock = $xml->delivery_in_stock; // 有货配送提示
$product->delivery_out_stock = $xml->delivery_out_stock; // 缺货配送提示
$product->additional_shipping_cost = $xml->shipping_cost; // 额外运费
$product->indexed = 1;
$product->active = true;

// 布尔值字段处理
$product->online_only = $xml->online_only == "true";
$product->available_for_order = $xml->available_for_order == "true";
$product->show_price = $xml->show_price == "true";

$product->save();
$product->updateCategories($product->category);
$defaultAttrId = $product->getDefaultIdProductAttribute();
StockAvailable::setQuantity($product->id, $defaultAttrId, $xml->quantity);

// 多图片处理逻辑 开始
$imageUrls = [];
// 优先读取多图节点
if (isset($xml->images) && isset($xml->images->image)) {
    foreach ($xml->images->image as $imgUrl) {
        $trimUrl = trim((string)$imgUrl);
        if (!empty($trimUrl)) {
            $imageUrls[] = $trimUrl;
        }
    }
}
// 兼容旧版单图传参
if (empty($imageUrls) && isset($xml->urlImage)) {
    $trimUrl = trim((string)$xml->urlImage);
    if (!empty($trimUrl)) {
        $imageUrls[] = $trimUrl;
    }
}

if (!empty($imageUrls)) {
    $isCover = true;
    foreach ($imageUrls as $imgUrl) {
        $image = new Image();
        $image->id_product = $product->id;
        $image->position = Image::getHighestPosition($product->id) + 1;
        $image->cover = $isCover;
        
        if ($image->save()) {
            $copyResult = AdminImportControllerCore::copyImg(
                (int)$product->id,
                (int)$image->id,
                $imgUrl,
                'products',
                false
            );
            // 图片拷贝失败则删除无效的图片记录
            if (!$copyResult) {
                $image->delete();
            }
        }
        // 第一张之后的图片都不是封面
        $isCover = false;
    }
}
// 多图片处理逻辑 结束

开发注意事项 #

• 提前确认PHP运行进程对PrestaShop根目录下/img/p/目录有写入权限，否则图片文件会保存失败
• 若为商品更新场景，可先调用Image::getImages()方法获取商品现有图片列表，做URL去重避免重复上传相同图片
• 系统会自动根据上传的原图生成各尺寸的缩略图，无需额外调用缩略图生成方法
• 商品多店铺模式下，需要给$image对象设置对应的id_shop属性，否则图片仅会在当前默认店铺显示

内容的提问来源于stack exchange，提问作者Baptiste L