Composer配合Phar工具将项目打包成单文件运行（打包指南）-composer-PHP中文网

直接用 php archive.php 报“class not found”是因为 composer 生成的 autoload.php 硬编码磁盘绝对路径，打包进 phar 后路径失效；需改用 --classmap-authoritative + --optimize-autoloader 生成 phar-aware 加载器，并显式包含 autoload_classmap.php。

composer配合phar工具将项目打包成单文件运行（打包指南）

为什么直接用 `php archive.php` 会报错 “Class not found”

Phar 打包后，autoload.php 路径失效是默认行为。Composer 生成的自动加载器硬编码了原始文件路径（比如 /home/user/project/vendor/autoload.php），打包进 Phar 后这些路径在运行时根本不存在，导致类找不到。

解决核心：让 Composer 生成「相对路径」或「Phar-aware」的 autoloader。

打包前执行：composer install --no-dev --optimize-autoloader，确保只含生产依赖且使用 classmap 加载（更快、更稳定）
关键一步：在 composer.json 中添加配置：
```
"config": {
  "autoloader-suffix": "PharAutoloader"
}
```
，避免与原项目 autoload 冲突（非必需但推荐）
生成 autoloader 时启用 --classmap-authoritative：它强制只走 classmap，跳过文件扫描，彻底规避路径问题

如何用 `Phar::buildFromDirectory()` 正确包含 vendor 和自定义代码

别直接把整个项目目录丢进去——vendor 里大量测试、文档、.gitignore 文件会混入，增大体积还可能触发 Phar 安全限制（如 phar.readonly=On）。

推荐做法是显式构建，控制内容边界：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

先排除无用目录：$phar->buildFromDirectory('src', '/\.php$/');（只加 src 下 PHP 文件）
再手动 add vendor 的 classmap 文件：$phar->addFile('vendor/composer/autoload_classmap.php', 'vendor/composer/autoload_classmap.php');
必须设置 stub：$phar->setStub($phar->createDefaultStub('src/entry.php'));，其中 entry.php 是你的启动入口，且需提前 require autoload
最后一定要写：$phar->stopBuffering();，否则压缩和签名无效

`Phar::setSignatureAlgorithm()` 选什么？SHA-256 还是 OPENSSL？

签名不是可选项——没签名的 Phar 在 phar.require_hash=On（默认开启）时直接拒绝执行，报错：Phar error: unable to load phar "/xxx.phar", phar signature missing or invalid。

SHA-256 简单够用：$phar->setSignatureAlgorithm(Phar::SHA256);，无需额外密钥，适合开发/内网分发
OPENSSL 更安全但麻烦：需先生成私钥（openssl genpkey -algorithm RSA -out private.pem），再用 $phar->setSignatureAlgorithm(Phar::OPENSSL, 'private.pem');
注意：用 OPENSSL 签名后，运行时必须加载公钥：Phar::loadPhar('app.phar', 'app'); Phar::setStub('<?php __HALT_COMPILER(); ? >');，且 PHP 需开启 phar.stream_wrapper

运行时报 `Warning: include(): Failed opening 'phar://.../vendor/autoload.php'`

这不是路径写错了，而是你在入口文件里写了 require 'vendor/autoload.php'; —— Phar 内部路径是虚拟的，不能用相对路径加载。

正确姿势只有两种：

入口文件（如 src/entry.php）里直接 require Phar 自带的 classmap：
```
require 'phar://' . __FILE__ . '/vendor/composer/autoload_classmap.php';
```

或者更稳妥：在入口里手动注册 classmap：

$classmap = require 'phar://' . __FILE__ . '/vendor/composer/autoload_classmap.php';spl_autoload_register(function ($class) use ($classmap) {if (isset($classmap[$class])) {require $classmap[$class];}});