使用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：

Github Codebase Inspection

使用 pygount 检查代码库：统计代码行数（LOC）、编程语言及占比。

下载

composer install --optimize-autoloader --classmap-authoritative

这会生成更高效的自动加载类映射，提升 PHAR 运行速度。Box 默认会打包整个 vendor 目录中被 use 到的代码（基于扫描），确保运行时无需额外依赖。

构建与测试 PHAR

运行打包命令：

box compile

Box 会根据 box.json 配置生成 myapp.phar。你可以立即测试：

php myapp.phar

如果设置了 stub，还可以直接赋予执行权限并运行：

chmod +x myapp.phar ./myapp.phar

验证与签名（可选）

为确保 PHAR 文件未被篡改，可以生成签名：

box build --sign

Box 会生成公钥和私钥，并在 PHAR 中嵌入签名。运行时 PHP 可验证签名完整性。

基本上就这些。通过 Box 与 Composer 配合，你可以轻松将一个复杂的 PHP CLI 项目打包成单一可执行文件，极大简化分发流程。关键是配置好 box.json，并优化自动加载机制。