应使用 composer create-project –prefer-dist yiisoft/yii2-app-basic myproject 2.0.48 安装受支持的最后一个稳定版,因 Yii2 2.0.x 系列已于 2023 年底进入 EOL,仅提供安全补丁。
直接用 composer create-project 就能装好 Yii2,但默认会拉取最新稳定版(通常是 2.0.48),而这个版本已停止维护;如果项目需要长期支持,得手动指定 LTS 版本或改用 Yii3——不过你问的是 Yii2,那就得先确认是否真要踩这个老版本的坑。
用 create-project 初始化 Yii2 项目时怎么选版本
不加参数默认装的是最近发布的非 RC 版本,但 Yii2 官方早在 2023 年底就宣布 2.0.x 系列进入 EOL(End of Life),只有安全补丁,不再修复 bug。所以别用 composer create-project --prefer-dist yiisoft/yii2-app-basic 这种裸命令。
- 要装受支持的最后一个稳定版(2.0.48),显式加上
@stable:
composer create-project --prefer-dist yiisoft/yii2-app-basic myproject 2.0.48 - 如果服务器 PHP 版本是 8.0+,注意 2.0.48 对 PHP 8.1 的某些特性(如枚举、只读类)兼容性有限,实际运行中可能触发
Deprecated: strlen(): Passing null to parameter #1 ($string) of type string is deprecated类似警告 - 想跳过 Web 服务器配置阶段?加
--no-install先生成结构,再自己跑composer install控制依赖安装时机
composer.json 里哪些 Yii2 相关配置容易出问题
Yii2 的应用模板自带大量预设包(如 yiisoft/yii2-bootstrap4、yiisoft/yii2-debug),但它们的版本约束写法很松,比如 "~2.0.0",升级时可能意外拉入不兼容变更。