对象存储与图片 CDN

对象存储和图片 CDN 可以减轻源站压力，但它们会改变媒体 URL、回源链路、跨域策略和缓存行为。子比主题的文章图片、用户头像、封面、收款码、商品图、论坛封面、附件下载、分享海报和微信分享都依赖 WordPress attachment 或图片 URL，接入对象存储前要先理解这些边界。

不要把“图片能显示”当作唯一验收标准。还要测试上传、缩略图、灯箱、海报生成、微信分享、付费下载、用户头像、商品图、移动端和迁移后的旧图片。

适用场景

对象存储解决文件存储和分发问题，不负责 WordPress 权限判断。付费下载、私密附件、用户资料、订单权限仍然要在服务端校验。

先跑通源站

接入前先在源站完成：

1. 上传普通图片。
2. 生成缩略图。
3. 文章插入图片。
4. 用户头像和封面上传。
5. 商品图片、论坛封面和前台投稿上传。
6. 图片灯箱可以打开。
7. 分享海报可以生成。
8. 付费附件下载权限正常。

如果源站上传本身失败，先看 媒体上传 和 环境检查，不要直接把问题交给对象存储。

WordPress 附件模型

子比主题大量使用 WordPress attachment：

接入对象存储后，最好仍然让 WordPress 认为“附件是正常 attachment”。也就是说，上传、入库、生成 attachment metadata、返回 URL 这些步骤不能被绕过。

上传文件名

主题支持上传自动重命名。文件名会在入库前被改掉：

if (_pz('newfilename_type') !== 'random') {
    $file['name'] = current_time('YmdHis') . mt_rand(10, 99) . mt_rand(0, 9) . '-' . $file['name'];
} else {
    $info         = pathinfo($file['name']);
    $ext          = empty($info['extension']) ? '' : '.' . $info['extension'];
    $md5          = md5($file['name']);
    $file['name'] = substr($md5, 0, 10) . current_time('YmdHis') . $ext;
}

对接对象存储时，不要在上传前用原始文件名拼远程 URL。应以 WordPress 最终 attachment URL 为准。否则自动重命名后，数据库 URL、对象存储文件名和实际附件会对不上。

URL 替换方式

对象存储插件通常有两类模式：

无论哪种模式，都要确保：

• wp_get_attachment_url() 返回可访问 URL。
• wp_get_attachment_image_src() 能返回正确尺寸。
• 缩略图也被同步或可回源生成。
• attachment_url_to_postid() 在关键场景仍可用。
• 删除附件时远端文件同步删除或有清理策略。

如果插件只替换前台 HTML，不改变 attachment URL，子比主题的海报、下载、用户资料和后台字段可能仍读取旧地址。

防盗链

开启防盗链前先确认这些来源不会被拦截：

防盗链误拦截时，常见表现是图片 403、灯箱只显示占位图、海报生成失败、微信分享无图、商品图或头像不显示。

CORS 和海报

分享海报会把图片画进 canvas。如果图片来自 OSS、CDN 或启用了防盗链，浏览器可能认为 canvas 被跨域污染，导致无法导出海报。

主题提供 share_img_compatible_s 兼容开关：

if (_pz('share_img_compatible_s')) {
    $data['banner']         = zib_get_img_auto_base64($data['banner']);
    $data['banner_default'] = zib_get_img_auto_base64($data['banner_default']);
    $data['logo']           = zib_get_img_auto_base64($data['logo']);
}

优先配置 OSS/CDN 的 CORS，再考虑开启兼容模式。兼容模式会把图片转 base64，能提升兼容性，但也会增加服务端处理和响应体积。

至少允许：

Origin: 当前站点域名
Methods: GET, HEAD
Headers: *
Expose-Headers: Content-Length, Content-Type

具体字段按服务商面板为准。配置后清理 CDN 缓存，再重新生成海报测试。

图片灯箱

图片灯箱依赖最终 HTML 中的 <img>、真实图片 URL、懒加载 data-src 和前端脚本。接入 CDN 后常见异常：

灯箱细节见 图片灯箱与媒体。

付费附件和下载

普通附件下载入口会读取 attachment，再根据本地文件或 URL 输出：

$attachment_url = wp_get_attachment_url($attachment->ID);
header('location:' . $attachment_url);

但付费下载不是普通附件下载。Zibpay 会校验订单、会员、积分、次数、游客订单 Cookie 和下载日志。对象存储的私有文件不要直接把真实 URL 暴露给前端，应该继续走 Zibpay 权限链路。

如果对象存储插件把文件迁到远端后删除本地文件，要确认：

• 普通附件是否可以跳转到远端 URL。
• 付费下载是否仍能校验权限。
• 本地文件下载逻辑是否会因为 get_attached_file() 找不到文件而失败。
• 是否需要签名 URL 或临时 URL。

付费链路见 Zibpay 付费下载与资源权限。

用户头像、封面和收款码

用户头像、封面、微信收款码、支付宝收款码等会保存附件 ID 和 URL。上传成功后主题还会删除旧附件或清理缓存。

对象存储接入后要测试：

如果只替换前台图片 URL，而后台保存的附件 ID 失效，迁移、删除、缓存刷新都会出问题。

商品、论坛和模块图片

子比主题商城、论坛和模块会保存大量附件 ID 或图片 URL：

对象存储迁移后，不要只看文章正文图片。首页模块、商城详情页、论坛板块页、移动端底部入口和用户中心也要逐项打开。

缓存策略

适合 CDN 长缓存：

*.jpg
*.jpeg
*.png
*.webp
*.gif
*.svg
*.woff
*.woff2
*.css
*.js

谨慎缓存：

HTML 页面
admin-ajax.php
用户中心
购物车
支付页
验证码接口
上传接口
付费下载入口

对象存储和图片 CDN 只应加速静态资源。动态页面排除规则见 伪静态、缓存与 CDN。

迁移和回源

从本地 uploads 迁移到对象存储时：

1. 先完整备份 wp-content/uploads。
2. 同步历史文件到对象存储。
3. 确认缩略图和原图都存在。
4. 替换或过滤 attachment URL。
5. 清理对象缓存、页面缓存和 CDN。
6. 抽查不同年份目录的图片。
7. 测试头像、封面、商品图、论坛图、海报和下载。

换域名、换 CDN 域名或换对象存储桶时，继续看 站点迁移与换域名。如果附件 ID 还在但物理文件丢了，数据库替换不能解决问题。

常见问题

开发边界

• 上传仍应走 zib_php_upload() 和 WordPress attachment，不要直接把文件丢到对象存储后只保存 URL。
• 读取图片优先用 wp_get_attachment_url()、wp_get_attachment_image_src() 或主题封装。
• 对象存储 URL 不等于权限校验，付费下载继续走 Zibpay。
• 防盗链、CORS、HTTPS 和 CDN 缓存要一起测试。
• 海报跨域优先配 CORS，兼容模式作为兜底。
• 迁移时保留附件 ID、缩略图、原图和对象存储路径的一致性。

本页吸收了子比官网阿里云 OSS、图片 CDN、缓存加速相关公开教程线索，并结合 action/media.php、action/user.php、inc/functions/zib-attachment.php、inc/functions/zib-share.php、action/function.php、js/poster-share.js、媒体上传、图片灯箱与媒体 和 分享、海报与微信分享 蒸馏整理。