必须手动配置PHP CLI路径并解除禁用函数才能正常使用Composer：先创建软链接指向宝塔PHP实际版本，再删除putenv、proc_open、pcntl_signal三个禁用函数，最后安装Composer并配置阿里云镜像源。
php命令行根本没配好，composer肯定报 command not found
宝塔装了 PHP，不代表终端里能直接用 php——它默认不往系统 PATH 里加路径，which php 很可能返回空或指向旧版。更隐蔽的问题是：即使 php -v 能跑，Composer 启动时仍会因禁用函数崩溃。
必须手动创建软链接，指向你项目实际用的 PHP 版本（比如 PHP 8.2）：
- 查清路径：
/www/server/php/82/bin/php（把82换成你实际版本号） - 执行：
ln -sf /www/server/php/82/bin/php /usr/local/bin/php - 验证：
php -v有输出、php -m | grep openssl和php -m | grep tokenizer都要看到模块名
禁用函数不清理，composer install 必卡死
宝塔 PHP 管理默认禁用 putenv、proc_open、pcntl_signal，而这三个是 Composer 安装依赖时硬性依赖的函数。现象非常典型：执行 composer install 后卡在 Loading composer repositories with package information... 不动，或者直接报错 putenv() has been disabled for security reasons。
解决方法很直接：
- 进宝塔 → 【网站】→【PHP 管理】→ 选对应版本 → 【禁用函数】
- 不是“取消勾选”，是**逐个删除**这三行文字：
putenv、proc_open、pcntl_signal - 点【重载配置】或重启该 PHP 版本服务
全局安装 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 中。
不换源 = 等超时，阿里云镜像是底线配置
官方源 packagist.org 在境内基本不可用。composer require laravel/framework 卡在 Downloading... 十几分钟后失败，是常态，不是你的网络问题。
必须设国内镜像，推荐阿里云（同步及时、稳定）：
- 全局生效（所有项目都走这个源）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 只对当前项目生效（比如测试私有源）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（在项目根目录下运行，去掉-g） - 验证是否生效：
composer config -g repo.packagist应返回上面那个地址
真正容易被忽略的是：很多人以为装完 composer 就万事大吉，结果第一次 install 就卡住十分钟——其实问题早在 PHP CLI 环境和禁用函数那一步就埋下了，镜像只是最后一环。顺序错了，后面全白搭。
