推荐用 composer create-project 安装 Yii2,它自动拉取完整骨架(含 web 入口、配置、基础命令),避免手动 require 导致的 404、命令缺失等问题;装基础版用 yii2-app-basic,高级版用 yii2-app-advanced,并加 --stability=stable 防 dev 分支;国内安装卡住时应换镜像并加 --no-scripts,装完再运行 php init;需确保 PHP 版本(7.4–8.1)、mbstring、openssl 和 pdo_mysql 扩展启用;Linux/macOS 需 chmod +x vendor/bin/yii,Windows 应用 yii.bat;全局命令建议 alias 而非 PATH。

直接用 create-project 装,别手动生成 composer.json
Yii2 官方不推荐手动 init 项目再 add 包,create-project 一步到位最稳。它会自动拉取带完整骨架(含 web 入口、配置、基础命令)的 yii2-app-basic 或 yii2-app-advanced,避免后续路由 404、console 命令找不到等隐性问题。
常见错误现象:composer require yiisoft/yii2 后跑不起来——缺 bootstrap、缺 index.php、yii 命令根本不存在。
- 装基础版:
composer create-project --prefer-dist yiisoft/yii2-app-basic basic - 装高级版(多环境/前后端分离):
composer create-project --prefer-dist yiisoft/yii2-app-advanced advanced - 加
--stability=stable防止误装 dev 分支(尤其国内镜像有时同步滞后)
国内安装慢或卡在 yii2-auth-client?换源 + 关闭脚本执行
Yii2 的 composer.json 里默认启用了 post-install-cmd 脚本(如生成 cookie key、初始化权限),但国内网络常卡在 yii2-auth-client 的 GitHub API 请求上,导致整个 install 失败或超时。
正确做法是先跳过脚本,装完再手动处理:
- 临时禁用脚本:
composer create-project --no-scripts --prefer-dist yiisoft/yii2-app-basic basic - 换阿里/腾讯镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 装完进项目目录,手动补 key:
php init(选 Development / Production),它会生成cookieValidationKey并初始化环境
PHP 版本和扩展不满足,require 报错就停
Yii2.0.x 要求 PHP ≥ 5.4,但实际项目中多数人用 7.4+;Yii2.1+ 强制要求 PHP ≥ 7.1。如果 composer create-project 报 Your requirements could not be resolved,大概率是 PHP 版本或缺失扩展。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
必须检查的三项:
- PHP 版本:
php -v(Yii2.1+ 不兼容 PHP 8.2 的某些弃用语法,稳妥起见用 7.4–8.1) -
mbstring扩展:没启用会报Class 'Mbstring' not found -
openssl和pdo_mysql(或对应数据库驱动):哪怕只是跑 demo,控制台命令如yii migrate也会立刻失败
Windows 用户注意:php.ini 里要取消注释 extension=mbstring 和 extension=openssl,改完记得重启 php-fpm 或 Apache。
vendor/bin/yii 命令打不开?权限或路径不对
装完发现 ./vendor/bin/yii 提示 permission denied 或 command not found,不是框架没装好,而是 Unix/Linux/macOS 下可执行位没设,或 Windows 用户误用 yii(没后缀)。
- Linux/macOS:
chmod +x vendor/bin/yii,然后用./vendor/bin/yii(不能只输yii) - Windows:
vendor\bin\yii.bat才是正确入口,yii文件本身是 shell 脚本,Windows 不认 - 想全局用命令?别加到 PATH,用
alias yii='./vendor/bin/yii'(zsh/bash)更安全,避免污染系统环境
真正容易被忽略的是:高级版里有两个 yii 入口——backend/web/yii 和 frontend/web/yii 是假的,只有根目录下 yii(或 vendor/bin/yii)才是主命令行工具。

















