phpenv 不提供 Composer 安装功能，仅管理 PHP 版本；执行 phpenv install composer 会失败，因该子命令不存在，正确做法是单独安装 Composer 并确保其调用 phpenv 当前激活的 PHP CLI 版本。
phpenv 本身不提供 Composer 安装功能，它只管理 PHP 版本；Composer 需单独安装，并确保与当前 phpenv 激活的 PHP CLI 版本对齐。
为什么 phpenv install composer 会失败
phpenv 是一个 PHP 版本切换工具（类似 pyenv），它不包含包管理器逻辑。执行 phpenv install composer 会报错，因为该子命令根本不存在。常见误操作是把 phpenv 和 php-build、composer 混为一谈。
- phpenv 只负责
phpenv global、phpenv local、phpenv shell这类版本控制命令 - 它依赖系统已有的
phpCLI 可执行文件——而 Composer 是一个 PHP 脚本，必须由某个 PHP 版本来运行 - 如果你用
phpenv global 8.2.18切换版本，之后运行的composer命令，底层实际调用的是该版本的php
在 phpenv 环境下正确安装 Composer
关键不是“给 phpenv 装 Composer”，而是“让 Composer 使用 phpenv 当前激活的 PHP”。推荐用官方脚本安装到全局路径，再验证是否绑定正确：
- 先确认当前 PHP CLI 版本：
phpenv version和php -v输出应一致 - 下载并校验安装器：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"，然后用php -r校验 SHA384（官网最新值请以 getcomposer.org/download/ 为准） - 安装到系统级 bin 目录：
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer - 验证绑定：
phpenv local 7.4.33 && composer --version应显示 Composer 版本，且composer show php中的 PHP 版本号应为 7.4.33
常见报错：Could not open input file: composer.phar
这个错误说明 Composer 找不到它依赖的 PHP 解释器，或当前 php 命令指向了被 phpenv 卸载/未编译的版本。典型场景：
立即学习“PHP免费学习笔记（深入）”；
- 你执行过
phpenv uninstall 8.1.27，但没重新phpenv global切换到可用版本，此时php命令失效 - 宝塔面板等环境里，
phpCLI 实际是软链接到/www/server/php/81/bin/php，但 phpenv 未接管该路径，导致composer运行时仍调用旧 PHP - Linux 下忘记加
sudo导致/usr/local/bin/composer写入失败，后续调用的是残留的旧版或别名
修复方式：运行 which php，确认输出路径是否属于 phpenv 管理（如 ~/.phpenv/versions/8.2.18/bin/php）；如果不是，用 phpenv rehash 刷新 shims，或手动删掉非 phpenv 的 composer 文件再重装。
多版本项目中 Composer 的行为差异
同一个 composer 可执行文件，在不同 phpenv 环境下表现不同——这不是 Composer 自身变化，而是它背后 PHP 的扩展、ini 设置、加载路径变了：
-
composer require ext-gd在 PHP 7.4 下可能成功，在 PHP 8.3 下因 GD 扩展名变更（如从gd改为gd2）而失败 - 某些包（如
laravel/framework）的composer.json里写了"php": "^8.0"，当你用phpenv local 7.4.33后执行composer install，会直接报错 “Your requirements could not be resolved” -
composer dump-autoload -o生成的优化类映射，仅对该次运行的 PHP 版本有效；切换 phpenv 版本后需重新执行
真正容易被忽略的点：Composer 的 platform 配置项（在 composer.json 的 config 下）可以伪造 PHP 版本或扩展存在性，但它只影响依赖解析，不改变实际运行时行为——比如设 "php": "8.2.0" 后能绕过版本检查，但运行时若真缺 ext-mbstring，照样 fatal error。
