距离上次发布 v1.1 版本已经过去了三个月，Typecho 官方也发布了备受期待的 1.3.0 版本。这次大版本更新带来了许多底层架构的改进，但也导致了不少插件出现兼容性问题。
Typecho 又拍云文件管理插件修改版使用指南：新增自定义目录结构功能
昨天我更新了新版本遇到的问题：升级 Typecho 1.3.0 后，又拍云插件在后台文件管理页面报错，无法正常显示已有文件的 URL。于是更新了 UpyunFile v1.2 版本，这个版本不仅彻底解决了 Typecho 1.3.0 的兼容性问题，还进一步简化了配置流程，让插件使用更加便捷。
升级 Typecho 1.3.0 后，你可能会遇到以下问题：
TypeError: UpyunFile_Plugin::attachmentHandle():
Argument #1 ($content) must be of type array, Typecho\Config given
...
https://cdn.example.com/ ← 路径缺失！
v1.2 版本采用了多重兼容策略，确保在不同 Typecho 版本下都能正常工作：
public static function attachmentHandle(Typecho\Config $content) {
// 1. 优先检查新版本的 Config 对象结构
if (isset($content->attachment) && isset($content->attachment->path)) {
$path = $content->attachment->path;
}
// 2. 其次检查直接 path 属性
else if (isset($content->path)) {
$path = $content->path;
}
// 3. 最后尝试从 text 字段反序列化（兼容旧数据）
else if (isset($content->text)) {
$attachment = @unserialize($content->text);
if (is_array($attachment) && isset($attachment['path'])) {
$path = $attachment['path'];
}
}
// 构建完整 URL
return Typecho_Common::url($path, $domain);
}
在代码审查中发现了一个潜在的资源管理问题：
修复前（存在资源泄漏风险）：
$fh = fopen($uploadfile, 'rb');
$upyun->write($path, $fh);
// 如果 write() 抛出异常，fclose 不会执行
if (is_resource($fh)) {
fclose($fh);
}
修复后（确保资源释放）：
$fh = fopen($uploadfile, 'rb');
try {
$upyun->write($path, $fh);
} finally {
// 无论是否异常，都会执行
if (is_resource($fh)) {
fclose($fh);
}
}
在 v1.1 版本中，我提供了三种目录结构模式：
/files/年/月/文件名/typecho/usr/uploads/年/月/文件名/年/月/文件名但在实际使用中，我发现：
v1.2 版本移除了目录结构模式选择，只保留一个自定义路径输入框：
自定义路径：/files （默认为 /files）
最终文件路径格式固定为：
{自定义路径}/{年}/{月}/{文件名}
例如：/files/2026/04/example.jpg
🐛 修复
✨ 优化
/files或者你直接获取 GitHub 上 Plugin.php 的代码覆盖一下呗，😂
下载插件压缩包
解压至 Typecho 的 usr/plugins 目录，文件夹命名为 UpyunFile
在 Typecho 后台「控制台」->「插件」中启用插件
进入插件设置页面，配置以下参数：
https://cdn.example.com）/files）保存设置，完成安装
| 配置项 | 说明 | 示例 |
|---|---|---|
| 图片链接修改 | 开启后将文章中的图片链接替换为 CDN 链接 | 建议开启 |
| 绑定域名 | 又拍云服务绑定的域名 | https://cdn.example.com |
| 自定义路径 | 文件上传的基础路径 | /files |
| 服务名称 | 又拍云服务名称 | mybucket |
| 操作员 | 又拍云操作员账号 | operator |
| 密码 | 又拍云操作员密码 | password |
又拍云图片处理
需要在又拍云控制台创建缩略图版本，然后将版本名称填入插件配置。
thumb、small 等jpg、png、webp⚠️ 注意：带有 _nothumb 后缀的图片不会被处理（如 example_nothumb.png）
Token 防盗链
如果您在使用过程中遇到任何问题，欢迎通过以下方式反馈：
欢迎提交 Pull Request 或提出改进建议！
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。