You need to enable JavaScript to run this app. 在Magento 2中如何通过sftp从M1服务器传输产品关联图片
优惠活动
大模型
产品
解决方案
定价
更多

在Magento 2中如何通过sftp从M1服务器传输产品关联图片

Magento 1 到 Magento 2 产品图片SFTP迁移实现方案

实现逻辑说明

  • 你当前使用的是Magento 2原生的Magento\Framework\Filesystem\Io\Sftp类,本身已封装所有SFTP操作方法,无需引入第三方插件即可完成传输
  • M1产品图片默认存储根路径为media/catalog/product/,传入的$images参数需提前整理好所有待迁移图片的相对路径(例如/m/a/test-product.jpg)
  • M2临时存储目录建议使用pub/media/import/tmp/catalog/product/,需提前确保该目录对Web服务器进程开放写入权限

完整代码实现

首先在类的构造函数中依赖注入必要的原生类,补全downloadImages方法逻辑如下:

<?php
// 类属性提前声明
protected $tmpMediaDir;

public function __construct(
    \Magento\Framework\Filesystem $filesystem,
    \Magento\Framework\Filesystem\Io\Sftp $sftp
) {
    $this->filesystem = $filesystem;
    $this->sftp = $sftp;
    // 初始化M2 pub目录的写入实例
    $this->tmpMediaDir = $filesystem->getDirectoryWrite(\Magento\Framework\App\Filesystem\DirectoryList::PUB);
}

//FTP Connection
public function connectFtp($host, $user, $password, $ssl=true, $passive=true){
    return $this->sftp->open(
        array(
            'host'      =>  $host,
            'user'      =>  $user,
            'password'  =>  $password,
            'ssl'       =>  $ssl,
            'passive'   =>  $passive
        )
    );
}

// 从M1下载图片传输到M2临时文件夹
public function downloadImages($images){
    // M1产品图片根路径,可根据实际部署调整
    $m1MediaBase = self::M1_MEDIA_PATH ?? 'media/catalog/product/';
    // M2临时存储相对路径
    $m2TmpBase = 'media/import/tmp/catalog/product/';
    // 提前创建临时目录,避免写入失败
    $this->tmpMediaDir->create($m2TmpBase);

    // 连接M1 SFTP
    $connect = $this->connectFtp(self::M1_HOST, self::M1_USERNAME, self::M1_PASSWORD, self::M1_SSL, self::M1_PASSIVE);
    if($connect){
        foreach ($images as $imageRelativePath) {
            $m1ImagePath = $m1MediaBase . ltrim($imageRelativePath, '/');
            $m2ImagePath = $m2TmpBase . ltrim($imageRelativePath, '/');
            
            // 去重逻辑:已存在且大小一致的文件跳过传输
            if ($this->tmpMediaDir->isExist($m2ImagePath)) {
                $localFileSize = $this->tmpMediaDir->stat($m2ImagePath)['size'] ?? 0;
                $remoteFileSize = $this->sftp->stat($m1ImagePath)['size'] ?? 0;
                if ($localFileSize == $remoteFileSize && $localFileSize > 0) {
                    continue;
                }
            }

            // 读取M1端远程文件内容
            $fileContent = $this->sftp->read($m1ImagePath);
            if ($fileContent === false) {
                // 此处可添加日志记录,标记读取失败的文件路径后续补传
                continue;
            }

            // 写入M2本地临时目录
            $this->tmpMediaDir->writeFile($m2ImagePath, $fileContent);
        }
        // 传输完成后关闭SFTP连接,释放资源
        $this->sftp->close();
    }
}

注意事项

  • 错误处理:建议对读取失败、写入失败的文件单独记录日志,不要中断整批传输任务,待批量任务跑完后统一处理异常文件
  • 分批优化:如果待迁移图片量超过1000张,建议按批次执行任务,每次处理50-200张,避免PHP超时或内存溢出
  • 大文件适配:如果存在单张超过100M的大图片,可改用$sftp->read()的流式写入模式,避免一次性加载整个文件到内存
  • 完整性校验:所有图片传输完成后,可批量对比两端文件的MD5值,确认无传输损坏后再执行后续的M2图片导入逻辑

内容的提问来源于stack exchange,提问作者Abhishek Honrao

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 13:27:01