PHP的Yii框架中创建视图和渲染视图的方法详解

视图是 mvc 模式中的一部分。 它是展示数据到终端用户的代码，在网页应用中，根据视图模板来创建视图，视图模板为php脚本文件， 主要包含html代码和展示类php代码，通过yii\web\view应用组件来管理， 该组件主要提供通用方法帮助视图构造和渲染，简单起见，我们称视图模板或视图模板文件为视图。

创建视图

如前所述，视图为包含html和php代码的php脚本，如下代码为一个登录表单的视图， 可看到php代码用来生成动态内容如页面标题和表单，html代码把它组织成一个漂亮的html页面。

<?php
use yii\helpers\html;
use yii\widgets\activeform;

/* @var $this yii\web\view */
/* @var $form yii\widgets\activeform */
/* @var $model app\models\loginform */

$this->title = 'login';
?>
<h1><?= html::encode($this->title) ?></h1>

<p>please fill out the following fields to login:</p>

<?php $form = activeform::begin(); ?>
  <?= $form->field($model, 'username') ?>
  <?= $form->field($model, 'password')->passwordinput() ?>
  <?= html::submitbutton('login') ?>
<?php activeform::end(); ?>

在视图中，可访问 $this 指向 yii\web\view 来管理和渲染这个视图文件。

除了 $this之外，上述示例中的视图有其他预定义变量如 $model， 这些变量代表从控制器或其他触发视图渲染的对象 传入 到视图的数据。

技巧: 将预定义变量列到视图文件头部注释处，这样可被ide编辑器识别，也是生成视图文档的好方法。
安全

当创建生成html页面的视图时，在显示之前将用户输入数据进行转码和过滤非常重要， 否则，你的应用可能会被跨站脚本 攻击。

要显示纯文本，先调用 yii\helpers\html::encode() 进行转码，例如如下代码将用户名在显示前先转码：

<?php
use yii\helpers\html;
?>

<div class="username">
  <?= html::encode($user->name) ?>
</div>

要显示html内容，先调用 yii\helpers\htmlpurifier 过滤内容，例如如下代码将提交内容在显示前先过滤：

<?php
use yii\helpers\htmlpurifier;
?>

<div class="post">
  <?= htmlpurifier::process($post->text) ?>
</div>

技巧：htmlpurifier在保证输出数据安全上做的不错，但性能不佳，如果你的应用需要高性能可考虑 缓存 过滤后的结果。

组织视图

与 控制器 和 模型 类似，在组织视图上有一些约定：

控制器渲染的视图文件默认放在 @app/views/controllerid 目录下， 其中 controllerid 对应 控制器 id, 例如控制器类为postcontroller，视图文件目录应为 @app/views/post， 控制器类 postcommentcontroller对应的目录为@app/views/post-comment， 如果是模块中的控制器，目录应为 yii\base\module::basepath 模块目录下的views/controllerid 目录；
对于 小部件 渲染的视图文件默认放在 widgetpath/views 目录， 其中 widgetpath 代表小部件类文件所在的目录；
对于其他对象渲染的视图文件，建议遵循和小部件相似的规则。
可覆盖控制器或小部件的 yii\base\viewcontextinterface::getviewpath() 方法来自定义视图文件默认目录。

渲染视图

可在 控制器, 小部件, 或其他地方调用渲染视图方法来渲染视图， 该方法类似以下格式：

/**
 * @param string $view 视图名或文件路径，由实际的渲染方法决定
 * @param array $params 传递给视图的数据
 * @return string 渲染结果
 */
methodname($view, $params = [])

控制器中渲染

在 控制器 中，可调用以下控制器方法来渲染视图：

• yii\base\controller::render(): 渲染一个 视图名 并使用一个 布局 返回到渲染结果。
• yii\base\controller::renderpartial(): 渲染一个 视图名 并且不使用布局。
• yii\web\controller::renderajax(): 渲染一个 视图名 并且不使用布局， 并注入所有注册的js/css脚本和文件，通常使用在响应ajax网页请求的情况下。
• yii\base\controller::renderfile(): 渲染一个视图文件目录或别名下的视图文件。

例如：

namespace app\controllers;

use yii;
use app\models\post;
use yii\web\controller;
use yii\web\notfoundhttpexception;

class postcontroller extends controller
{
  public function actionview($id)
  {
    $model = post::findone($id);
    if ($model === null) {
      throw new notfoundhttpexception;
    }

    // 渲染一个名称为"view"的视图并使用布局
    return $this->render('view', [
      'model' => $model,
    ]);
  }
}

小物件
小物件是 cwidget 或其子类的实例.它是一个主要用于表现数据的组件.小物件通常内嵌于一个视图来产生一些复杂而独立的用户界面.例如,一个日历小物件可用于渲染一个复杂的日历界面.小物件使用户界面更加可复用.

我们可以按如下视图脚本来使用一个小物件:

<?php $this->beginwidget('path.to.widgetclass'); ?>
...可能会由小物件获取的内容主体...
<?php $this->endwidget(); ?>

或者

<?php $this->widget('path.to.widgetclass'); ?>

后者用于不需要任何 body 内容的组件.

小物件可通过配置来定制它的表现.这是通过调用 cbasecontroller::beginwidget 或 cbasecontroller::widget 设置其初始化属性值来完成的.例如,当使用 cmaskedtextfield 小物件时,我们想指定被使用的 mask （可理解为一种输出格式，译者注）.我们通过传递一个携带这些属性初始化值的数组来实现.这里的数组的键是属性的名称,而数组的值则是小物件属性所对应的值.正如以下所示 :

<?php
$this->widget('cmaskedtextfield',array(
  'mask'=>'99/99/9999'
));
?>

继承 cwidget 并覆盖其init() 和 run() 方法,可以定义一个新的小物件:

class mywidget extends cwidget
{
  public function init()
  {
    // 此方法会被 ccontroller::beginwidget() 调用
  }
 
  public function run()
  {
    // 此方法会被 ccontroller::endwidget() 调用
  }
}

小物件可以像一个控制器一样拥有它自己的视图.默认情况下,小物件的视图文件位于包含了小物件类文件目录的 views 子目录之下.这些视图可以通过调用 cwidget::render() 渲染,这一点和控制器很相似.唯一不同的是,小物件的视图没有布局文件支持。另外，小物件视图中的$this指向小物件实例而不是控制器实例。

视图中渲染

可以在视图中渲染另一个视图，可以调用yii\base\view视图组件提供的以下方法：

• yii\base\view::render(): 渲染一个 视图名.
• yii\web\view::renderajax(): 渲染一个 视图名 并注入所有注册的js/css脚本和文件，通常使用在响应ajax网页请求的情况下。
• yii\base\view::renderfile(): 渲染一个视图文件目录或别名下的视图文件。

例如，视图中的如下代码会渲染该视图所在目录下的 _overview.php 视图文件， 记住视图中 $this 对应 yii\base\view 组件:

<?= $this->render('_overview') ?>

其他地方渲染

在任何地方都可以通过表达式 yii::$app->view 访问 yii\base\view 应用组件， 调用它的如前所述的方法渲染视图，例如：

// 显示视图文件 "@app/views/site/license.php"
echo \yii::$app->view->renderfile('@app/views/site/license.php');