OSS插件oss-upload

原版本https://github.com/xiaomac/oss-upload,架构过老且无法兼容php8.2,所以直接重构
经过这一轮持续迭代,OSS Upload 从单纯的媒体附件上传工具,进一步完善了文章链接迁移、图片样式处理、特色图片兼容性和后台设置体验。
从他的版本直接迭代到5.0,然后慢慢更新。本次版本从 5.0 更新至 5.0.6,重点解决了一个实际使用中比较容易被忽略的问题:WordPress 文章正文中的图片和文章特色图片,往往不是通过同一套代码生成的。如果只处理文章正文,主页上的特色图片仍然可能出现地址不完整、样式后缀丢失或图片无法显示的情况。

一、5.0:从“上传到 OSS”扩展到“文章链接迁移”

5.0 版本首先完善了文章链接迁移能力,并增加了一键替换文章老链接的功能。
在使用 OSS 作为图片存储后,站点中可能同时存在以下几类地址:
•WordPress 本地上传目录地址
•OSS 图片地址
•旧域名或旧 CDN 地址
•页面构建器保存在 postmeta 中的图片地址
过去如果需要统一替换,通常只能直接操作数据库,风险较高,也不方便确认影响范围。5.0 增加了预览优先的一键替换流程,可以先查看将要处理的文章和匹配数量,再确认执行批量替换。
目前支持以下替换方向:
•本地图片地址 → OSS 图片地址
•OSS 图片地址 → 本地图片地址
•根据 URL Fixer 配置执行自定义查找和替换
•可选处理页面构建器使用的序列化 postmeta 数据
替换操作采用分批处理,并增加了权限校验和 nonce 安全验证,减少大批量处理时的风险。

二、图片样式后缀:避免原图地址失效

阿里云 OSS 图片服务通常会通过样式后缀处理图片,例如:
photo.jpg-full
其中:
•- 是样式分隔符
•full 是原图样式名称
如果分隔符或原图样式配置不一致,图片地址虽然看起来已经替换成 OSS 地址,但 OSS 实际返回的图片可能不是预期尺寸,甚至无法读取。
5.0 在本地地址替换为 OSS 地址时,会读取后台设置中的:
•样式分隔符
•原图样式
本地地址:photo.jpg OSS 地址:https://img.example.com/uploads/photo.jpg 分隔符:- 原图样式:full
最终结果为:
https://img.example.com/uploads/photo.jpg-full
同时,已有查询参数也会被保留,避免替换过程中破坏原有的图片处理参数。

三、5.0.1:修复重复追加样式后缀

在早期版本中,如果重复执行替换操作,或者同一个图片地址经过多个处理流程,可能出现这样的地址:
photo.jpg-full-full
这类地址通常不是用户真正配置出来的,而是样式后缀被重复追加造成的。它会导致 OSS 样式匹配失败,最终表现为图片无法显示或返回错误图片。
5.0.1 将样式处理改为幂等逻辑:
•photo.jpg 会变成 photo.jpg-full
•已经是 photo.jpg-full 时不会继续追加
•photo.jpg-full-full 会自动整理为 photo.jpg-full
•多次执行不会继续生成更多重复后缀
这意味着即使历史文章中已经存在重复样式后缀,前台显示时也可以自动进行兼容归一化。

四、5.0.2—5.0.4:连续修复特色图片显示问题

这次迭代中最重要的一部分,是对 WordPress 特色图片,也就是 Post Thumbnail 的完整兼容。
文章正文中的图片通常保存在文章内容里,可以通过 the_content 或文章内容替换处理。但是特色图片一般只保存一个附件 ID,主题在主页输出时,再通过 WordPress 的图片 API 生成实际 HTML。
因此,正文图片正常,并不代表特色图片也一定正常。

5.0.2:处理最终特色图片 HTML

5.0.2 增加了对 post_thumbnail_html 的处理,在主题生成最终特色图片 HTML 后,再次检查图片地址并统一样式后缀。
这可以兼容已经存在的历史地址,例如:
photo.jpg-full-full
最终输出时会归一化为:
photo.jpg-full

5.0.3:修复主页 srcset 原图判断

很多主题的主页图片会使用响应式图片输出,也就是 srcset。在这个流程中,WordPress 会同时生成原图和多个缩略图尺寸。
之前的问题是,插件在 URL 归一化后才判断当前图片是不是原图,导致原图文件名已经带上样式后缀,判断结果失败,主页输出时反而丢失了 -full。
5.0.3 调整了处理顺序:
1.先根据原始文件名判断是否为原图
2.再执行本地地址到 OSS 地址的转换
3.最后添加原图样式后缀
这样可以保证主页的原图 srcset 项不会因为处理顺序错误而丢失样式后缀。

5.0.4:兼容绕过缩略图 HTML 的主题

部分主题不会经过 post_thumbnail_html,而是直接调用 WordPress 的底层图片 API,例如:
•wp_get_attachment_image_src
•wp_get_attachment_image_attributes
•src
•srcset
•data-src
•data-original
•data-original-src
5.0.4 对这些输出路径增加了兼容处理,确保使用懒加载、响应式图片和自定义封面组件的主题,也能保留正确的 OSS 样式后缀。

五、5.0.5:新增自动补全文章图片样式

为了减少手动查找设置和替换方向的操作,5.0.5 增加了:
自动补全文章图片样式
按钮位于后台的「图片与分发」设置中。
使用方法:
1.设置样式分隔符,例如 -
2.设置原图样式,例如 full
3.点击「自动补全文章图片样式」
4.插件自动跳转到「链接与迁移」区域
5.自动选择「自动补全 OSS 原图样式后缀」
6.自动执行预览
7.确认预览结果后,再执行批量替换
这个功能只处理已经是 OSS 地址的图片,并为它们补全当前配置的原图样式,不会把本地图片误判成 OSS 图片。

六、后台设置界面优化

5.0.5 同时对后台设置页进行了重新整理,减少长页面中查找选项的成本。
目前后台设置按任务分为:
•连接与存储
•图片与分发
•链接与迁移
•高级设置
同时增加了:
•中文页面标题
•中文快捷导航
•当前启用状态显示
•顶部保存按钮
•未保存修改提示
•移动端适配
•更明确的启用、停用和迁移提示

七、5.0.6:修复底层图片 API 未转换 OSS 地址的问题

5.0.6 是本轮特色图片修复的最后一步。
测试中发现,有些主题传给 WordPress 图片 API 的仍然是本地上传地址,例如:
https://example.com/wp-content/uploads/2026/cover.jpg
此前的处理逻辑只会对已经是 OSS 地址的图片补样式后缀。如果输入还是本地地址,就无法完成 OSS 地址转换,最终主页仍然可能没有正确的 -full 后缀。
5.0.6 统一了底层图片 URL 处理流程:
本地图片地址 → 转换为 OSS 图片地址 → 添加原图样式后缀 → 清理重复后缀
本次已覆盖并验证:
•主页特色图片
•后台图片 API
•src
•srcset
•data-src
•最终 post_thumbnail_html
•本地地址 → OSS 地址转换
•-full 样式后缀保留
•-full-full 重复后缀清理
再看看有没有问题,没问题回头扔个链接上来
上一篇 出差所拍2
目录
Sora

Sora管理员

在职牛马,现任某不知名企业任职管理,人生在世就是笑笑别人,再被别人笑笑。

本月创作热力图

少
多
最新评论
暂无评论