Controller

控制器

什么是控制器？

简而言之，一个控制器就是一个类文件，是以一种能够和 URI 关联在一起的方式来命名的。

考虑下面的 URI:

http://example.com/Blog/

上例中，KotoriFramework 将会尝试查询一个名为 BlogController.php 的控制器并加载它。

当控制器的名称和 URI 的第一段匹配上时，它将会被加载。

让我们试试看：Hello World！

接下来你会看到如何创建一个简单的控制器，打开你的文本编辑器，新建一个文件 Blog.php ， 然后放入以下代码:

class BlogController extends Kotori_Controller {

    public function index()
    {
        echo 'Hello World!';
    }
}

然后将文件保存到 App/Controller 目录下。

现在使用类似下面的 URL 来访问你的站点:

http://example.com/Blog/

如果一切正常，你将看到：

Hello World!

另外，一定要确保你的控制器继承了父控制器类，这样它才能使用父类的方法。

方法 上例中，方法名为 index() 。"index" 方法总是在 URI 的 第二段 为空时被调用。 另一种显示 "Hello World" 消息的方法是:

example.com/index.php/blog/index/ URI 中的第二段用于决定调用控制器中的哪个方法。

让我们试一下，向你的控制器添加一个新的方法:

class BlogController extends Kotori_Controller {

    public function index()
    {
        echo 'Hello World!';
    }

    public function comments()
    {
        echo 'Look at this!';
    }
}

现在，通过下面的 URL 来调用 comments 方法:

http://example.com/Blog/comments/

你应该能看到你的新消息了。

通过 URI 分段向你的方法传递参数

如果你的 URI 多于两个段，多余的段将作为参数传递到你的方法中。

例如，假设你的 URI 是这样:

http://example.com/Products/shoes/sandals/123

你的方法将会收到第三段和第四段两个参数（"sandals" 和 "123"）:

class ProductsController extends Kotori_Controller {

    public function shoes($sandals, $id)
    {
        echo $sandals;
        echo $id;
    }
}

重要 如果你使用了 URI 路由 ，传递到你的方法的参数将是路由后的参数。

Url生成

为了配合URL格式，我们需要能够动态的根据当前的URL设置生成对应的URL地址，为此，内置提供了url方法，用于URL的动态生成，可以确保项目在移植过程中不受环境的影响。

推荐在任何时候都使用这种方法来生成你的 URL ，这样在你的 URL 变动时你的代码将具有可移植性。

传给函数的 URI 段参数可以是一个字符串，也可以是个数组，下面是字符串的例子:

$this->route->url('News/local/123');

上例将返回类似于：

http://example.com/News/local/123

下面是使用数组的例子:

echo $this->route->url(array('news', 'local', '123'));

AJAX返回

用于返回JSON格式的数据。

调用示例：

$array['name'] = 'MahuaTeng';
$array['length'] = 1;
$this->response->throwJson($array);

跳转

301/302跳转到某页面

调用示例：

$this->response->redirect('http://www.qq.com',true);//跳转到马化腾首页
//根据第二个参数来判断是301还是302跳转

接受安全的变量

在Web开发过程中，我们经常需要获取系统变量或者用户提交的数据，这些变量数据错综复杂，而且一不小心就容易引起安全隐患，但是如果利用好框架P提供的变量获取功能，就可以轻松的获取和驾驭变量了。

示例：

    $id    =  $this->request->input('get.id'); // 获取get变量
    $name  =  $this->request->input('post.name');  // 获取post变量
    $value =  $this->request->input('session.var'); // 获取session变量
    $name  =  $this->request->input('cookie.name'); //获取cookie变量
    $file  =  $this->request->input('server.PHP_SELF'); // 获取server变量
    $get   =  $this->request->input('get.') //获取$_GET数组

控制器间相互调用

不建议采用这种方式，因为这不符合MVC规范。

比如BlogController中：

   public function show()
   {
       echo 'test';
   }

接下来我们在IndexController中调用它：

   public function index()
   {
       $this->route->controller('Blog')->show();
   }

错误页面

当你的系统发生错误时，将输出错误页面。 如果你打开了APP_DEBUG模式，将在视图右下角现实Trace信息，方便进行错误、SQL调试。