控制器¶

什么是控制器？¶

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

考虑下面的 URI:

example.com/index.php/blog/

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

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

让我们试试看：Hello World！¶

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

<?php
class Blog extends CI_Controller {

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

然后将文件保存到 application/controllers/ 目录下。

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

example.com/index.php/blog/

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

Hello World!

这是有效的:

<?php
class Blog extends CI_Controller {

}

这是无效的:

<?php
class blog extends CI_Controller {

}

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

方法¶

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

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

URI 中的第二段用于决定调用控制器中的哪个方法。

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

<?php
class Blog extends CI_Controller {

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

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

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

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

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

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

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

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

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

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

<?php
class Products extends CI_Controller {

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

定义默认控制器¶

CodeIgniter 可以设置一个默认的控制器，当 URI 没有分段参数时加载，例如当用户直接访问你网站的首页时。 打开 application/config/routes.php 文件，通过下面的参数指定一个默认的控制器:

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

其中，“Blog”是你想加载的控制器类名，如果你现在通过不带任何参数的 index.php 访问你的站点，你将看到你的“Hello World”消息。

For more information, please refer to the "Reserved Routes" section of the URI 路由 documentation.

重映射方法¶

正如上文所说，URI 的第二段通常决定控制器的哪个方法被调用。CodeIgniter 允许你使用 _remap() 方法来重写该规则:

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

被重写的方法（通常是 URI 的第二段）将被作为参数传递到 _remap() 方法:

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

方法名之后的所有其他段将作为 _remap() 方法的第二个参数，它是可选的。这个参数可以使用 PHP 的 call_user_func_array() 函数来模拟 CodeIgniter 的默认行为。

例如:

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();
}

处理输出¶

CodeIgniter 有一个输出类，它可以自动的将最终数据发送到你的浏览器。 更多信息可以阅读 视图 和 输出类 页面。但是，有时候， 你可能希望对最终的数据进行某种方式的后处理，然后你自己手工发送到浏览器。CodeIgniter 允许你向你的控制器中添加一个 _output() 方法，该方法可以接受最终的输出数据。

这里是个例子:

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

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

私有方法¶

有时候你可能希望某些方法不能被公开访问，要实现这点，只要简单的将方法声明为 private 或 protected ， 这样这个方法就不能被 URL 访问到了。例如，如果你有一个下面这个方法:

private function _utility()
{
    // some code
}

使用下面的 URL 尝试访问它，你会发现是无法访问的:

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

将控制器放入子目录中¶

如果你正在构建一个比较大的应用，那么将控制器放到子目录下进行组织可能会方便一点。CodeIgniter 也可以实现这一点。

你只需要简单的在 application/controllers/ 目录下创建新的目录，并将控制器文件放到子目录下。

application/controllers/products/Shoes.php

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

Each of your sub-directories may contain a default controller which will be called if the URL contains only the sub-directory. Simply put a controller in there that matches the name of your 'default_controller' as specified in your application/config/routes.php file.

你也可以使用 CodeIgniter 的 URI 路由 功能来重定向 URI 。

构造函数¶

如果你打算在你的控制器中使用构造函数，你 必须 将下面这行代码放在里面:

parent::__construct();

原因是你的构造函数将会覆盖父类的构造函数，所以我们要手工的调用它。

例如:

<?php
class Blog extends CI_Controller {

    public function __construct()
    {
        parent::__construct();
        // Your own constructor code
    }
}

如果你需要在你的类被初始化时设置一些默认值，或者进行一些默认处理，构造函数将很有用。 构造函数没有返回值，但是可以执行一些默认操作。

保留方法名¶

因为你的控制器将继承主程序的控制器，在新建方法时你必须要小心不要使用和父类一样的方法名， 要不然你的方法将覆盖它们，参见 保留名称 。

就这样了！¶

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