宝塔中执行composer --version报command not found，需同步解决PHP CLI路径缺失、禁用函数未清理、镜像源配置错误三类问题：先建PHP软链接并验证openssl/tokenizer扩展，再删除putenv/proc_open/pcntl_signal禁用函数，最后用正确格式composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/配置镜像源。
宝塔里执行 composer --version 报 command not found 怎么办
根本不是 Composer 没装，是 PHP CLI 命令链路断了。宝塔把 PHP 二进制文件放在 /www/server/php/80/bin/php（版本号按你实际用的填），但终端里敲 php 找不到它。
必须手动建软链接：
- 进宝塔【终端】，运行
ln -sf /www/server/php/80/bin/php /usr/local/bin/php（把80换成你项目用的 PHP 版本，比如82） - 再执行
php -v，有输出才算通 - 顺手验证关键扩展：
php -m | grep -E "openssl|tokenizer"，缺一个都可能让 Composer 启动失败
宝塔 PHP 管理里禁用函数不清理，composer install 必卡死
不是网络慢，是 putenv、proc_open、pcntl_signal 这三个函数被宝塔默认禁用了——而 Composer 安装依赖时全靠它们干活。
典型现象：执行 composer install 卡在 Loading composer repositories with package information... 不动，或直接报错 putenv() has been disabled for security reasons。
立即学习“PHP免费学习笔记（深入）”；
解决方法很直接：
- 进宝塔 → 【网站】→【PHP 管理】→ 选中对应 PHP 版本 → 【禁用函数】
- 逐个删掉
putenv、proc_open、pcntl_signal（不是取消勾选，是彻底删除） - 点【重载配置】或重启 PHP 服务
composer config -g repo.packagist 命令为什么总不生效
这条命令静默失败时不报错，但 composer config -g repo.packagist 返回空或 null，说明根本没写进去。必须同时满足三个硬性条件：
- 键名只能是
repo.packagist（不是repos.packagist，不是packagist.org，也不能漏掉repo.前缀） -
composer是type值，不是可选参数——漏掉就 fallback 到官方源 - URL 必须用 HTTPS 且末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/packages.json导致 404
正确写法：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
CI/CD 或团队协作时，全局镜像配置为什么靠不住
宝塔用 www 用户跑命令，GitHub Actions 用 runner 用户，本地配了 root 的全局配置，别人拉代码照样卡住——因为它们读不到你 ~/.composer/config.json。
更可靠的做法是进项目根目录，运行：
-
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 它会自动在
composer.json顶层写入"repositories"字段，key 固定为"packagist" - 如果已有
"repositories": []，命令能合并；若报错，说明 JSON 格式异常，先手动改成合法对象再试 - 改完建议删掉
vendor/和composer.lock，再跑composer install确保从新源拉取
镜像只加速元数据加载和 ZIP 包下载，不参与依赖解析。如果 composer update 卡在 Resolving dependencies，得查 PHP 版本约束太宽、require-dev 包太多，或者还在用已废弃的 fxp/composer-asset-plugin ——这些换任何镜像都无效。
