box是php主流phar构建工具，解决composer自动加载、签名、压缩等全套问题；手动用phar::buildfromdirectory易漏vendor/autoload.php路径绑定，导致class not found。
Box 是什么，为什么不能直接用 php -d phar.readonly=0 -r 手动打包？
Box 是目前最主流的 PHP PHAR 构建工具，它不是简单地把文件塞进 .phar，而是解决 Composer 依赖自动加载、类重命名、签名、压缩、入口脚本注入等一整套问题。手动用 Phar::buildFromDirectory() 很容易漏掉 vendor/autoload.php 的路径绑定，导致运行时报 Class not found —— 因为 PHAR 内部的 autoloader 还在找 /vendor/ 这种绝对路径。
用 Box 打包前必须改掉的三个 Composer 配置
默认的 composer.json 不适合打包成 PHAR，否则会引入冗余文件或破坏自动加载：
- 删掉
"autoload-dev"和"require-dev"—— PHAR 只需要运行时依赖 - 把
"autoload": {"psr-4": {...}}改成"autoload": {"classmap": ["src/"]}或保留 PSR-4 但确保所有类都在声明路径下 —— Box 对 classmap 更稳定，避免运行时动态路径解析失败 - 执行
composer install --no-dev --optimize-autoloader，生成扁平化的vendor/autoload.php，这是 Box 能正确提取依赖的前提
box.json 关键字段怎么写才不翻车？
最小可用配置里，这四个字段缺一不可：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"main": "bin/myapp"：指定 PHAR 入口脚本（必须是可执行的 PHP 文件，开头有#!/usr/bin/env php） -
"output": "myapp.phar"：输出文件名，别写错后缀 -
"chmod": "0755"：否则生成的 PHAR 在 Linux/macOS 下可能无法直接执行 -
"compression": "GZ"：不压缩会导致 PHAR 体积大、启动慢；设为"NONE"时 Box 默认跳过签名，但你得自己关掉"signing"
如果项目用了 __DIR__ 或 dirname(__FILE__) 获取路径，还要加 "files": ["src/MyApp/PathHelper.php"] 并在代码里用 Phar::running(true) 替换硬编码路径。
打包后运行报 Could not open input file 或 Class 'Monolog\Logger' not found 怎么查？
先确认 PHAR 是否真正包含依赖：
- 运行
php -d phar.readonly=0 -r "print_r(new Phar('myapp.phar')->getStub());"，看 stub 是否含__HALT_COMPILER();和正确的签名头 - 解包验证：
mkdir tmp && cd tmp && php -d phar.readonly=0 -r "file_put_contents('list.txt', (new Phar('../myapp.phar'))->compressFiles(Phar::GZ));" && unzip ../myapp.phar，检查vendor/是否存在且结构完整 - 关键陷阱：Box 默认不会把
vendor/composer/autoload_*.php外的文件纳入自动加载 —— 如果你用了"files"autoload 类型，得手动加进"files"字段到box.json，否则这些文件就丢了
PHAR 的加载机制和普通目录完全不同，任何依赖相对路径、反射获取源码位置、或调用 getcwd() 的逻辑，在打包后都可能失效，这类问题只能靠运行时日志 + 解包比对定位。
