零基础上手 Yii 2: 30 分钟搭建第一个应用
你还在为选择合适的 PHP 框架而烦恼吗?还在为复杂的配置和冗长的代码感到沮丧吗?本文将带你在 30 分钟内从零开始,搭建一个基于 Yii 2: The Fast, Secure and Professional PHP Framework 的完整应用。读完本文,你将掌握 Yii 2 的安装方法、基本项目结构、控制器与视图的创建,以及如何使用 Gii 工具快速生成代码,让你轻松迈入 Yii 2 的开发世界。
准备工作:安装 Yii 2
在开始之前,请确保你的开发环境满足 Yii 2 的基本要求:PHP 5.4 或更高版本,以及相应的数据库驱动(如果需要使用数据库)。你可以通过运行以下命令检查环境是否符合要求:
php requirements.php
使用 Composer 安装 Yii 2
Yii 2 推荐使用 Composer 进行安装。如果你还没有安装 Composer,可以通过以下命令安装:
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
安装完成后,运行以下命令安装 Yii 2 应用模板:
composer create-project --prefer-dist yiisoft/yii2-app-basic basic
这条命令会在当前目录下创建一个名为 basic 的文件夹,并在其中安装 Yii 2 的基本应用模板。
验证安装结果
安装完成后,你可以通过内置的 Web 服务器启动应用:
cd basic
php yii serve
然后在浏览器中访问 http://localhost:8080,如果看到 "Congratulations!" 页面,说明安装成功。
官方安装文档:docs/guide-zh-CN/start-installation.md
创建第一个页面:Hello World
接下来,我们将创建一个简单的 "Hello World" 页面,来了解 Yii 2 的基本工作流程。
创建控制器动作
在 Yii 2 中,请求是通过控制器(Controller)和动作(Action)来处理的。我们可以在 controllers/SiteController.php 文件中添加一个新的动作:
<?php
namespace app\controllers;
use yii\web\Controller;
class SiteController extends Controller
{
// ... 现有的代码 ...
public function actionSay($message = 'Hello')
{
return $this->render('say', ['message' => $message]);
}
}
创建视图文件
然后,在 views/site 目录下创建一个名为 say.php 的视图文件:
<?php
use yii\helpers\Html;
?>
<?= Html::encode($message) ?>
访问页面
现在,你可以通过以下 URL 访问新创建的页面:
http://localhost:8080/index.php?r=site/say&message=Hello+World
你应该能看到页面上显示 "Hello World"。
官方指南:docs/guide-zh-CN/start-hello.md
使用 Gii 快速生成代码
Yii 2 提供了一个强大的代码生成工具 Gii,可以帮助我们快速生成模型、控制器和视图等代码。
开启 Gii
在开发环境下,Gii 通常已经默认开启。如果没有,你可以在 config/web.php 文件中添加以下配置:
if (YII_ENV_DEV) {
$config['bootstrap'][] = 'gii';
$config['modules']['gii'] = [
'class' => 'yii\gii\Module',
'allowedIPs' => ['127.0.0.1', '::1'],
];
}
然后通过以下 URL 访问 Gii:
http://localhost:8080/index.php?r=gii
生成模型类
选择 "Model Generator",输入数据库表名(例如 country)和模型类名(例如 Country),然后点击 "Generate" 按钮生成模型类。
生成 CRUD 代码
选择 "CRUD Generator",输入模型类名(例如 app\models\Country),然后点击 "Generate" 按钮生成 CRUD(增删改查)代码。
查看生成的代码
生成完成后,你可以通过以下 URL 访问生成的页面:
http://localhost:8080/index.php?r=country/index
你应该能看到一个包含国家数据的网格视图,支持排序、筛选、查看、编辑和删除等操作。
官方 Gii 指南:docs/guide-zh-CN/start-gii.md
总结与展望
通过本文的学习,你已经掌握了 Yii 2 的基本安装方法、控制器与视图的创建,以及如何使用 Gii 工具快速生成代码。这些知识足以让你开始构建简单的 Yii 2 应用。
接下来,你可以进一步学习 Yii 2 的高级特性,如数据库操作、用户认证、缓存、RESTful API 等。Yii 2 提供了丰富的文档和教程,帮助你深入了解和使用这个强大的 PHP 框架。
官方文档:docs/guide-zh-CN/
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考









