零基础装好Yii2最快路径是用Composer创建基础模板并启动内置服务器:检查PHP≥7.4和Composer已安装,执行composer create-project创建项目,再php yii serve启动,访问localhost:8080见欢迎页即成功。

零基础也能装好 Yii2,关键不是“从头造轮子”,而是选对方式、跳过坑点。对新手最友好的路径是:用 Composer 创建基础模板 + 启动内置服务器,全程不碰数据库、不配虚拟主机、不改配置文件——5 分钟内看到欢迎页就是成功。
第一步:确认环境够用
不用装 XAMPP 或 WAMP,PHP 自带的服务器就能跑起来。只需检查两点:
- 打开命令行,输入 php -v,显示版本 ≥ 7.4(Yii2 官方最低要求是 5.4,但新系统建议 7.4+)
- 输入 composer --version,有输出说明 Composer 已装好;没装就去 getcomposer.org 下载安装程序,一路下一步即可
第二步:一条命令创建项目
别下载压缩包、别克隆仓库、别手动解压——直接用 Composer 生成干净项目:
- 在你想放项目的文件夹里(比如桌面新建个 myapp 文件夹),右键打开终端(Windows 是“在此处打开 PowerShell”)
- 执行这行命令(复制粘贴,回车):
composer create-project --prefer-dist yiisoft/yii2-app-basic myproject - 等待几分钟,完成后会多出一个 myproject 文件夹,里面就是完整的 Yii2 基础版
第三步:启动服务,立刻看到页面
进入项目目录,用 PHP 内置服务器跑起来:
- 执行:cd myproject
- 执行:php yii serve(注意不是 php index.php)
- 浏览器打开 https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e,出现 Yii2 黄色欢迎页,说明安装完成 ✅
常见卡点和应对
如果命令报错,大概率是这几个原因:
-
“Could not find package…”:网络慢,临时切国内镜像,执行:
composer config -g repo.packagist composer https://packagist.phpcomposer.com - “fxp/composer-asset-plugin” 报错:新版 Composer 已不再需要它,忽略该提示,继续执行 php yii serve
- “Access denied” 或 “Permission denied”:Windows 用户请用管理员身份运行 PowerShell;Mac/Linux 用户可加 sudo(不推荐长期用,仅临时测试)











