phpenv下phar打包失败主因是phar.readonly=on，需手动修改php.ini设为off并重启命令行；box打包则依赖box.json配置，须置于根目录、设对main路径及autoloader，windows推荐powershell运行。
phpEnv 默认已启用 Phar 扩展，但 phar.readonly = On 会直接导致打包失败——这是你执行 Phar::buildFromDirectory() 或运行 box compile 时卡住或报错的最常见原因。
phpEnv 中确认并启用 Phar 写入权限
phpEnv 是 Windows 下基于批处理 + 多版本 PHP 切换的环境管理工具，它不自动修改 PHP 的 ini 配置，所有运行时行为取决于当前激活版本的 php.ini。
- 先查当前生效的配置：
php --ini，找到Loaded Configuration File路径 - 用记事本或 VS Code 打开该
php.ini，搜索phar.readonly，确保其值为Off（不是注释掉，也不是On） - 如果找不到这一行，就在
[Phar]段落末尾手动添加：phar.readonly = Off - 改完保存，**必须重启命令行窗口**（phpEnv 不会热加载 ini）
- 验证是否生效：
php -r "echo Phar::canWrite() ? 'ok' : 'fail';"应输出ok
phpEnv 下用原生 Phar 类打包失败的典型表现
即使 php -m | grep phar 显示扩展已加载，仍可能在调用 Phar::buildFromDirectory() 时抛出 PharException: unable to open file 或静默跳过文件——根本不是代码问题，而是配置或路径陷阱。
-
phar.readonly = On：报Cannot write to phar archive，Phar::canWrite()返回false - 入口文件路径写错：比如
setStub($phar->createDefaultStub('bin/app.php'))中的bin/app.php在打包目录里实际不存在，会导致生成的 PHAR 无法执行 - Windows 路径分隔符混用：用
__DIR__ . '/src'没问题，但若硬写"C:\myapp\src"且没转义反斜杠，buildFromDirectory()会静默失败 - 中文路径或空格：phpEnv 启动的 CLI 进程对含空格路径支持差，建议项目路径全英文、无空格、无中文
phpEnv 中使用 Box 打包时 box.json 配置要点
Box 依赖静态分析，不走 PHP 的 Phar 写入流程，所以它**不关心 phar.readonly 设置**，但对配置文件位置和内容极其敏感。
- 必须在项目根目录放
box.json（不是box.json.dist或box.yml），Box 不向上查找 -
main字段必须是相对于项目根的路径，且该文件要有可执行 shebang：#!/usr/bin/env php（否则php app.phar会报failed to open stream: phar error） - 若用 Composer autoload，
box.json必须显式声明："autoloader": "vendor/autoload.php"，不能只靠 require_once - Windows 下推荐用 PowerShell 运行
box compile，CMD 对长路径和 UTF-8 支持不稳定
打包后在目标机器上运行不了？检查这三件事
PHAR 文件本身是跨平台的，但能否跑起来，完全取决于目标环境的 PHP 配置，和你本地 phpEnv 无关。
- 目标机器是否启用了
phar扩展：php -m | grep phar，没输出就说明未启用（Alpine 镜像、XAMPP 绿色版常缺） -
phar.require_hash = On时，你打包没签名或签名算法不匹配（如用Phar::SHA256但目标环境只认MD5），会报Invalid signature - 入口脚本里用
require 'config.php'这种相对路径，打包后会失效；应改用require Phar::running(true) . '/config.php'或__DIR__
真正容易被忽略的是：phpEnv 只管你本地打包是否成功，但 PHAR 的执行环境完全独立。一个在 phpEnv 里能跑的 app.phar，扔到 Docker 容器或客户服务器上，大概率因 phar 扩展未启用或 phar.require_hash 配置不一致而直接失败——别假设“打包成功=能运行”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
