准备好含composer.json、vendor/autoload.php、源码和入口文件的项目结构;2. 执行composer install --optimize-autoloader优化自动加载;3. 使用build.php脚本创建Phar,通过buildFromDirectory添加项目及vendor文件;4. 设置stub引导phar://app.phar/vendor/autoload.php和入口脚本;5. 生成app.phar后赋予可执行权限并运行。关键在于完整嵌入依赖与自动加载机制。

要在 Phar 归档中打包并运行一个完整的 Composer 项目,关键在于将依赖、源码和自动加载机制完整嵌入,并确保入口文件能正确执行。以下是具体操作步骤。
准备项目结构
确保你的项目使用 Composer 管理依赖,并有一个明确的入口文件(如 index.php 或 bin/cli)。基本结构如下:
先运行 composer install --optimize-autoloader,确保 autoloader 高效且无开发依赖。
创建可执行的 Phar 文件
使用 PHP 脚本生成 Phar,注意开启 phar.readonly=0 配置(可在 php.ini 中设置或使用命令行):
示例构建脚本 build.php:
startBuffering();
// 添加所有项目文件(排除不必要的)
$phar->buildFromDirectory('.', '/\.(php|json|yaml|txt)$/');
// 添加 vendor 目录(包含依赖)
$phar->buildFromDirectory('vendor', '/\.php$/');
// 设置 stub:引导自动加载并执行主脚本
$stub = <<
STUB;
$phar->setStub($stub);
$phar->stopBuffering();
echo "Phar 已生成: app.phar\n";
运行 php build.php 生成 app.phar。
运行打包后的 Phar
赋予可执行权限:
chmod +x app.phar
直接运行:
php app.phar
或通过 shebang 支持直接执行(Linux/macOS):
./app.phar
确保入口文件(如 bin/app.php)逻辑正确,能访问所有依赖类。
注意事项与优化
- 文件排除:在 buildFromDirectory 时过滤掉 .git、tests、.md 等非必要文件以减小体积。
- 压缩:使用 $phar->compressFiles(Phar::GZ) 压缩内容(需 zlib 支持)。
- 签名:生产环境建议用 OpenSSL 签名防止篡改。
- 相对路径问题:避免在代码中使用 __DIR__ 拼接文件路径,应通过 Phar::running() 判断是否在 Phar 内运行。
基本上就这些。只要自动加载链完整,Composer 项目就能顺利打包进 Phar 并独立运行。










