phpenv下必须手动下载composer.phar并修复cli环境：先用phpenv which php确认php路径，删php.ini中disable_functions里的proc_open、putenv、pcntl_signal，启用openssl/tokenizer模块；再执行curl -ss https://getcomposer.org/installer | php，mv composer.phar ~/.phpenv/bin/composer并chmod +x；最后composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/配置镜像源。
phpEnv 环境下不能直接用 apt 或宝塔式一键安装 Composer，必须手动下载 composer.phar 并确保 CLI 环境完整；镜像配置写错一个字符（比如少斜杠、多 s、漏 composer 类型）就完全不生效。
确认 phpEnv 的 PHP CLI 是否可用
phpEnv 默认不把 PHP 二进制文件加入 $PATH，且常禁用关键函数，导致 composer 启动即报错（如 proc_open(): disabled 或 putenv(): disabled）。必须先验证并修复 CLI 环境：
- 运行
phpenv which php确认当前激活的 PHP 路径（如~/.phpenv/versions/8.1.22/bin/php） - 检查是否禁用函数：
php -r "echo function_exists('proc_open') ? 'ok' : 'fail';"，输出fail就要改php.ini - 编辑对应版本的
php.ini（路径见上条命令输出），找到disable_functions行，删掉proc_open、putenv、pcntl_signal - 重启终端或运行
phpenv rehash，再执行php -m | grep -E "openssl|tokenizer"，缺任一模块都装不上 Composer
下载 composer.phar 并设为全局命令
别用系统包管理器（apt install composer 会装 1.x 旧版，PHP 8.2+ 下直接报错），也别双击运行安装器——它只是个 PHP 脚本，必须用 php 显式执行：
- 进入临时目录：
cd /tmp - 下载校验安装器：
curl -sS https://getcomposer.org/installer | php（注意是| php，不是直接./installer） - 移至可执行路径：
mv composer.phar ~/.phpenv/bin/composer（推荐放~/.phpenv/bin/，该目录默认在 phpEnv 的$PATH中） - 加执行权限：
chmod +x ~/.phpenv/bin/composer - 验证：
composer --version，若提示Command not found，说明~/.phpenv/bin不在$PATH，需补export PATH="$HOME/.phpenv/bin:$PATH"到 shell 配置文件
配置阿里云镜像源（全局生效但注意用户上下文）
phpEnv 是用户级环境，-g 配置写入的是当前用户的 ~/.composer/config.json，这点和宝塔不同——不存在「www 用户没读到配置」的问题，但要注意：如果你用 sudo -u www composer install，那实际读的是 www 用户的 ~/.composer/config.json，不是你自己的。
- 执行正确命令：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 关键点：必须是
repo.packagist（不是repos.packagist或packagist），composer是 type 值，URL 必须以https://开头且末尾带/ - 验证是否写入：
composer config -g repo.packagist，应输出类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果返回空或报错，说明命令敲错了，重来；别试图手动编辑
config.json，格式错一个逗号就让整个 Composer 崩溃
项目级配置更安全，尤其涉及私有包或 CI
全局镜像看似省事，但一旦项目里用了私有仓库（比如 GitLab 包或内部 Nexus 源），又没显式声明 "packagist": true，Composer 2.2+ 会直接跳过官方源，导致基础包（monolog/monolog 等）拉不到。
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 这条命令会自动往
composer.json的repositories字段追加一条，不会覆盖已有内容 - 如果项目已有
"repositories"，别手动删了重写——否则可能误删私有源；用命令追加才是唯一安全做法 - 换源后首次
composer install若报 hash 不匹配，删掉vendor和composer.lock重来即可
最常被忽略的一点：镜像只加速下载，不解决 Resolving dependencies 卡顿。如果你 composer update 卡几十秒，问题一定出在 composer.json 的版本约束太宽、require-dev 太多，或者本地 PHP 版本与包兼容性差——这时候换镜像毫无意义。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
