Yii2 官网已停用ZIP包下载,唯一安装方式是Composer:执行create-project命令并配置国内镜像;离线部署需保留composer.lock后运行install;PHP最低要求8.0+且必须启用指定扩展。

官网下载链接已失效,别再点“Download”按钮了
Yii 官网 https://www.yiiframework.com/download 页面目前仅提供文档和社区入口,**不再托管任何 ZIP 安装包下载链接**。你看到的“Download”按钮实际跳转到 GitHub 仓库的 Releases 页面,而 Yii2 的正式发布早已停止(最后一个稳定版是 v2.0.53),GitHub 上也只保留归档状态。直接从官网点下载,大概率会 404 或跳到空页面。
真正能用的安装方式只剩 Composer,不是“可选”,是唯一路径
Yii2 不再支持解压即用的 ZIP 包部署(尤其 PHP ≥ 8.1 后,requirements/index.php 检查会直接失败)。所有可用安装必须通过 Composer 执行:
-
composer create-project --prefer-dist yiisoft/yii2-app-basic basic(基础模板) -
composer create-project --prefer-dist yiisoft/yii2-app-advanced advanced(高级模板) - 务必提前配置国内镜像,否则卡在
fxp/composer-asset-plugin或依赖拉取阶段:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 注意:
fxp/composer-asset-plugin已废弃,新版 Composer(≥2.2)无需手动安装它;若提示报错,删掉~/.composer/vendor/fxp并升级 Composer 即可
想离线安装?别折腾 ZIP 包,用 composer install + vendor 缓存更可靠
所谓“离线安装”,本质是避免重复下载大量前端资源(Bootstrap、jQuery 等)。正确做法不是找旧 ZIP 包,而是:
- 在有网环境跑一次完整
composer create-project,生成完整的vendor/和assets/ - 把整个项目目录打包带走,包括
composer.lock文件(它锁定了精确版本) - 目标机器只需运行
composer install --no-dev(不重装 dev 依赖),Composer 会跳过下载,直接解包已有依赖 - 切勿手动复制
vendor/后删掉composer.lock—— 这会导致下次composer update行为不可控,甚至破坏 asset 发布逻辑
PHP 版本和扩展要求,现在比五年前更严格
哪怕你成功下到一个 2016 年的 ZIP 包,解压后运行也会立刻报错:
- 最低 PHP 版本已是
7.4(v2.0.44起),v2.0.53实际要求8.0+ -
mbstring、openssl、json、gd、xml必须启用 —— 光靠requirements/index.php检查不够,有些扩展(如intl)在 CLI 和 Web SAPI 下启用状态可能不一致 -
cookieValidationKey不再是可选项:没配config/web.php里的这个字段,首页直接 500,错误信息是Invalid Configuration – yii\base\InvalidConfigException
ZIP 包时代那种“扔上去就跑”的做法,在当前生态里已经走不通了。真正的门槛不在下载动作本身,而在 Composer 流程是否干净、PHP 环境是否对齐、以及你有没有意识到 composer.lock 是部署一致性唯一的锚点。


















