宝塔无需安装Composer，它只是PHP脚本文件；需手动下载composer.phar、移至/usr/local/bin/composer并chmod+x赋权；必须解除PHP禁用函数proc_open等；终端PHP版本与网站设置无关，需确认真实路径；务必配置国内镜像源。
宝塔里根本不用“安装”Composer，它只是个PHP脚本文件
Composer 不是宝塔软件商店里的应用，也不是需要“启用”的服务。它本质就是一个叫 composer.phar 的 PHP 归档文件，只要服务器有 PHP（≥7.2），就能直接运行——宝塔只是给你开了个终端窗口而已。
常见错误现象：
• 在宝塔「软件管理」里反复找“Composer”图标，找不到；
• 终端执行 composer --version 报 command not found；
• 误以为要等宝塔“编译完成”或“启动成功”才可用。
- 别被“一键安装脚本”带偏，最稳的是三步命令：下载 → 移动 → 赋权
- 必须用
chmod +x，否则某些系统会提示Permission denied - 推荐放在
/usr/local/bin/composer，避免每次写完整路径
PHP禁用函数不删，composer install必卡死
宝塔默认禁用了 proc_open、exec、putenv 等函数，而 Composer 安装依赖时大量调用它们——没解禁，就等于给发动机拔了油管。
使用场景：你在终端跑 php composer.phar install 卡在 “Loading composer repositories”，或报错 proc_open() has been disabled。
- 进宝塔 → 【网站】→ 点击对应站点 → 【PHP 设置】→ 【禁用函数】
- 逐个删除（不是取消勾选）：
proc_open、exec、shell_exec、putenv、pcntl_signal - 改完点【重载配置】，或重启该 PHP 版本的服务
终端里跑的PHP版本 ≠ 网站后台设置的PHP版本
你在宝塔网站设置里选了 PHP 8.2，不代表终端里 php -v 就显示 8.2。Composer 默认走的是系统级 /usr/bin/php，和你网站配置完全无关。
常见错误现象：
• composer install 成功但运行时报 Class not found；
• 某扩展（如 openssl）在网站后台已启用，终端里却提示未加载。
- 查真实路径：
which php和/www/server/php/82/bin/php -v对比 - 临时指定版本（最安全）：
/www/server/php/82/bin/php /usr/bin/composer install - 别乱改全局
php软链，容易崩宝塔面板自身
不换国内源，composer require就是等超时
官方源在境内基本不可用，composer require laravel/framework 卡在 “Downloading…” 十几分钟后失败，是常态，不是你的网络问题。
性能影响：不设镜像，首次安装 Laravel 可能耗时 15 分钟以上；设阿里云源后通常 20–40 秒完成。
- 全局生效（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist应返回该 URL - 如果项目特殊需临时切源，去掉
-g参数，在项目目录下运行即可
