Skip to content

v1.1.0

Choose a tag to compare

@erikwang2013 erikwang2013 released this 25 Sep 13:35
· 24 commits to main since this release

本版把插件从「webman 专用」改造为 框架无关内核 + 七个宿主适配器,并补齐 12 种语言的文档。

支持的框架

同一份包(composer require erikwang2013/aetherupload-webman)现在可在下列框架下运行,每个都有真装框架、真跑完整上传链路的端到端测试兜底:

框架 接入方式
webman 原生支持,composer require 即自动分发配置 / 路由 / 命令 / 前端脚本
Laravel ServiceProvider + vendor:publish
ThinkPHP app/service.php 注册 Service
Symfony Bundle + 路由资源导入
Slim 一行 Bootstrap::create()
Hyperf ConfigProvider
Yii2 应用 bootstrap 挂 Bootstrap

接入步骤见 README「支持的框架」章节。包名保留 webman 是历史原因(已发布多年,改名会打断现存安装),不影响在其余框架下使用。

多语言文档

docs/i18n/ 下新增 12 种语言的完整 README 与三张设计图(架构 / 设计思路 / 上传生命周期)译文,顶部可互相跳转:

English · 한국어 · Русский · Deutsch · Français · Español · Português · हिन्दी · العربية · বাংলা · Bahasa Indonesia · 日本語

中文原文仍在仓库根 README.md。译文的作业规范见 docs/i18n/TRANSLATING.md(含 SVG 文案抽取 / 回填工具,新增语言照做即可)。

正确性与安全修复

  • 宽松模式(lax_mode)100% 失败:空 resource_hash 未过路径校验,整条流程被判定为 invalid_operation
  • aetherupload:clean 误删活跃文件:临时名改为随机 hex 后仍按文件名前缀解析时间戳,实测 1856/20000 个新文件被判为「旧」→ 改用 filemtime()
  • aetherupload:build 先清空索引再中止:扫描阶段遇到 .DS_Store 之类文件即抛错,此时秒传索引已被清空
  • 三个控制台命令在 symfony/console 7 下加载即致命(缺 execute(): int 返回类型)
  • ConfigMapper 单例在常驻进程 / 协程下跨请求串组:并发请求会读到别人的分组配置(Hyperf 协程下可稳定复现)
  • Install 忽略 root_dir,且未绑定时抛「尚未绑定宿主适配器」导致每次 composer require 失败
  • X-Accel-Redirect 重复包含 root_dir,nginx 直发 404
  • PartialResource::createGroupSubDir() 的 is_dir → mkdir TOCTOU 竞态

升级注意

无破坏性变更:配置键、路由、控制台命令、模板助手函数均与 1.0.x 一致,webman 站点直接 composer update 即可。

依赖变化:新增 symfony/translation(内核的翻译引擎,硬依赖);symfony/console 移入 require-dev,只有用到控制台命令时才需要(webman 应用自带 webman/console,不受影响)。

测试

  • 单元:230 用例 / 641 断言,PHP 8.0 – 8.4 全绿(CI 五行矩阵,外加逐文件 php -l)
  • 内核行覆盖率 86.87%;六个非 webman 适配器由各自的端到端套件证明(见 docs/REPORT.md)
  • 端到端:7 个框架各一条 CI job,真装框架、真跑「预处理 → 分块 → 完成 → 展示 / 下载」