Composer在宝塔面板需四步：解除PHP函数限制（putenv、proc_open、pcntl_signal）、补全CLI环境（软链接PHP二进制）、安装二进制、换国内源；缺一不可，且每步须验证。
composer 在宝塔面板里不是装上就能用的，**必须手动解除 PHP 函数限制、补全命令行环境、安装二进制并换源，四步缺一不可**。宝塔软件商店的一键安装常漏掉 putenv 和 proc_open 的放开，后续执行 composer install 直接报错或卡死，反而更难排查。
PHP 命令行环境不就位，php -v 都失败？
宝塔把 PHP 二进制放在 /www/server/php/80/bin/php（版本号按你实际选），但终端里敲 php 就提示 command not found——这不是 Composer 没装好，是系统根本找不到 PHP。
- 先确认你项目用的 PHP 版本（比如 80、74 或 81），进宝塔【PHP 管理】→ 选中对应版本 → 查看“安装路径”
- 执行软链接命令（把 80 替成你的版本）：
ln -sf /www/server/php/80/bin/php /usr/local/bin/php
- 验证：
php -v应输出版本号；再跑php -m | grep openssl确保openssl和tokenizer已启用（Composer 强依赖这两项）
执行 composer install 卡住或报 “proc_open(): fork failed”？
这是宝塔默认禁用了关键函数，Composer 启动依赖进程管理能力，putenv、proc_open、pcntl_signal 必须从【PHP 管理】→【禁用函数】列表里**逐个删除**（不是取消勾选，是手动删掉文字），删完点【重载配置】或重启 PHP 服务。
- 常见错误现象：
proc_open(): fork failed、putenv(): has been disabled for security reasons、Class Composer\Autoload\ClassLoader not found - 别信“只删一个就行”的说法——三个都得清，少一个就可能在不同阶段崩溃
- 如果用了多 PHP 版本（如站点用 80，CLI 用 74），要分别检查对应版本的禁用函数设置
全局安装 composer 的最小可靠命令集
别下 installer.php 文件再跑，也别信“一键脚本”，三行命令最稳，全程在宝塔【终端】里执行：
cd /tmp curl -sS https://getcomposer.org/installer | php mv composer.phar /usr/local/bin/composer && chmod +x /usr/local/bin/composer
-
chmod +x这步不能跳，否则权限不足，某些系统会提示Permission denied - 验证：
composer --version应返回类似Composer version 2.7.7 - 如果
/usr/local/bin不可写（少见但存在），改用：mv composer.phar /root/composer.phar alias composer='php /root/composer.phar'
然后把 alias 加到/root/.bashrc末尾并执行source /root/.bashrc
不设国内镜像，composer require 就是等超时
官方源在国内基本不可用，composer require laravel/framework 卡在 “Downloading…” 是常态，10 分钟后大概率失败。
- 全局生效（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 验证是否生效：
composer config -g repo.packagist应返回阿里云地址 - 若项目有私有仓库，可在项目目录单独配：
composer config repos.myprivaterepo composer https://your-privaterepo.com - 切记：换源要在
composer install或require之前做，否则第一次拉包失败后缓存可能污染后续行为
composer install 报错、卡住、没反应——问题往往藏在 PHP CLI 环境和函数限制里，而不是 Composer 本身。每一步都要验证，别跳过 php -v、composer --version、composer config -g repo.packagist 这三个命令。 
