php 8.6的phar::addemptydir会拒绝/.phar这一保留目录路径,带.phar前缀的普通名字则不应一概视为保留目录。构建工具应先验证清单,再创建归档;不要等写了一半才把名称错误当作可以忽略的警告。

PHP官方文档中的Phar构建相关说明。 图源:PHP Documentation Group(CC BY3.0)。
对目录清单建立自己的安全规则
<?php
if (PHP_SAPI !== 'cli' || !extension_loaded('phar')) { throw new RuntimeException('需要CLI和Phar'); }
$directories = ['assets', 'templates', '.phar-cache'];
foreach ($directories as $path) {
if (preg_match('~^[A-Za-z0-9_.-]+(?:/[A-Za-z0-9_.-]+)*$~D', $path) !== 1
|| array_intersect(explode('/', $path), ['.', '..', '.phar']) !== []) {
throw new InvalidArgumentException('不允许的归档目录');
}
}
$output = __DIR__ . '/bundle.phar';
if (file_exists($output)) { throw new RuntimeException('输出已存在'); }
$archive = new Phar($output);
$archive->startBuffering();
foreach ($directories as $path) { $archive->addEmptyDir($path); }
$archive->setStub('<?php __HALT_COMPILER(); ?>');
$archive->setSignatureAlgorithm(Phar::SHA256);
$archive->stopBuffering();
echo 'archive built', PHP_EOL;只在受控构建进程开放写入
运行构建脚本时可对该CLI命令显式使用-d phar.readonly=0,不要为了构建把生产Web实例全局改成可写Phar。示例仅生成固定空目录结构,若加入真实文件,还需独立处理路径来源、重复条目和读取失败。
区分保留名与前缀
本例主动拒绝任意路径段恰为.phar,这是自己的更严格清单策略;PHP文档中的保留目录规则与/.phar变化不能被夸大成禁止所有含phar的名字。.phar-cache在这里是普通目录,不应因前缀相同被误删。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

PHP 8.6升级说明中的相关兼容变化。 图源:PHP Documentation Group(CC BY3.0)。
构建失败可能留下不完整输出,应把失败产物标记为不可发布,并按明确路径处理,不覆盖上一份有效包。Phar的SHA-256签名提供完整性校验,不等于有可信作者身份或安全审计结论。


















