使用Box可将Composer项目打包为独立PHAR文件，便于分发；它支持自动加载、压缩、加密和签名验证。1. 安装Box并配置box.json，指定源码目录、入口文件及输出名；2. 优化Composer自动加载：运行composer install --optimize-autoloader --classmap-authoritative；3. 执行box compile生成PHAR；4. 可选签名确保完整性。最终得到单一可执行文件，提升部署效率。
将一个基于 Composer 的 PHP 项目打包成 PHAR 文件，可以让它变成一个独立、可分发的命令行工具。Box 是目前最流行的 PHAR 打包工具之一，能很好地与 Composer 协同工作，帮助你生成安全、高效的可执行文件。
为什么使用 Box 打包 Composer 项目
Composer 管理依赖，但不会把项目打包成单一文件。而 PHAR（PHP Archive）格式允许你将整个应用打包成一个 .phar 文件，便于部署和运行。Box 不仅能打包代码，还能：
- 自动处理 Composer 自动加载逻辑
- 压缩并加密文件内容（可选）
- 防止源码被轻易查看
- 设置入口文件，实现 CLI 工具调用
安装与配置 Box
推荐通过 PHAR 方式安装 Box，避免依赖冲突：
curl -LO https://github.com/box-project/box/releases/latest/download/box.phar php box.phar --version为方便使用，可将其重命名为 box 并移至全局路径：
mv box.phar /usr/local/bin/box然后在项目根目录创建配置文件 box.json，这是 Box 的核心配置：
{ "directories": [ "src" ], "files": [ "bin/myapp" ], "main": "bin/myapp", "output": "myapp.phar", "compression": "GZ", "stub": true, "chmod": "0755", "exclude-composer-files": true }说明：
- directories：要包含的源码目录
- files：额外包含的文件，如 bin 入口脚本
- main：PHAR 启动时运行的文件
- output：输出的 PHAR 文件名
- compression：使用 GZ 压缩减小体积
- stub：自动生成启动桩（stub），支持直接执行 .phar
- chmod：设置生成文件权限
- exclude-composer-files：排除 composer.lock 和 vendor 中不必要的元数据
处理 Composer 依赖
你的项目依赖由 Composer 安装在 vendor 目录中。Box 可以自动包含这些文件，但建议先优化 autoload：
composer install --optimize-autoloader --classmap-authoritative这会生成更高效的自动加载类映射，提升 PHAR 运行速度。Box 默认会打包整个 vendor 目录中被 use 到的代码（基于扫描），确保运行时无需额外依赖。
构建与测试 PHAR
运行打包命令：
box compileBox 会根据 box.json 配置生成 myapp.phar。你可以立即测试：
php myapp.phar如果设置了 stub，还可以直接赋予执行权限并运行：
chmod +x myapp.phar ./myapp.phar验证与签名（可选）
为确保 PHAR 文件未被篡改，可以生成签名：
box build --signBox 会生成公钥和私钥，并在 PHAR 中嵌入签名。运行时 PHP 可验证签名完整性。
基本上就这些。通过 Box 与 Composer 配合，你可以轻松将一个复杂的 PHP CLI 项目打包成单一可执行文件，极大简化分发流程。关键是配置好 box.json，并优化自动加载机制。
