Composer在宝塔面板需手动配置PHP命令行环境、解除putenv/proc_open/pcntl_signal禁用、创建php软链接、全局安装composer、设阿里云镜像源，并在项目目录用--no-dev参数安全执行install。
composer 在宝塔面板中不是开箱即用的，必须手动配置 PHP 命令行环境、解除关键函数限制、安装二进制文件并设置国内镜像——否则执行 composer install 时大概率卡住、报错或提示“command not found”。
确认并修复 PHP 命令行可用性
宝塔默认只把 PHP 装在/www/server/php/版本号/bin/php，但终端里直接敲 php -v 会失败，因为没加到系统 PATH。更隐蔽的问题是：即使能运行 php，Composer 启动时仍可能因禁用函数崩溃。
- 进入宝塔「PHP 管理」→ 选中你项目用的 PHP 版本（如 80）→ 「禁用函数」列表中 必须删除：
putenv、proc_open、pcntl_signal - 创建软链接让终端认得
php命令：ln -sf /www/server/php/80/bin/php /usr/local/bin/php
（把80换成你实际版本，如74或81） - 验证：执行
php -v和php -m | grep openssl（确保openssl、tokenizer已启用）
全局安装 composer 并验证权限
别用宝塔软件商店一键安装——它常漏配 PATH 或忽略函数限制，后续调试更麻烦。推荐纯命令行方式，全程可控：- 进入宝塔「终端」或 SSH 登录服务器，执行：
cd /tmp curl -sS https://getcomposer.org/installer | php mv composer.phar /usr/local/bin/composer chmod +x /usr/local/bin/composer
- 验证是否生效：
composer --version应输出类似Composer version 2.7.7 - 若提示
Permission denied，说明/usr/local/bin不可写，改用：mv composer.phar /root/composer.phar alias composer='php /root/composer.phar'
（再把 alias 加到/root/.bashrc中持久化）
必须配置国内镜像源，否则寸步难行
官方源在国内基本不可用，composer require laravel/framework 可能卡在 “Downloading…” 十几分钟后超时。
- 全局切换为阿里云镜像（推荐，同步及时）：
composer config -g repo.packagist composer <a href="https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9">https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9</a> - 验证是否生效：
composer config -g repo.packagist应返回<a href="https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9">https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9</a> - 如果项目已有
composer.json且含私有仓库，可在项目目录下单独配置：composer config repos.myprivaterepo composer <a href="https://www.php.cn/link/251b30088e712b7a946fa660b312cd20">https://www.php.cn/link/251b30088e712b7a946fa660b312cd20</a>
在网站目录中安全执行 install / update
直接在/www/wwwroot/your-site.com 下跑 composer install 很常见，但容易因权限或内存爆掉：
- 进入项目根目录后，优先用生产模式安装：
composer install --no-dev --optimize-autoloader
（跳过开发依赖，生成高效类映射，避免上线后性能抖动） - 若提示
Allowed memory size exhausted：
在命令前临时加大内存：php -d memory_limit=2G /usr/local/bin/composer install --no-dev
- 安装完务必检查权限：
chown -R www:www /www/wwwroot/your-site.com/vendor
（Nginx/Apache 以www用户运行，否则 500 错误）
宝塔里最常被忽略的一点：就算 composer --version 成功，只要 putenv 没从 PHP 禁用函数里删掉，composer install 过程中加载某些包（比如 Laravel 的 symfony/flex）就会静默失败，只显示空行或卡住——不报错，但 vendor 里啥也没有。
