直接用 php archive.php 报“Class not found”是因为 Composer 生成的 autoload.php 硬编码磁盘绝对路径，打包进 Phar 后路径失效；需改用 --classmap-authoritative + --optimize-autoloader 生成 Phar-aware 加载器，并显式包含 autoload_classmap.php。
为什么直接用 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）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “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];}}); - 绝对不要用
__DIR__或dirname(__FILE__)拼路径——Phar 内部没有真实目录结构
Phar 的坑不在打包，而在运行时对路径和加载机制的误判；哪怕 phar.readonly=Off，只要 autoloader 没适配，就必然失败。
