5分钟可在wampserver中成功运行yii2:确认php≥7.4、composer可用,用composer在www目录创建项目,配置虚拟主机并重启服务,访问myapp.test即可看到欢迎页。

直接在WampServer里跑起Yii2,其实不用折腾太久——只要环境已就绪,5分钟真能搞定。关键不是“装”,而是让WampServer正确识别PHP版本、Composer可用,并把Yii2项目放对位置。
确认WampServer的PHP和Composer已就绪
Yii2最低要求PHP 7.4(推荐8.0+),先点WampServer托盘图标 → PHP → 版本,选一个≥7.4的版本。接着打开命令行(Win+R → cmd),输入:
php -v 确认版本,再输 composer -V 检查Composer是否可用。如果报“不是内部命令”,说明没配环境变量——把WampServer里的Composer路径(如 C:\wamp64\bin\php\php8.1.12\composer.phar)加到系统PATH,或直接用 php composer.phar 代替 composer 命令。
用Composer快速创建Yii2应用
打开命令行,切换到WampServer的www目录(默认是 C:\wamp64\www),执行:
- cd C:\wamp64\www
- composer create-project --prefer-dist yiisoft/yii2-app-basic myapp
其中 myapp 是你的项目名,执行后会自动下载并解压基础模板。等待几分钟(取决于网速),完成后目录结构就齐了:C:\wamp64\www\myapp。
配置虚拟主机或直接访问
不想输端口和路径?建议配个虚拟主机:
- 编辑 C:\wamp64\bin\apache\apache2.4.xx\conf\extra\httpd-vhosts.conf,末尾加:
ServerName myapp.test
DocumentRoot "c:/wamp64/www/myapp/web"
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
- 再打开 C:\Windows\System32\drivers\etc\hosts,追加一行:127.0.0.1 myapp.test
- 重启WampServer所有服务(左键托盘图标 → Restart All Services)
浏览器访问 http://myapp.test,看到Yii2欢迎页即成功。
常见卡点与绕过技巧
如果页面空白或报错,优先查这三项:
- Apache模块是否启用了 rewrite_module(WampServer托盘 → Apache → Apache Modules → 勾选它)
- 项目根目录下的 web/.htaccess 是否存在且未被误删(基础模板自带,别手动清空www目录)
- PHP扩展是否开启:mbstring、openssl、pdo_mysql(托盘 → PHP → PHP Extensions里确认勾选)
若仍报“Setting locale failed”,可在 myapp/config/web.php 的 components 里临时注释掉 formatter 配置,或改用 'locale' => 'en-US'。











