宝塔面板中composer install卡在“loading composer repositories…”99%因未换国内镜像源且php禁用函数未清除；需执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/并手动删除putenv、proc_open、pcntl_signal禁用函数后重载php配置。
宝塔面板里直接运行 composer install 卡在 “Loading composer repositories…” 或十几分钟超时失败，99% 是因为没换国内镜像源 + PHP CLI 环境没配好。
为什么 composer 命令根本找不到？
宝塔装了 PHP，不代表终端能认得 php 或 composer —— 它默认不往系统 PATH 里加路径，which php 可能返回空或指向旧版。更隐蔽的问题是：即使 php -v 能跑，Composer 启动时仍会因禁用函数崩溃。
- 进宝塔 → 【网站】→【PHP 管理】→ 选你项目用的版本（比如
82）→ 【禁用函数】，**手动删掉**这三行：putenv、proc_open、pcntl_signal（不是取消勾选，是彻底删除） - 执行软链接命令（把
82换成你实际版本）：ln -sf /www/server/php/82/bin/php /usr/local/bin/php - 验证：
php -v有输出，php -m | grep openssl和php -m | grep tokenizer都要看到模块名
怎么装 composer 才不踩坑？
别信宝塔软件商店的一键安装——它常漏配 PATH 或忽略函数限制，后续调试更麻烦。最稳的方式就是三行命令，在宝塔【终端】里执行：
cd /tmp-
curl -sS https://getcomposer.org/installer | php（生成composer.phar） -
mv composer.phar /usr/local/bin/composer && chmod +x /usr/local/bin/composer（chmod +x不能省）
验证：composer --version 应输出类似 Composer version 2.7.7。如果提示 Permission denied，说明 /usr/local/bin 不可写，改用：mv composer.phar /root/composer.phar，再加一行 alias composer='php /root/composer.phar' 到 /root/.bashrc 中。
composer config -g 为啥有时不生效？
全局配置写在 ~/.composer/config.json 里，但「谁在跑命令」决定读哪个文件：你在终端用 root 执行了 composer config -g，但宝塔后台的「一键部署」是以 www 用户身份运行的，它读的是 /www/wwwroot/xxx/.composer/config.json（或 /home/www/.composer/config.json），根本看不到 root 的配置。
- 推荐优先用项目级配置：进网站根目录，执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 验证是否写入：
composer config repo.packagist应返回地址 - 临时测试镜像效果可用：
composer install --repository-url=https://mirrors.huaweicloud.com/repository/php/
镜像 URL 末尾要不要加斜杠？
要。阿里云镜像地址必须是 https://mirrors.aliyun.com/composer/（末尾带 /），少一个斜杠会导致 404 或重定向失败。腾讯云、华为云同理，官方文档和镜像站页面都明确写了结尾斜杠。
- 错误写法：
https://mirrors.aliyun.com/composer（缺斜杠） - 正确写法：
https://mirrors.aliyun.com/composer/ - 验证命令：
composer config -g repo.packagist输出必须完全匹配，包括末尾斜杠
最易被忽略的点：镜像源设对了，但 www 用户权限不足导致缓存写不进 /root/.composer；或者宝塔后台任务用的是 www 用户，而你只给 root 配了镜像 —— 这时候得在项目目录下单独配，而不是依赖全局。
