Phar扩展在XAMPP中默认启用，但CLI模式需确认C:\xampp\php\php.ini中extension=phar和phar.readonly=Off；buildFromDirectory要求绝对路径、无尾斜杠、无中文/空格/特殊字符/软链接；打包须调用setStub和stopBuffering；类加载需用phar://协议或Phar::interceptFileFuncs()。
Phar 扩展在 XAMPP 中默认已启用，无需额外安装；但打包 PHP 程序时若遇到 Phar::buildFromDirectory 失败或“PharException”报错，问题几乎都出在写入权限、路径合法性或 phar.readonly 配置上。
为什么 php -m | findstr phar 没输出？
不是扩展没装，而是 CLI 模式用的 php.ini 和 Apache 模式不同。XAMPP 的 CLI 默认读取 C:\xampp\php\php.ini（不是 C:\xampp\apache\bin\php.ini）。运行 php --ini 查看实际加载路径，再确认该文件中是否含：
extension=phar phar.readonly=Off
注意：phar.readonly=Off 必须显式设置，否则所有 Phar 写操作（如 buildFromDirectory、addFile）都会抛出 PharException: writing is disabled。
Phar::buildFromDirectory 报错“failed to open dir”或路径不合法
常见于 Windows 下路径分隔符、相对路径或符号链接导致的问题。Phar 构建时对源路径要求严格：
立即学习“PHP免费学习笔记（深入）”；
-
buildFromDirectory的第一个参数必须是**绝对路径**，且结尾不能带斜杠（C:\xampp\htdocs\myapp\❌，应为C:\xampp\htdocs\myapp✅） - 目录内不能含中文文件名、空格或特殊字符（如
测试.php、file name.php），否则构建会静默跳过或报错 - 不能包含软链接或系统级隐藏文件（如
Thumbs.db、desktop.ini），建议先清理无关文件 - 确保 PHP 进程对目标目录有读取权限（尤其当项目在 OneDrive 或受控文件夹时）
打包后执行 php myapp.phar 提示 “could not open input file”
这不是 Phar 本身问题，而是 CLI 没识别到可执行格式。需两步修复：
- 生成时必须调用
setStub并写入可执行 stub，例如：$phar->setStub($phar->createDefaultStub('index.php')); - 必须调用
stopBuffering（或compressFiles）触发写入，否则文件只是空壳：$phar->stopBuffering(); - 最后 chmod 不是 Windows 重点，但需确保
.phar文件没被杀毒软件锁定（部分国产软件会拦截写入）
Phar 打包后无法加载类或找不到 autoload.php
Phar 是独立文件系统，require 路径需适配内部结构。典型错误写法：require 'vendor/autoload.php'; —— 这在 Phar 内部会找根目录下的 vendor/，但实际它可能被压缩在 phar://myapp.phar/vendor/ 中。
正确做法是统一用 phar:// 协议前缀或改用 Phar::interceptFileFuncs()：
// 方案1：显式指定 phar 协议 require 'phar://myapp.phar/vendor/autoload.php'; // 方案2：启用自动重写（需提前开启） Phar::interceptFileFuncs(); require 'vendor/autoload.php'; // 自动转为 phar:// 调用
注意：Phar::interceptFileFuncs() 只影响当前 Phar，且必须在 require 前调用；另外，Composer 自动生成的 autoload 通常不兼容 Phar，建议打包前用 composer install --no-dev --optimize-autoloader 并检查生成逻辑。
最易忽略的一点：XAMPP 升级后，C:\xampp\php\php.ini 可能被覆盖重置，phar.readonly=Off 会消失，导致所有打包脚本突然失效——每次升级 PHP 版本后务必重新检查该配置项。
