yii2跑通helloworld只需三步:确认项目生成、添加控制器动作、访问url。推荐用yii2-app-basic模板,执行composer create-project命令创建;在sitecontroller中新增actionsay方法;用php内置服务器启动,访问对应url即可。

安装 Yii2 后跑通第一个 HelloWorld,核心就三步:确认项目已正确生成、修改或创建可响应的控制器动作、通过 Web 服务器访问对应 URL。不需要改框架源码,也不用碰数据库,纯前端可验证。
用 Composer 快速创建基础项目
推荐使用官方推荐的 yii2-app-basic 模板,它轻量、结构清晰,适合入门:
- 确保已安装 Composer(含中国镜像加速更稳)
- 执行命令:composer create-project --prefer-dist yiisoft/yii2-app-basic myapp
- 等待自动下载依赖、生成目录、设置权限(如 runtime/web/assets 可写)
- 完成后,myapp 就是你的项目根目录
让 HelloWorld 出现在浏览器里
默认首页已自带 “Hello, Yii!”,但为了真正理解流程,建议手动写一个专属的 HelloWorld 动作:
- 打开 myapp/controllers/SiteController.php
- 在类中新增一个方法:
public function actionSay($message = 'Hello World!') { return $this->renderContent($message); } - 保存后,在浏览器访问:http://localhost:8000/index.php?r=site/say(若用 PHP 内置服务器)
- 想传参?试试:http://localhost:8000/index.php?r=site/say&message=Yii2真简单
启动本地服务器,跳过 Apache/Nginx 配置
新手不必急着配虚拟主机,PHP 自带服务器足够起步:
- 终端进入 myapp/web 目录
- 运行:php -S localhost:8000 router.php(router.php 是 Yii2 自带的路由引导文件)
- 访问 http://localhost:8000 即可见默认欢迎页
- 该方式实时生效,改完代码刷新即见效果,无缓存干扰
检查关键配置和常见卡点
如果页面空白或报错,优先看这几处:
- web/index.php 中 YII_DEBUG 是否设为 true(开发时必须)
- runtime/ 目录是否可写(Linux/macOS 执行 chmod 777 runtime)
- URL 中 r=xxx/xxx 的格式是否正确(controller/action,小写+中划线)
- 浏览器地址栏是否漏了 index.php?(除非已配置 URL 重写)











