二 05 四月 2016

Yii2笔记系列3——Hello World

上一篇笔记中简单介绍了Yii的内建功能、如何组织代码以及一般情况下应用如何处理请求，这一篇我们进入熟悉的实现一个“Hello World”的功能，为了实现这一目标，我们需要创建一个操作和一个视图：

• Yii应用会将页面请求分派给相应的action
• action将会依次渲染视图，呈现“Hello World”给最终用户

创建action

我们这里直接在controllers/SiteController.php中定义一个名为hello的action，以下是主要的代码：

<?php
namespace app\controllers;
use yii\web\Controller;
class SiteController extends Controller
{
    // ...其它代码...
    public function actionHello($message = 'Hello World')
    {
        return $this->render('hello', ['message' => $message]);
    }
}

上述的SiteController代码中，hello action被定义为名为actionHello的一个方法，这里需要说明的是，Yii使用action前缀区分普通方法和action，action前缀后面的名称被映射为action的ID。

在Yii中，当涉及到给action命名时，需要理解Yii如何处理action ID的，action ID总是被以小写处理，如果一个action ID由多个单词组成，单词之间需要由连字符连接（如create-comment）。action ID映射为方法名时除了连字符，将每个单词首字母大写，并加上action前缀，例如action ID create-comment 相当于方法名 actionCreateComment。

上述代码中的action接受一个参数 $message ，并且它的默认值是“Hello World”（跟设置PHP中其它函数或方法的默认值一样）。当应用接收到请求并确定需要由hello action来响应请求时，应用将从请求的参数中寻找对应值传入进来。换句话说，如果请求中包含一个message参数，它的值是再见，action中的 $message 变量也将会被填充为再见。

在action中，yii\web\Controller::render()被用来渲染一个名为hello的视图文件，message参数也被传入视图，这样儿就可以在里面使用了。action会返回渲染结果，结果会被应用接收并显示给最终用户的浏览器（作为整页HTML的一部分）。

创建视图

视图是用来生成响应内容的脚本，为了实现我们的“Hello World”，我们需要创建一个hello视图，以便显示从action中传来的message参数。

<?php
use yii\helpers\Html;
?>
<?= Html::encode($message) ?>

hello视图应该保存在views/site/下，当一个action中调用了yii\web\Controller::render()方法时，它将会按照views/控制器ID/视图名.php路径加载PHP文件。

另外就是以上代码中，message参数在输出之前被yii\web\Controller::render()方法处理过，当参数来自于最终用户时，参数中可能隐含的而已js代码会导致跨站脚本（XSS）攻击

完成action和视图的创建之后，你可以通过下面的URL进行访问：

http://hostname/web/index.php?r=site/hello&message=Hello+Yii

这个URL会输出包含“Hello Yii”的页面，页面和应用里的其它页面使用同样的头部和尾部。

如果省略掉URL中的message参数，则会输出包含“Hello World”的页面，因为$message的默认值是“Hello World”。

上面URL中的参数r需要重点解释一下，它代表路由，是整个应用级的，指向特定action的独立ID.路由格式是控制器ID/action ID，应用接受请求的时候会检查参数，使用控制器ID去确定哪个控制器应该被用来处理请求，然后相应控制器将使用action ID去确定哪个action将被用来做具体工作。

小结

本篇简单讲解了MVC设计模式中的控制器和视图部分，创建了一个action用于处理特定请求，然后又创建了一个用于构造响应内容。

Category: PHP Develop

Comments