学习yii2.0——基础入门

声明：本文内容来自于yiichina.com的权威指南。

安装

　　推荐使用composer来安全，可能有点慢（要下载的依赖比较多）。

composer create-project --prefer-dist yiisoft/yii2-app-basic basic

　　

启动

　　yii框架的入口文件是web/index.php。但是在访问yii框架之前，如果不是使用composer来安装yii框架的话，那么就需要修改config/web.php中的cookieValidationKey，这个值是用来验证cookie的。

　　如果是通过composer安装的话，那么就不用再手动添加cookieValidationKey，因为composer已经帮忙添加了。

　　配置虚拟主机或者直接访问入口文件，都行。

　　本地访问localhost/basic/web/index.php，即可看到运行结果。

创建控制器（controller）以及动作（action）

　　需要注意以下几点：

　　1、控制器是放在controllers/目录下的

　　2、文件名要和控制器（类名）相同。

　　3、控制器名称的格式为XyzController。

　　4、要将控制器声明在app\controllers这个命名空间下。

　　5、声明的控制器要继承yii的控制器，使用use yii\web\Controller即可。该类的位置是vendor/yiisoft/yii2/web/Controller.php，这个类继承yii\base\Controller。

　　6、控制器可以有多个动作，动作的命名规范是actionAbc()。

　　下面是一个简单的HelloController.php

<?php
namespace app\controllers;

use yii\web\Controller;

class HelloController extends Controller {
	public function actionIndex()
	{
		echo "hello yii";
	}
}

　　

访问控制器和动作

　　格式为：localhost/basic/web/index.php?r=hello/index。

　　index.php后面的r表示路由；hello对应的是控制器HelloController；index对应的是控制器中的actionIndex动作。

　　如果action是index，那么访问的时候，不用在写index了，因为index是默认的动作（在缺省action的时候）。也就是说，如果只写了controller，那么默认的访问这个controller中的index动作。

　　

设置默认的控制器和动作

　　在config/web.php中的$config数组中增加"defaultRoute" => "hello/index"即可。

　　设置之后，缺省控制器和动作的时候，默认会访问HelloController中的actionIndex方法。

　　每一个控制器都有一个属性，这个属性是$defaultAction，默认值为index，可以通过修改这个值来修改默认action。

创建模型（model）

　　和创建控制器一样，有以下规则：

　　1、控制器是放在models/目录下的

　　2、文件名要和模型（类名）相同。

　　3、模型名默认是没有限制的，如果继承了ActiveRecord类的话，那么模型名称应尽量和数据库表名相同。

　　4、要将模型声明在app\models这个命名空间下。

　　5、声明的模型要继承yii的模型基类，使用use yii\base\Model即可。该类的位置是vendor/yiisoft/yii2/base/Model.php。

<?php
namespace app\models;

use yii\base\Model;

class Demo extends Model {
	public function showContent() {
		print_r(array(__CLASS__, __METHOD__));
	}
}

　　

在控制器中使用模型

　　首先要在控制器中导入模型，使用use关键字。

　　这里尝试在HelloController中使用上面的Demo模型。

<?php
namespace app\controllers;

use yii\web\Controller;
use app\models\Demo;   // 导入模型

class HelloController extends Controller {
	public function actionIndex()
	{
		// echo "hello yii";
		$demo = new Demo();
		$demo->showContent();
	}
}

　　访问localhost/web/index.php?r=hello/index，可以得到如下输出：

Array ( [0] => app\models\Demo [1] => app\models\Demo::showContent )

　　

创建视图

　　创建视图时，需要注意以下几点：

　　1、视图都是保存在views目录下。

　　2、对于控制器XyzController来说，在views目录下，应该有一个xyz目录，这个目录保存的就是XyzController使用的视图文件。

　　3、在视图中访问控制器传递的参数值时，直接echo数组中的$key即可

　　比如，我要为HelloController创建视图，那么我就在views目录下，创建了一个hello目录，在这个目录下创建一个index.php文件，这个文件的内容为：

<h1><?php echo $item;?></h1>

　　

控制器中加载视图

<?php
namespace app\controllers;

use yii\web\Controller;
use app\models\Demo;   // 导入模型

class HelloController extends Controller {
	public function actionIndex()
	{
		return $this->render("index", array("item" => "this is item"));
	}
}

　　访问localhost/basic/web/index.php?r=hello/index即可看到结果。

创建并使用自定义的布局文件

　　上面的运行结果也许你有点意外，因为运行之后居然外层居然有样式，这是因为加载视图的时候使用的是render方法，render方法会在加载视图的同时，也会加载一个布局文件。

　　每一个控制器都有一个属性，$layout，可以通过修改这个属性，来修改加载哪一个布局文件。

　　布局文件存放的目录是在views/layouts目录下，默认只有一个main.php，这个文件就是布局文件，可以查看其中的内容，需要注意的是，加载的视图文件在显示的时候，是被当做一个变量值输出，<?= $content ?>，$content就是包含控制器分配的数据以及视图文件。其他的内容都是属于布局。

　　布局文件是公用的，所有的控制器都可以使用。

　　现在创建一个自定义的布局文件，simple.php，放在/views/layouts目录下。

<h1>this is header</h1>
<?= $content ?>
<h1>this is footer</h1>

