Composer需单独安装并确保与phpenv激活的PHP版本兼容：先用phpenv version和php -v确认版本≥7.4且openssl等扩展已启用，再下载校验安装脚本，执行php composer-setup.php --install-dir=$HOME/bin --filename=composer，将$HOME/bin加入PATH，最后配置阿里云镜像源。
phpenv 本身不提供 Composer 安装功能，它只管理 PHP 版本切换；Composer 是独立的 PHP 依赖管理工具，需单独安装并确保与当前 phpenv 激活的 PHP 版本兼容。
确认当前 phpenv 激活的 PHP 版本和 CLI 路径
Composer 必须用 phpenv 当前选中的 PHP CLI 执行，否则可能报错“PHP version too low”或找不到扩展。先验证：
- 运行
phpenv version查看当前 active 的 PHP 版本（如8.1.25） - 运行
which php确认输出路径是否为~/.phpenv/shims/php—— 这说明 shims 已生效 - 运行
php -v和php -m | grep -E "openssl|curl|zip|json"，确保核心扩展已启用
如果 php -m 缺少 openssl，不要直接改系统 php.ini；应编辑对应版本的配置文件，例如：~/.phpenv/versions/8.1.25/etc/php.ini，取消 extension=openssl 前的分号，再执行 phpenv rehash。
在 phpenv 环境下全局安装 Composer（推荐）
避免用 php composer.phar 每次敲全路径，目标是让 composer 命令始终调用当前 phpenv 版本的 PHP。操作顺序不能错：
立即学习“PHP免费学习笔记（深入）”；
- 进入临时目录，如
cd /tmp - 下载并校验安装脚本：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" - 校验 SHA384（官方最新值请以 getcomposer.org/download 页面为准）：
php -r "if (hash_file('sha384', 'composer-setup.php') === 'dac665fdc30fdd8ec78b38b9800061b4150413ff2e3b6f88543c636f7cd84f6db9189d43a81e5503cda447da73c7e5b6') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;" - 安装到用户 bin 目录（不依赖 sudo）：
php composer-setup.php --install-dir=$HOME/bin --filename=composer - 确保
$HOME/bin在$PATH前段（检查echo $PATH），若不在，将export PATH="$HOME/bin:$PATH"加入~/.bashrc或~/.zshrc，然后source它
此时运行 composer --version 应成功，并且 composer diagnose 不报 “PHP extensions missing” 类错误。
composer 命令失效或调用错 PHP 版本的典型表现
常见症状不是“command not found”，而是报错内容暴露了底层问题：
-
PHP Parse error: syntax error, unexpected token "enum"→ 当前phpenv激活的是 PHP 8.0，但 Composer 2.7+ 需要 PHP 8.1+ -
file_get_contents(): php_network_getaddresses: getaddrinfo failed→php.ini中allow_url_fopen = Off，需设为On并phpenv rehash -
Could not open input file: composer.phar→ 你误用了局部安装的composer.phar，但没加php前缀，且当前目录无该文件 -
Warning: require(phar://composer.phar/vendor/autoload.php): failed to open stream→phar扩展被禁用，检查extension=phar是否启用
所有这些都和 phpenv 的 PHP 版本及对应配置强绑定，而不是 Composer 自身的问题。
换国内镜像源（必须在正确 PHP 版本下执行）
如果 composer create-project laravel/laravel 卡住或超时，大概率是 packagist.org 访问失败。换源必须用当前激活的 PHP 版本运行 composer 命令：
- 全局换阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 仅当前项目换源（进项目目录后）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist应输出https://mirrors.aliyun.com/composer/
注意：composer config -g 写入的是 ~/.composer/config.json，这个文件由当前 PHP 解析，所以换 PHP 版本后无需重配——但如果你用 phpenv global 7.4 切到老版本，而该版本没开 openssl，那即使镜像换了，composer 也根本发不出 HTTPS 请求。
