宝塔面板中 Composer 速度慢需配置国内镜像源：一、全局配置（/root/.composer）；二、单项目配置（站点根目录）；三、临时指定镜像安装；四、手动编辑 config.json；五、确保使用宝塔管理的 PHP 安装 Composer。
如果您在宝塔面板中使用 Composer 安装或更新 PHP 包时速度缓慢，很可能是默认使用了国外源。以下是为宝塔面板环境配置 Composer 镜像的多种方法：
一、全局配置镜像（适用于所有站点）
该方法通过修改 Composer 的全局配置文件，使服务器上所有用户及所有项目均默认使用国内镜像源，无需逐个项目设置。
1、登录宝塔面板，在左侧菜单点击【终端】，进入服务器命令行界面。
2、执行命令切换至 root 用户的 Composer 配置目录：cd /root/.composer。
立即学习“PHP免费学习笔记（深入）”；
3、若目录不存在，先运行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 创建并写入阿里云镜像。
4、验证是否生效：执行 composer config -g repo.packagist，输出应为 https://mirrors.aliyun.com/composer/。
二、为特定网站项目配置镜像
该方法仅影响指定网站根目录下的 composer.json 所在项目，适合多站点且各项目需求不同的场景，不干扰其他站点。
1、在宝塔面板【网站】列表中找到目标站点，点击【根目录】进入文件管理器。
2、确认项目根目录下存在 composer.json 文件；若无，可先执行 composer init 初始化。
3、在项目根目录下执行命令：composer config repo.packagist composer https://packagist.phpcomposer.com（使用腾讯云镜像）。
4、检查是否写入成功：运行 composer config repo.packagist，返回值应与上一步设置一致。
三、临时使用镜像安装依赖
该方法不修改任何配置文件，仅在单次命令中生效，适用于测试不同镜像效果或临时调试场景。
1、进入目标网站根目录（可通过宝塔【终端】或【文件】→【打开终端】）。
2、执行安装命令时直接指定镜像源：composer install -vvv --repository-url=https://mirrors.huaweicloud.com/repository/php/。
3、如需更新依赖，使用相同参数：composer update -vvv --repository-url=https://mirrors.huaweicloud.com/repository/php/。
四、修改全局配置文件（手动编辑方式）
当命令行配置失效或需批量查看/修改多个镜像参数时，可直接编辑 config.json 文件进行精确控制。
1、在宝塔【文件】管理器中，路径定位到 /root/.composer/config.json。
2、点击该文件，选择【编辑】，确保内容包含如下结构（若无则手动添加）：
"repositories": {"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}。
3、保存后，在终端执行 composer clear-cache 清除旧缓存。
五、为宝塔内置 PHP 环境启用 Composer（若未安装）
部分宝塔安装环境可能未预装 Composer，或 PHP CLI 使用的是非宝塔管理的 PHP 版本，需确保调用的是宝塔所管理的 PHP 对应的 Composer。
1、在宝塔【软件商店】中搜索并安装【Composer】插件（如有）；若无，则手动安装。
2、执行命令确认当前 PHP CLI 路径：which php，应返回类似 /www/server/php/82/bin/php 的路径。
3、下载 Composer 并绑定到该 PHP：curl -sS https://getcomposer.org/installer | /www/server/php/82/bin/php。
4、将生成的 composer.phar 移至系统路径：mv composer.phar /usr/local/bin/composer。
