入门1-基础入门
1.PHP
Yii 是一个 PHP 框架,因此请确保您 阅读并理解语言参考。 用 Yii 进行开发时,您将以面向对象的方式编写代码,因此请确保您熟悉类与对象以及命名空间。
2.面向对象编程
对面向对象编程的基本理解是必需的。如果您不熟悉它,请选中其中一个 可用的教程,如 tuts+。
请注意,您的应用程序越复杂,您需要学习的更高级的 OOP 概念才能成功掌握这种复杂度。
3.命令行和 Composer
Composer 是 PHP 用来管理依赖(dependency)关系的工具。你可以在自己的项目中声明所依赖的外部工具库(libraries),Composer 会帮你安装这些依赖的库文件。Yii 广泛使用了标准的 PHP 包管理器 Composer,因此请确保您阅读 并理解其指南。
4、安装yii2
安装 Composer 后,您可以通过在 Web 可访问的文件夹下运行以下命令来 安装Yii应用程序模板:
composer create-project --prefer-dist yiisoft/yii2-app-basic basic
这将在一个名为 basic
的目录中安装Yii应用程序模板的最新稳定版本。 如果需要,您可以选择不同的目录名称。
验证安装的结果
当安装完成之后, 或配置你的Web服务器(看下面的文章)或使用内置Web Server, 当在项目 web
目录下可以通过下面的命令:
php yii serve
5、运行运用
安装 Yii 后,就有了一个可运行的 Yii 应用, 根据配置的不同,可以通过 http://hostname/basic/web/index.php
或 http://hostname/index.php
访问。
6、应用结构
应用中最重要的目录和文件(假设应用根目录是 basic
):
一般来说,应用中的文件可被分为两类:在 basic/web
下的和在其它目录下的。 前者可以直接通过 HTTP 访问(例如浏览器),后者不能也不应该被直接访问。
Yii的静态结构和请求生命周期
参考链接:http://sop.4399om.com/pages/viewpage.action?pageId=121045123
7、第一行代码
创建动作
为了 “Hello”,需要创建一个 say
操作, 从请求中接收 message
参数并显示给最终用户。 如果请求没有提供 message
参数,操作将显示默认参数 “Hello”。
操作必须声明在控制器中。为了简单起见, 你可以直接在 SiteController
控制器里声明 say
操作。 这个控制器是由文件 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]); } }
在上述 SiteController
代码中,say
操作被定义为 actionSay
方法。 Yii 使用 action
前缀区分普通方法和操作。 action
前缀后面的名称被映射为操作的 ID。
涉及到给操作命名时,你应该理解 Yii 如何处理操作 ID。 操作 ID 总是被以小写处理,如果一个操作 ID 由多个单词组成, 单词之间将由连字符连接(如 create-comment
)。 操作 ID 映射为方法名时移除了连字符,将每个单词首字母大写,并加上 action
前缀。 例子:操作 ID create-comment
相当于方法名 actionCreateComment
。
上述代码中的操作方法接受一个参数 $message
, 它的默认值是 “Hello”
(就像你设置 PHP 中其它函数或方法的默认值一样)。 当应用接收到请求并确定由 say
操作来响应请求时,应用将从请求的参数中寻找对应值传入进来。 换句话说,如果请求包含一个 message
参数, 它的值是 “Goodbye”
, 操作方法中的 $message
变量也将被填充为 “Goodbye”
。
在操作方法中,render() 被用来渲染一个 名为 say
的视图文件。 message
参数也被传入视图,这样就可以在里面使用。操作方法会返回渲染结果。 结果会被应用接收并显示给最终用户的浏览器(作为整页 HTML 的一部分)。
创建视图
视图是你用来生成响应内容的脚本。为了说 “Hello”, 你需要创建一个 say 视图,以便显示从操作方法中传来的 message 参数。
<?php
use yii\helpers\Html;
?>
<?= Html::encode($message) ?>
say 视图应该存为 views/site/say.php 文件。当一个操作中调用了 render() 方法时, 它将会按 views/控制器 ID/视图名.php 路径加载 PHP 文件。
当然了,你大概会在 say 视图里放入更多内容。内容可以由 HTML 标签,纯文本, 甚至 PHP 语句组成。实际上 say 视图就是一个由 render() 执行的 PHP 脚本。 视图脚本输出的内容将会作为响应结果返回给应用。应用将依次输出结果给最终用户。
试运行
创建完动作和视图后,你就可以通过下面的 URL 访问新页面了:
http://hostname/index.php?r=site/say&message=Hello+World
8、使用gii生成代码
准备数据库
首先创建一个名为 yii2basic
的数据库,应用将从这个数据库中读取数据。 你可以创建 SQLite,MySQL,PostregSQL,MSSQL 或 Oracle 数据库,Yii 内置多种数据库支持。简单起见,后面的内容将以 MySQL 为例做演示。
然后在数据库中创建一个名为 country
的表并插入简单的数据。可以执行下面的语句:
CREATE TABLE `country` ( `code` CHAR(2) NOT NULL PRIMARY KEY, `name` CHAR(52) NOT NULL, `population` INT(11) NOT NULL DEFAULT '0' ) ENGINE=InnoDB DEFAULT CHARSET=utf8; INSERT INTO `country` VALUES ('AU','Australia',18886000); INSERT INTO `country` VALUES ('BR','Brazil',170115000); INSERT INTO `country` VALUES ('CA','Canada',1147000); INSERT INTO `country` VALUES ('CN','China',1277558000); INSERT INTO `country` VALUES ('DE','Germany',82164700); INSERT INTO `country` VALUES ('FR','France',59225700); INSERT INTO `country` VALUES ('GB','United Kingdom',59623400); INSERT INTO `country` VALUES ('IN','India',1013662000); INSERT INTO `country` VALUES ('RU','Russia',146934000); INSERT INTO `country` VALUES ('US','United States',278357000);
配置数据库连接
打开 config/db.php
修改里面的配置参数对应你的数据库配置。 该文件默认包含这些内容:
<?php return [ 'class' => 'yii\db\Connection', 'dsn' => 'mysql:host=localhost;dbname=yii2basic', 'username' => 'root', 'password' => '', 'charset' => 'utf8', ];
config/db.php
是一个典型的基于文件的配置工具。 这个文件配置了数据库连接 yii\db\Connection 的创建和初始化参数, 应用的 SQL 查询正是基于这个数据库。
开始 Gii
Gii 是 Yii 中的一个模块。 可以通过配置应用的 modules 属性开启它。通常来讲在 config/web.php
文件中会有以下配置代码:
$config = [ ... ]; if (YII_ENV_DEV) { $config['bootstrap'][] = 'gii'; $config['modules']['gii'] = [ 'class' => 'yii\gii\Module', ]; }
这段配置表明,如果当前是开发环境, 应用会包含 gii
模块,模块类是 yii\gii\Module。
如果你检查应用的入口脚本 web/index.php
, 将看到这行代码将 YII_ENV_DEV
设为 true:
defined(
'YII_ENV')
ordefine(
'YII_ENV',
'dev');
鉴于这行代码的定义,应用处于开发模式下,按照上面的配置会打开 Gii 模块。你可以直接通过 URL 访问 Gii:
http://hostname/index.php?r=gii
生成活动记录类
选择 “Model Generator” (点击 Gii 首页的链接)去生成活动记录类。并像这样填写表单:
- Table Name:
country
- Model Class:
Country
然后点击 “Preview” 按钮。你会看到 models/Country.php 被列在将要生成的文件列表中。可以点击文件名预览内容。
如果你已经创建过同样的文件,使用 Gii 会覆写它, 点击文件名旁边的 diff 能查看现有文件与将要 生成的文件的内容区别。
想要覆写已存在文件,选中 “overwrite” 下的复选框然后点击 “Generator”。如果是新文件,只点击 “Generator” 就好。
接下来你会看到一个包含已生成文件的说明页面。如果生成过程中覆写过文件, 还会有一条信息说明代码是重新生成覆盖的。