控制器

控制器是应用程序的心脏，因为它们决定如何处理 HTTP 请求。

• 什么是控制器？
• Hello World
• 方法
• 将 URI 片段传递给方法
• 定义一个默认控制器
• 重新定义方法的调用规则
• 控制数据输出
• 私有方法
• 如何将控制器放入子文件夹中
• 构造函数
• 已保留的方法名称

什么是控制器？

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

假设这个 URI:

example.com/index.php/blog/

<?php
class Blog extends CI_Controller {
 function __construct()
 {
  parent::__construct();
 }
 public function index()
 {
  echo 'Hello World！';
 }
}
?>

然后保存文件到 application/controllers/ 文件夹。

现在使用类似这样的 URL 访问你的站点：

example.com/index.php/blog/

<?php
class Blog extends CI_Controller {
}
?>

下面的blog首字母b小写，是属于无效的写法：

<?php
class blog extends CI_Controller {

}
?>

同时，始终确保你的控制器扩展自父控制器类，以便它能够继承其所有的方法。

方法

上面的例子中用到的方法名是 index()。如果 URI 的第二部分为空的话，会默认载入 “index” 方法。也可以将地址写成这样来访问 “Hello World”：

example.com/index.php/blog/index/

<?php
class Blog extends CI_Controller {

 function __construct()
 {
  parent::__construct();
 }

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

 public function comments()
 {
  echo '看这里！';
 }
}
?>

现在在地址栏中输入下面的内容来访问 comments 方法：

example.com/index.php/blog/comments/

example.com/index.php/products/shoes/sandals/123

<?php
class Products extends CI_Controller {

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

上面的方法调用时必须给两个相应的参数，要不然会出错。当然你也可以像下面这样写，就不用在调用的时候给参数了！

<?php
class Products extends CI_Controller {

    public function shoes($sandals='Test', $id=1)
    {
        echo $sandals;
        echo $id;
    }
}
?> 

注意：如果你使用 URI 路由特性，则传递到方法中的 URI 片段将被重新路由一次。

定义默认控制器

当你的网站不存在某个URI 或者 用户直接从根目录访问的时候，CodeIgniter 会加载默认控制器。打开 application/config/routes.php 文件来设置默认控制器：

$route['default_controller'] = 'Blog';

这里的 Blog 就是你希望使用的控制器的名字。如果此时你不指定任何 URI 片段来访问你的主页就会看到默认的“Hello World”信息。

重新定义方法的调用规则

如上所述，URI 的第二片段决定会调用控制器中的哪个方法。CodeIgniter 允许你使用 _remap() 方法来废除这种规则：

public function _remap()
{
    // Some code here...
}

注意：如果你的控制器中包含一个名为 _remap() 的方法，那么不管你的 URI 中包含什么，它总会被忽略掉。这个方法会废除掉由 URI 片段来决定哪个方法被调用的规则，允许你重新定义调用方法的规则（方法的路由规则）。

被重新定义的方法调用方式（一般是 URI 中的第二片段）将作为一个参数传递给 _remap() ：

public function _remap($method)
{
    if ($method == 'some_method')
    {
        $this->$method();
    }
    else
    {
        $this->comments();
    }
}

public function _remap($method, $params = array())
{
    $method = 'process_'.$method;
    if (method_exists($this, $method))
    {
        return call_user_func_array(array($this, $method), $params);
    }
    show_404();
}

public function _output($output)
{
    echo $output;
}

if ($this->output->cache_expiration > 0)
{
    $this->output->_write_cache($output);
  }

private function _utility()
{
  // some code
}

那么，通过下面这样的 URL 进行访问是无法访问到的：

example.com/index.php/blog/_utility/

application/controllers/products/shoes.php

调用这个控制器的时候你的 URI 要这么写：

example.com/index.php/products/shoes/show/123

parent::__construct();

这行代码的必要性在于，你此处的构造函数会覆盖掉这个父控制器类中的构造函数，所以我们要手动调用它。

<?phpclass Blog extends CI_Controller {       public function construct()       {            parent::construct();       }}?>

已保留的方法名称

因为你添加的控制器类继承了主要的应用程序控制器，所以你要小心你的方法名不要和那个类中的方法名一样了，否则你的方法会覆盖原有的。详细信息请查看保留字部分。

就这样了！

OK，总的来说，这就是关于控制器的所有内容了。

翻译贡献者:34333432, alsove, ashmodeus, bin_live, crazyant_ps2, dawenxi123, hewenxiang, Hex, irini, liuyanghejerry, li_star, longjianghu, lp_ci, vvchuanqi, zhangqianxun