在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
相关产品推荐
相关产品推荐

