============================================================
【项目名称】PIC2CLD Professional (v1.1.0 MVP)
【核心定位】WordPress 工业级 Cloudflare R2 存储与管理核心
【开发者】 囧丁乙
文件：eezzpic2cld.zip
============================================================
内容已隐藏
扫码、关注、回复“解锁码”即可下载！
============================================================
一、 项目概览
————————————————————
PIC2CLD 是一款专为小型商业站点与极简主义者设计的 WordPress 插件。
它将 Cloudflare R2 对象存储深度集成至 WP 媒体库生态，实现“本地零占用、
云端高加速”的工业级图片处理工作流。
二、 核心特性
————————————————————
1. 双域上传终端：
– [✂️ 剪裁与精炼]：集成 Cropper.js，支持单图精确剪裁后同步。
– [📦 工业批量推流]：支持多文件拖拽上传，通过异步队列直传云端。
2. Native-First 架构：
– 物理接管媒体库 URL 展示逻辑。
– 自动生成媒体库附件记录，兼容所有 WP 标准主题与插件。
3. AWS V4 签名算法：
– 基于 PHP 原生实现的 R2 签名验证，无需重量级 SDK。
4. 多桶管理 (当前版本限制)：
– 支持单一活动存储桶连接（专业版支持多区域冗余）。
三、 安装与配置说明
————————————————————
1. 环境要求：
– PHP 7.4+ (建议 PHP 8.4+)
– 已安装 OpenSSL 与 cURL 扩展。
– 确保插件目录下 assets 文件夹包含 cropper.min.css/js。
2. 第一步：配置存储桶 (Buckets)
前往 [EEZZ Upload] -> [Bucket Management] 填写：
– Bucket Alias: 自定义别名（如: Global-CDNs）
– R2 Physical Name: Cloudflare 控制台中的桶名称
– Account ID: Cloudflare R2 账户 ID
– Access/Secret Key: R2 API 令牌的密钥对
– Public URL: 绑定的自定义域名或 R2 公网访问地址
3. 第二步：使用控制台 (Console)
前往 [EEZZ Upload] 菜单：
– 选择目标存储桶。
– 选择 [Single Mode] 进行手动剪裁。
– 使用 [Batch Mode] 进行大规模图片库迁移。
四、 技术架构与安全声明 (重要)
————————————————————
1. 数据流向：
上传 (Browser) -> REST API (Plugin) -> R2 Request (Engine) -> R2 Cloud
2. 安全机制：
– 所有上传请求均受 WP Nonce 令牌保护。
– 严格执行 current_user_can(‘manage_options’) 权限校验。
3. 已知风险 (MVP 版本)：
– 存储桶密钥目前以 Base64 形式存储在数据库中。
– 建议仅在受信的受管服务器环境下使用。
– 专业版 (PRO) 将引入 AES-256-GCM 加密与命名空间隔离。
五、 卸载与清理
————————————————————
– 停用插件后，已上传至云端的图片 URL 将恢复为本地路径（如果本地无文件将无法显示）。
– 若要彻底移除数据，需手动清理 wp_options 表中的 eezzpic2cld_buckets 记录。
————————————————————
如果你在使用中遇到BUG请联系我，我会尽快修复。
