Repository navigation
v1.1.0
本版把插件从「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 直发 404PartialResource::createGroupSubDir()的is_dir→mkdirTOCTOU 竞态
升级注意
无破坏性变更:配置键、路由、控制台命令、模板助手函数均与 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,真装框架、真跑「预处理 → 分块 → 完成 → 展示 / 下载」