yii2 本身不提供“跳转国内”功能,实际需配置 composer 国内镜像源(如阿里云)加速依赖安装;必须全局安装 fxp/composer-asset-plugin 插件以解决前端资源问题;创建项目时应指定 --repository 参数使用国内源;后续仍需手动执行 init、数据库配置及迁移。

Yii2 本身不提供“跳转国内”的功能,你实际想配置的是开发环境中的依赖加速方案:即让 Composer 安装 Yii2 及其扩展时走国内镜像源,大幅缩短下载时间、避免超时失败。
官网文档入口(中文权威)
Yii2 官方中文文档地址:
https://www.php.cn/link/c51bf93c175bd56cd3b60081377ab356
这是 Yii2 官方维护的安装与入门指南,明确推荐使用 Composer,并指出可配置国内镜像提升体验。
Composer 全局换源(推荐阿里云镜像)
执行以下命令,将 Packagist 全局源切换为阿里云镜像(稳定、更新及时,2026年仍为首选):
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效:composer config -g repo.packagist → 应输出 https://mirrors.aliyun.com/composer/
必须安装的 Asset 插件(解决 bower/npm 资源问题)
Yii2 高级模板依赖前端资源(如 jQuery),需通过 fxp/composer-asset-plugin 管理。注意:
✅ 该插件已停止维护,但 Yii2 2.0.x 版本仍需它;
✅ 必须用 全局安装,且版本需匹配(推荐 ~1.4.6 或 ~1.5.0):
- 运行:
composer global require "fxp/composer-asset-plugin:~1.4.6" - 若提示“command not found”,请确认
composer global bin目录已加入系统 PATH
创建项目时直接指定国内源(一劳永逸)
安装 Yii2 高级模板时,加上 --repository-url 参数可强制走镜像(兼容旧版):
composer create-project --prefer-dist yiisoft/yii2-app-advanced advanced -n --repository-url=https://packagist.phpcomposer.com- 或更稳妥写法(适配新版 Composer):
composer create-project --prefer-dist --repository=https://mirrors.aliyun.com/composer/ yiisoft/yii2-app-advanced advanced
注:2026 年起,packagist.phpcomposer.com 已下线,优先用阿里云镜像地址。
额外提醒:数据库迁移和初始化别漏掉
镜像只加速下载,后续步骤仍需手动执行:
- 进项目目录运行
init(选 0 开发环境 → 输入 yes) - 配置
common/config/main-local.php中的数据库连接 - 执行
yii migrate创建 user 表等基础结构
不复杂但容易忽略











