WP-CLI命令玩转S3 Uploads：批量迁移、文件管理实用教程

WP-CLI命令玩转S3 Uploads：批量迁移、文件管理实用教程

【免费下载链接】S3-UploadsThe WordPress Plugin to Store Uploads on Amazon S3项目地址: https://gitcode.com/gh_mirrors/s3/S3-Uploads

S3 Uploads是一款专为WordPress设计的插件，能够帮助用户将媒体文件存储到Amazon S3云存储中，有效减轻服务器存储压力并提升媒体访问速度。通过WP-CLI命令，用户可以轻松实现批量文件迁移、远程文件管理等高级操作，让WordPress媒体管理变得更加高效便捷。

准备工作：安装与配置S3 Uploads

在开始使用WP-CLI命令前，需要先完成S3 Uploads插件的安装和基础配置：

1. 克隆项目仓库

   git clone https://gitcode.com/gh_mirrors/s3/S3-Uploads

2. 安装依赖
   通过Composer安装项目所需依赖：

   cd S3-Uploads && composer install

3. 配置AWS访问凭证
   在wp-config.php中添加必要的常量配置（参考inc/class-wp-cli-command.php中的验证逻辑）：

   define('S3_UPLOADS_BUCKET', 'your-bucket-name'); define('S3_UPLOADS_KEY', 'your-access-key'); define('S3_UPLOADS_SECRET', 'your-secret-key');

图：S3 Uploads将WordPress媒体文件存储到Amazon S3，加速全球访问

核心WP-CLI命令全解析

1. 验证配置：确保连接正常

wp s3-uploads verify

该命令会自动检测AWS凭证是否有效，并通过上传/删除测试文件验证S3存储的读写权限（实现逻辑见inc/class-wp-cli-command.php#L17-L61）。成功后会显示Looks like your configuration is correct.。

2. 批量迁移文件：本地到S3无缝转移

wp s3-uploads upload-directory ./wp-content/uploads s3://your-bucket/path --concurrency=10

• --concurrency：设置并发上传数量（默认5），加速大批量文件迁移
• 支持断点续传和增量上传，适合首次迁移或定期同步

3. 文件管理：像操作本地文件一样管理S3存储

列出S3文件

wp s3-uploads ls [path]

例如查看所有图片文件：wp s3-uploads ls 2024/03

复制文件/目录

wp s3-uploads cp ./local-file.jpg s3://bucket/path/ wp s3-uploads cp ./local-dir s3://bucket/destination/

删除文件（支持正则匹配）

wp s3-uploads rm old-images/ --regex=.*\.png$

警告：删除操作不可逆，请谨慎使用！

4. 生成IAM策略：安全配置权限

wp s3-uploads generate-iam-policy

自动生成最小权限的AWS IAM策略（JSON格式），包含文件上传、删除、列表等必要权限（策略模板位于inc/class-wp-cli-command.php#L63-L105）。

实用场景：从日常管理到应急处理

场景1：媒体链接切换

快速启用/禁用S3媒体链接重写：

wp s3-uploads enable # 开启S3链接 wp s3-uploads disable # 恢复本地链接

场景2：附件ACL管理

修改特定附件的访问权限（例如设为私有）：

wp s3-uploads set-attachment-acl 123 private

其中123是WordPress附件ID，可通过wp s3-uploads get-attachment-files 123查看附件关联的所有文件。

场景3：多环境同步

开发环境向生产环境同步媒体文件：

wp s3-uploads cp s3://dev-bucket/uploads s3://prod-bucket/uploads

常见问题与解决方案

1. 权限错误
   若出现AccessDenied错误，使用wp s3-uploads generate-iam-policy检查权限配置，确保包含s3:PutObject和s3:DeleteObject等必要操作。

2. 大文件上传失败
   增加并发数并启用分块上传：

   wp s3-uploads upload-directory ./large-files/ s3://bucket/ --concurrency=20

3. 媒体链接不更新
   执行wp media regenerate重新生成缩略图，强制刷新S3链接。

通过WP-CLI命令，S3 Uploads插件的强大功能得到充分释放。无论是日常的媒体管理、批量迁移，还是复杂的权限配置，这些命令都能让WordPress媒体云存储变得简单高效。现在就尝试用命令行掌控你的S3存储吧！

【免费下载链接】S3-UploadsThe WordPress Plugin to Store Uploads on Amazon S3项目地址: https://gitcode.com/gh_mirrors/s3/S3-Uploads