phpenv 不提供 composer 安装功能，仅管理 php 版本和环境变量；composer 必须单独安装，并显式使用 phpenv 当前激活的 php 解释器执行，否则会因 path 冲突、函数禁用或镜像配置失效导致命令找不到、proc_open 失败或仍访问 packagist.org。

phpEnv 本身不提供 Composer 安装功能，它只管理 PHP 版本和环境变量；Composer 必须单独安装，并确保调用的是 phpEnv 当前激活的 PHP 解释器。

为什么 phpEnv 下运行 composer --version 报错或提示找不到命令

phpEnv 默认不把 Composer 加入系统 PATH，也不自动关联到它管理的 PHP；常见错误包括：

• command not found: composer：说明 composer 二进制未安装或不在 PATH 中
• proc_open(): Disabled 或 putenv(): Disabled：phpEnv 切换的 PHP 实际禁用了关键函数（尤其在宝塔、Docker 或自编译环境中）
• 报错指向 /usr/bin/php 而非 phpEnv 的 PHP：说明 Composer 启动时没走 phpEnv 激活的版本

根本原因不是 phpEnv 有问题，而是 Composer 和 phpEnv 两个工具职责分离——前者管依赖，后者管 PHP 多版本切换，必须手动桥接。

在 phpEnv 环境中正确安装 Composer

不能依赖全局 apt 或宝塔软件商店安装，必须用 phpEnv 当前激活的 PHP 执行安装脚本，否则 Composer 启动时会调用错 PHP。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 先确认当前生效的 PHP：phpenv version，再验证该 PHP 支持必需扩展：php -m | grep -E "openssl|tokenizer"
• 检查是否禁用关键函数：php -r "echo function_exists('proc_open') ? 'ok' : 'fail';"，若输出 fail，需编辑对应 PHP 版本的 php.ini，从 disable_functions 中移除 proc_open、putenv、pcntl_signal
• 下载并安装 Composer（使用当前 phpEnv PHP）：

  php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
  php composer-setup.php
  mv composer.phar /usr/local/bin/composer
  chmod +x /usr/local/bin/composer

• 强制 Composer 使用 phpEnv 的 PHP（避免 PATH 冲突）：

  echo '#!/usr/bin/env bash\nexec $(phpenv which php) /usr/local/bin/composer "$@"' | sudo tee /usr/local/bin/composer
  sudo chmod +x /usr/local/bin/composer

配置阿里云镜像后仍走 packagist.org 的排查点

执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后，仍看到日志里请求 packagist.org，大概率是以下三者之一：

• 项目根目录下 composer.json 包含 "repositories" 字段（哪怕为空对象），会完全屏蔽全局镜像
• 你用 sudo composer config -g，结果写进了 root 用户的 ~/.composer/config.json，但当前 shell 是普通用户，读不到
• 缓存未清，旧元数据还在本地：composer clear-cache 必须执行

验证是否真正生效：运行 composer diagnose，看输出中 Repo packagist.org: 后面是不是你设的镜像地址；如果不是，说明配置没落进当前用户上下文。

phpEnv + Composer 组合使用的易忽略细节

每次用 phpenv shell 8.2 或 phpenv global 8.1 切换 PHP 版本后，Composer 不会自动重绑定——它仍按上次安装时的 PHP 路径执行。更稳妥的做法是：在 ~/.phpenv/shims/composer 中写死调用 $(phpenv which php)，或者干脆 alias：

echo "alias composer='$(phpenv which php) /usr/local/bin/composer'" >> ~/.bashrc
source ~/.bashrc

否则你会在某个 PHP 版本下跑 composer install，实际却用另一个 PHP 版本解析依赖，导致 ext-mbstring 类扩展兼容性报错。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！