　　然后在HelloController加载视图之前修改默认的布局。

<?php
namespace app\controllers;

use yii\web\Controller;

class HelloController extends Controller {
	//这个布局文件，在所有的action中都有效
	public $layout = "simple";

	//定义默认的action
	public $defaultAction = "index";

	public function actionIndex()
	{
		//修改的布局文件只在这个action中有效
		$this->layout = "simple";
		return $this->render("index", array("item" => "this is content"));
	}
}

　　访问localhost/basic/web/index.php?r=hello/index，可以看到下面这个结果：

　　

不使用布局文件

　　可以使用renderPartial方法，和render方法功能类似，主要的区别就是不使用布局，即使自己指定了布局文件，也是不会使用布局的。

接收请求参数

　　接受请求可以使用request组件，需要注意的是，需要导入yii框架的核心类

<?php
namespace app\controllers;

use Yii;  //导入框架核心类
use yii\web\Controller;

class HelloController extends Controller {
	public function actionIndex()
	{
		$request = Yii::$app->request;

		// 判断请求的方法
		// if ($request->isAjax) { echo"该请求是一个 AJAX 请求"; }
		// if ($request->isGet)  { echo"请求方法是 GET"; }
		// if ($request->isPost) { echo"请求方法是 POST"; }
		// if ($request->isPut)  { echo"请求方法是 PUT"; }

		// $get = $request->get();  //等价于$_GET
		// $post = $request->post(); //等价于$_POST

		//获取指定的key值，如果没有值的话，则返回null，不会报错
		// $name = $request->post("name"); //等价于$_POST['name']
		// $age = $request->get("age");  //等价于$_GET['age']

		// 如果没有接受到参数时，使用默认参数
		// $gender = $request->get("gender", "male");
		// $addr = $request->get("addr", "BeiJing");

		// 头部信息，比如token
		$token = $request->headers->get("token");
		echo $token;
	}
}

　　request组件还有很多属性和方法，具体的可以查看：https://www.yiichina.com/doc/guide/2.0/runtime-requests

　　如果在发起post请求时，出现400错误，

　　

　　解决方案：在控制器中关闭CSRF验证：public $enableCsrfValidation = false;

响应请求

　　和请求request组件对应的响应组件response，同样需要当如Yii核心类。

<?php
namespace app\controllers;

use Yii;  //导入框架核心类
use yii\web\Controller;

class HelloController extends Controller {
	public $enableCsrfValidation = false;
	public function actionIndex()
	{
		$response = Yii::$app->response;

		// 设置状态码
		// $response->statusCode = 400;

		//设置和追加header信息
		$response->headers->set("key", "one");
		$response->headers->add("key", "two");

		// 设置响应主体的格式,yii框架会自动设置header的Content-Type
		// $response->format = \yii\web\Response::FORMAT_JSON;
		// return ["code" => 0, "msg" => "success"];

		//重定向,默认302，可设置为永久重定向301
		// return $this->redirect('https://www.so.com', 302);

		//在入口文件中自定义的常量：defined('BASEURL') or define('BASEURL', __DIR__ . '../../');
		$response->sendFile(BASEURL."/controllers/SiteController.php");
	}
}

　　

session

　　session在yii框架中也对应一个组件。

<?php
namespace app\controllers;

use Yii;  //导入框架核心类
use yii\web\Controller;

class HelloController extends Controller {
	public $enableCsrfValidation = false;
	public function actionIndex()
	{
		$session = Yii::$app->session;
		$session->open();  //开启session，等同于session_start();
		// $session->set("name", "abcdef");
		$name = $session->get("name");
		echo $name;
		$session->close(); //关闭session
		$session->destroy();
	}
}

　　

cookie

　　在yii框架中，有两种cookie:

　　1、请求中携带的cookie，使用Yii::$app->request->cookies;

　　2、服务器发给客户端的cookie，使用Yii::$app->response->cookies;

<?php
namespace app\controllers;

use Yii;  //导入框架核心类
use yii\web\Controller;
use yii\web\Cookie;  //导入yii框架的cookie类

class HelloController extends Controller {

	public $enableCsrfValidation = false;

	// 获取请求中的cookie
	public function actionGetcookie()
	{
		$request_cookies = Yii::$app->request->cookies;
		$response_cookies = Yii::$app->response->cookies;

		//获取请求中的cookie
		// 如果没有值的话，返回null
		echo $name = $request_cookies->getValue("username");
		// 如果没有设置值的话，使用默认值
		echo $age = $request_cookies->getValue("age", 30);
		echo $pwd = $request_cookies->getValue("pwd");
		if ($request_cookies->has("gender")) {
			echo $request_cookies->getValue("gender");
		}

		//修改或添加cookie，返回给客户端
		//使用yii框架的方法，实例化yii框架的cookie类作为参数。
		$response_cookies->add(new Cookie(array("name"=>"gender", "value" => "femle", "expire" => time() + 60, )));
		$response_cookies->add(new Cookie(array("name"=>"age", "value" => 30)));
		$response_cookies->add(new Cookie(array("name"=>"username", "value" => "abcd")));
		$response_cookies->add(new Cookie(array("name"=>"pwd", "value" => "123456")));
		$response_cookies->remove("pwd");
	}
}