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 服务。
