php 8.6构建phar时会采用splfileinfo子类覆盖的getmtime()结果。因此可以让构建迭代器为每个源文件返回固定时间,而不修改源文件自身的时间戳。该方法适合减少归档元数据差异;是否得到逐字节一致的包,还取决于文件顺序、内容、stub、压缩和其他元数据,不能只固定时间就宣布实现了可重复构建。

getMTime与getPathname均影响构建,但承担不同用途。
准备独立的源目录和新输出文件
在build.php旁建立package-src目录,放入需要归档的普通文件。输出package.phar放在源目录之外;示例拒绝覆盖已有输出,也拒绝源目录中的符号链接。构建开关只针对当前CLI命令,不应为网站长期关闭phar.readonly。
<?php final class BuildFile extends SplFileInfo {
public function getMTime(): int|false { return 1700000000; }
}
final class BuildDirectory extends RecursiveDirectoryIterator {
public function current(): SplFileInfo {
return new BuildFile(parent::current()->getPathname());
}
}
$source = realpath(__DIR__ . '/package-src');
$output = __DIR__ . '/package.phar';
if ($source === false || !is_dir($source) || file_exists($output)) {
throw new RuntimeException('源目录不可用或输出已存在');
}
$scan = new RecursiveIteratorIterator(new RecursiveDirectoryIterator(
$source, FilesystemIterator::SKIP_DOTS));
foreach ($scan as $file) {
if ($file->isLink() || !$file->isFile()) {
throw new RuntimeException('源目录只能包含普通文件');
}
}
$files = new RecursiveIteratorIterator(new BuildDirectory(
$source, FilesystemIterator::SKIP_DOTS));
$archive = new Phar($output);
$archive->startBuffering();
$archive->buildFromIterator($files, $source);
$archive->setStub('<?php __HALT_COMPILER(); ?>');
$archive->setSignatureAlgorithm(Phar::SHA256);
$archive->stopBuffering();
foreach (new RecursiveIteratorIterator($archive) as $entry) {
if ($entry->getMTime() !== 1700000000) {
throw new RuntimeException('归档时间戳不符合构建配置');
}
echo $entry->getFilename(), ': ', $entry->getMTime(), PHP_EOL;
}
执行构建并核对条目
php -d phar.readonly=0 build.php
命令只为这次CLI构建允许写Phar,仍保留默认的归档签名要求。检查输出条目数量、相对路径、时间和内容,确保没有把输出包或多余文件再次打入包中。SHA256归档签名用于完整性检查,不等于可信发布者身份认证;包仍应通过可信渠道分发。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

测试展示迭代器返回自定义SplFileInfo对象的实现方式。
不把getPathname当作简单改名接口
getPathname的覆盖会影响实际读取的输入路径,不能仅替换字符串就认为安全地修改了归档文件名。需要自定义包内名称时,按buildFromIterator的键和路径规则单独设计映射并校验来源。本例只覆盖时间,不改输入路径。构建中途异常可能留下未完成的输出,应将构建任务标为失败,不把残留包当作正式发布物。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










