<p>先执行 composer --version 检查是否已安装，若提示 command not found 则需安装；确认 PHP ≥8.0 且启用 curl/json/openssl 扩展后，用 curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer 全局安装；再执行 composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ 配置腾讯云镜像，末尾斜杠不可省略，并用 composer config -g repo.packagist 验证输出是否为该地址。</p>
确认当前 Composer 是否已安装并可执行
在腾讯云轻量应用服务器上，composer 不是默认预装工具。先执行 composer --version，如果提示 command not found，说明还没装；若返回版本号（如 Composer version 2.7.7），则跳过安装步骤，直接配置镜像。
常见错误现象：执行 composer install 卡住十几秒后报 Connection timed out 或 cURL error 28，基本可判定是直连 Packagist 官方源失败——国内服务器访问境外源不稳定，必须配镜像。
- 检查 PHP 环境是否就绪：
php -v应输出 ≥ 8.0 的版本，且需启用curl、json、openssl扩展 - 全局安装推荐方式（Linux）：
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - 权限问题：若提示
Permission denied，改用sudo或换到用户级安装（如~/bin/composer并加入$PATH）
用 composer config -g 设置腾讯云镜像（推荐）
腾讯云镜像地址 https://mirrors.cloud.tencent.com/composer/ 是目前最稳定、更新频率为 24 小时的国内源，适配轻量服务器的网络环境。全局配置只需一条命令，影响所有项目，无需反复设置。
执行以下命令：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
验证是否生效：
composer config -g repo.packagist
应输出 https://mirrors.cloud.tencent.com/composer/。注意不要漏掉末尾斜杠，否则部分版本会静默失败。
腾讯云跨账号资源迁移工具，支持将账号A的VPC、CLB、NAT、CVM、安全组等资源迁移至账号B，通过CCN云联网实现跨账号网络互通，提供自动扫描、配置生成、Terraform部署功能。
- 别用已失效的旧地址，比如
https://packagist.phpcomposer.com（2023 年起陆续下线）或https://packagist.laravel-china.org（2024 年停止服务） - 如果提示
Could not write to /root/.composer/config.json，说明权限不足，加sudo再试，或改用用户目录安装 Composer - 该命令会修改全局配置文件
~/.composer/config.json，内容形如：{"repositories":{"packagist":{"type":"composer","url":"https://mirrors.cloud.tencent.com/composer/"}}}
项目级临时覆盖镜像（适合多源调试）
某些项目需要临时切回官方源做兼容性验证，或团队协作中要求不依赖全局配置，这时可在项目根目录（即含 composer.json 的目录）运行项目级配置：
composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/
它会在当前项目的 composer.json 中写入 repositories 字段，优先级高于全局配置。删除该字段即可恢复全局设置。
- 项目配置不会影响其他目录，适合 CI/CD 流水线中隔离环境
- 误操作后可手动编辑
composer.json删除"repositories"块，或执行composer config --unset repositories.packagist - 注意：项目配置对
composer create-project无效——该命令启动时还未读取项目内配置，必须靠全局镜像兜底
验证镜像是否真正生效
光看 config 输出还不够，得实测下载行为。最可靠的方式是清空缓存并触发一次真实请求：
composer clear-cache<br>composer require monolog/monolog --dry-run
--dry-run 不实际安装，但会解析依赖并打印下载 URL。观察输出里是否出现 mirrors.cloud.tencent.com 而非 repo.packagist.org。
- 若仍看到官方域名，检查是否被项目
composer.json中的repositories覆盖，或存在.composer/auth.json干扰 - 加
-vvv参数可看到完整 HTTP 请求日志：composer require psr/log -vvv 2>&1 | grep "GET https" - 腾讯云镜像不支持私有包重定向，若项目依赖了 GitHub 私有仓库，需单独配置
repositories类型为vcs，镜像设置对此无影响
配置完成之后，composer update 和 install 的首屏响应通常从分钟级降到秒级。最容易被忽略的是：轻量服务器默认可能关闭 IPv6，而某些镜像 CDN 对 IPv6 解析异常，若遇到偶发超时，可在 /etc/sysctl.conf 中临时禁用 IPv6 验证是否相关。
