phpEnv不提供Composer，需在激活的PHP版本下手动安装；必须匹配PHP路径、启用openssl/curl/zip扩展，并通过php -r验证功能；安装后用composer diagnose检查兼容性。
phpEnv 本身不提供 Composer，它只是 PHP 版本管理工具（类似 pyenv 或 rbenv），负责切换不同 PHP CLI 版本。你必须在当前激活的 PHP 版本下单独安装 Composer，且安装路径、权限、扩展启用状态都得匹配该 PHP 实例。
phpEnv 激活的 PHP 是否能跑 Composer？
- Composer 依赖
php命令行可执行、且启用openssl、curl、zip扩展 -
phpEnv切换后，php -v和php -m输出必须反映真实加载的配置 - 常见错误：
php -v显示版本，但php -m | grep openssl无输出 → 表示当前phpEnv激活的 PHP 编译时未启用或php.ini未加载对应扩展
检查方式：
phpEnv local 8.2.10 # 先确认已激活目标版本php -v # 看是否真生效php -r "print_r(openssl_get_cipher_methods());" # 直接测 openssl 是否可用，比 php -m 更可靠php -r "echo file_get_contents('https://getcomposer.org/installer') ?: 'fail';" # 测 curl + https 是否通
在 phpEnv 环境下全局安装 Composer 的正确流程
phpEnv 不干预系统 PATH，只修改当前 shell 的 php 路径。所以安装 Composer 必须用当前激活的 php 执行，且最终二进制要放对位置：
立即学习“PHP免费学习笔记（深入）”；
- 不要用
sudo apt install composer—— 它绑定系统默认 PHP，和phpEnv无关 - 不要直接下载
composer.phar后扔进/usr/local/bin就完事 —— 若该php不是你phpEnv激活的版本，运行时会报错（比如找不到ext-zip）
推荐做法：
- 进入一个干净目录（如 ~/tmp）
- 执行：php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
- 校验哈希（官方 SHA384，别跳过）：php -r "if (hash_file('sha384', 'composer-setup.php') === 'dac665fdc30fdd8ec78b38b9800061b4150413ff2e3b6f88543c636f7cd84f6db9189d43a81e5503cda447da73c7e5b6') { echo 'OK'; } else { echo 'FAIL'; }"
- 安装：php composer-setup.php --install-dir=$HOME/bin --filename=composer
- 确保 $HOME/bin 在 PATH 中（加到 ~/.bashrc 或 ~/.zshrc）：export PATH="$HOME/bin:$PATH"
- 重载 shell：source ~/.zshrc（或对应配置文件）
- 验证：composer --version 输出应与当前 phpEnv 激活的 PHP 版本兼容
为什么 composer install 报 “Your requirements could not be resolved”？
这和 phpEnv 强相关：composer.json 中的 "php": "^8.2" 或 "ext-gd": "*" 等约束，是按当前 php -v 和 php -m 结果校验的。若你用 phpEnv 切到 8.1，但 composer.json 写了 ^8.2，就会失败。
常见诱因：
- phpEnv 激活了 8.1，但项目要求 PHP 8.2+
- 当前 PHP 编译时没带 mbstring，但 composer.json 里写了 "ext-mbstring": "*"
- php.ini 中 disable_functions 禁用了 proc_open（Composer 更新依赖时必需）
- 本地 composer.lock 是用高版本 PHP 生成的，低版本解析失败（尤其 PHP 8.0+ 的类型声明影响 autoloader）
解决思路：先跑 composer diagnose，它会明确告诉你哪项 PHP 配置不满足当前项目需求。
真正容易被忽略的是：phpEnv 切换 PHP 后，不会自动重载 php.ini 或重启任何服务。你改了某个 PHP 版本的 php.ini，必须确保该版本被 phpEnv 正确加载（可通过 php --ini 查看实际加载路径），否则扩展启不起来，Composer 就卡在第一步。
