S3媒体上传 (已优化)

一个自用的 WordPress S3插件

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/ayfl269/s3-plugin/archive/refs/heads/main.zip

No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Readme github.com/ayfl269/s3-plugin ↗

适用于 WordPress 的 S3 插件，通过 S3 协议将上传的媒体文件保存到云端存储中。支持自动转换 WebP 格式及缩略图同步。

功能特性

多种存储模式：支持本地模式、云端模式和同步模式
自动 WebP 转换：可选将上传的图片自动转换为 WebP 格式
智能连接检测：实时检测 S3 连接状态并在后台显示
完整的媒体管理：在媒体库中直观显示文件存储位置

系统要求

WordPress 5.0 或更高版本
PHP 7.4 或更高版本
一个可访问的 S3 存储服务

安装方法

方法一：手动安装

下载插件文件到本地
将整个插件文件夹上传到 /wp-content/plugins/ 目录
在 WordPress 后台插件页面激活插件

方法二：Git 克隆

cd /path/to/your/wordpress/wp-content/plugins/
git clone https://github.com/ayfl269/s3-plugin.git s3

然后在 WordPress 后台激活插件。

配置说明

激活插件后，在 WordPress 后台左侧菜单找到 "S3" 选项进行配置。

S3 配置参数

参数	说明	示例
存储模式	选择文件存储策略	本地模式 / 云端模式 / 同步模式
Access Key	S3 访问密钥	YOUR_ACCESS_KEY
Secret Key	S3 私密密钥	YOUR_SECRET_KEY
Region	S3 区域	us-east-1
Bucket	存储桶名称	your-bucket-name
API端点URL	S3 API 端点	https://s3.amazonaws.com
公共访问URL	文件访问地址	https://your-bucket.s3.amazonaws.com/
目标文件夹	存储路径	/{year}/{month}(支持日期变量)

存储模式详解

本地模式：文件保存在服务器本地
云端模式：文件保存在 S3 云端（本地不留存）
同步模式：文件同时保存在本地和 S3 云端

其它设置

转换为WebP格式：启用后会自动将上传的 JPG/PNG 图片转换为 WebP 格式

技术架构

核心组件

s3/
├── S3MediaUploader.php          # 插件主文件
├── includes/
│   ├── class-s3-service.php     # S3 服务核心类
│   ├── class-admin-settings.php # 后台设置界面
│   └── class-media-handler.php  # 媒体处理钩子
├── admin.js                     # 后台 JavaScript
├── admin.css                    # 后台样式
└── vendor/                      # AWS SDK for PHP 依赖

主要类说明

S3_Service：负责与 S3 服务的通信，包括上传、删除等操作
Admin_Settings：处理后台设置页面和用户界面
Media_Handler：拦截 WordPress 媒体上传流程并进行相应处理

支持的 S3 服务

本插件兼容以下 S3 服务：

目前仅测试过rustfs

如遇到问题或有功能建议，请提交 Issue

许可证

本插件遵循 GNU General Public License v3.0 许可证发布。