卡在“loading composer repositories”大概率因禁用函数未放开或镜像未对www用户生效；需检查php禁用函数（putenv、proc_open、pcntl_signal）、用sudo -u www验证并配置阿里云镜像、确认cli php路径与网站设置无关、修正项目目录权限（chown -r www:www .），并确保openssl和tokenizer扩展已启用。
composer install卡在“Loading composer repositories”怎么办
大概率是禁用函数没放开，或镜像配置没生效到实际执行用户。宝塔里跑 composer install 时，不是看你是谁登录的 SSH，而是看命令由哪个用户触发——网站「一键部署」、计划任务、PHP 管理器里点的按钮，基本都以 www 用户身份运行。
- 进宝塔 → 【PHP 管理】→ 选对应 PHP 版本 → 【禁用函数】里删掉
putenv、proc_open、pcntl_signal，删完必须点【重载配置】 - 验证镜像是否对
www生效：终端执行sudo -u www composer config -g repo.packagist，应输出{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果输出为空或报错，说明配置写到了
/root/.composer/config.json，而www根本读不到——得用sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/重配
为什么用 php -v 看是 8.2，但 composer install 还报 PHP 版本不兼容
因为 composer 命令本身是个 PHP 脚本，它默认调用的是系统 PATH 里的 php，和你在宝塔网站设置里选的 PHP 版本完全无关。宝塔把 PHP 8.2 装在 /www/server/php/82/bin/php，但 which php 很可能指向 /usr/bin/php（可能是旧版或软链失效）。
- 查真实 CLI PHP 版本：
/www/server/php/82/bin/php -v（把 82 换成你项目实际需要的版本） - 安全执行方式：直接用完整路径调用，例如
/www/server/php/82/bin/php /usr/local/bin/composer install - 别信
composer.json里的"platform": {"php": "8.2.10"}——它只影响依赖解析逻辑，不改变实际执行的 PHP 二进制文件
执行 composer install 提示 Permission denied 或 vendor 写不进去
本质是当前执行用户（如 www）没权限写入项目目录。常见于 root 手动下载代码后没改属主，或宝塔「一键部署」自动拉取但没同步权限。
- 进到网站根目录（如
/www/wwwroot/example.com），执行：chown -R www:www . - 再补一句：
chmod -R u+rwX,go-w .，确保 owner 可读写执行，group 可读执行，other 无写权限 - 如果用了
--no-dev参数仍失败，先确认composer.lock存在且格式正确——缺失或损坏的 lock 文件会导致 Composer 重新解析依赖，加剧权限/网络问题
宝塔自带「Composer」模块点不动或报错
这个功能依赖后台服务调用，但实际执行环境受限更多：它强制走 www 用户 + 当前 PHP 版本 + 宝塔封装的执行上下文，比手动命令更难排查。
- 启用前务必确认：对应 PHP 版本已开启
openssl和tokenizer扩展（在【PHP 管理】→【配置文件】里搜 extension=） - 模块内填的「PHP 版本」下拉菜单，选的是宝塔识别出的「可用版本」，不等于你网站设置里启用的那个——得去【软件商店】确认该版本确实已安装并启动
- 如果点「执行」后页面没反应或日志空白，直接切到终端用
sudo -u www /www/server/php/XX/bin/php /usr/local/bin/composer install --no-dev替代，XX 换成实际版本号
composer install 就会静默失败或卡死。
