新手部署yii2.0.55需先安装composer并配置阿里云国内镜像，全局执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，或项目级执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/并清缓存，最后验证生效。
新手部署Yii2.0.55项目时，因默认连接 packagist.org 国外源常出现超时、卡死或404错误，导致 composer install 或 create-project 命令反复失败，必须在执行安装前完成国内镜像配置。
确认Composer已安装并可用
在终端运行 composer -V，看到类似 Composer version 2.8.9 的输出才算就绪。若提示 command not found，需先安装Composer——用 curl -sS https://getcomposer.org/installer | php 下载后，再执行 mv composer.phar /usr/local/bin/composer（Linux/macOS）或手动添加到Windows PATH。
这一步跳过会导致后续所有命令直接报错，不是“慢”，而是根本无法启动依赖解析流程。
设置全局国内镜像（推荐阿里云）
执行以下命令一次性切换全局源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
该命令会修改当前用户级的 ~/.composer/config.json，生效范围覆盖所有项目。阿里云镜像同步及时、稳定性高，2026年仍为首选；【切勿使用已停服的 phpcomposer.com 镜像】，该地址自2023年起已失效，继续配置将导致所有包下载失败。
为Yii2.0.55项目单独配置镜像（更稳妥）
进入你的 Yii2 项目根目录（即含 composer.json 的目录），按顺序执行：
第一步：编辑项目级配置文件
运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/，不加 -g 参数，仅作用于当前项目。
第二步：验证镜像是否写入
打开项目根目录下的 composer.json，检查是否新增了 "repositories" 区块，内容形如：
{ "repositories": { "packagist": { "type": "composer", "url": "https://mirrors.aliyun.com/composer/" } } }
若未出现，说明上一步执行路径错误——必须确保终端当前工作目录是项目根目录，否则配置会写进别的地方，白忙一场。
第三步：清除本地缓存
运行 composer clear-cache，强制 Composer 丢弃旧源缓存，避免它偷偷回退到国外源。
验证镜像是否生效
方法一：查看当前源配置
执行 composer config repo.packagist，输出应为 {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。
方法二：触发一次真实请求
运行 composer show yiisoft/yii2 2.0.55，如果秒级返回包信息而非卡住10秒以上，说明镜像已起效。
注意：若仍卡顿，大概率是DNS污染——可临时在 /etc/hosts（Mac/Linux）或 C:\Windows\System32\drivers\etc\hosts（Windows）中追加一行：114.55.221.17 mirrors.aliyun.com，然后重试。
