# CodeIgniter 用户指南 版本 2.2.0

编辑文档、查看近期更改请 登录 或 注册 找回密码

搜索用户指南

查看原文

# 输出类

输出类是只有一个主要功能的简单的类: 发送最终的Web页面到所请求的浏览器。如果您开启缓存功能，他还负责缓存您的网页文件。

输出类虽然很简单，但是它实现的功能却很重要咯: 输出最后的执行结果给发送请示的浏览器. 如果你选择了使用缓存 ，这块也归它管.

注意：输出类的初始化操作是由系统自动完成的，基本上不用你操心.

在一般的情况下你是感觉不到它的存在的（也用不着去关心），对于你来说它就是透明的，不用去干预，它就能正常的工作. 比如说, 你使用装载器类加载了一个视图文件, 这个视图文件的内容会自动传递给输出类对象, 然后呢，在方法执行完毕后会自动调用输出类对象将执行的结果输出. 但是呢，实际开发的过程当中会遇见一些特殊的情况需要我们干预输出，接管输出的控制权(像是客户要求将数据导出成Excel，提供下载)，这种时候，下面的这些个方法就用啦:

## $this->output->set_output();

告诉CodeIgniter方法执行完毕后，用给定的数据做为输出。例如：

`$this->output->set_output($data);`

重要：使用这个方法有一点很重要，就要将它放在最后一句，千万要注意啊，到时候出了错，不要怪我没提醒你.

## $this->output->set_content_type();

允许你设置页面的mime类型以便于输出 JSON , JPEG, XML 等类型的数据.

`$this->output
->set_content_type('application/json')
->set_output(json_encode(array('foo' => 'bar')));
$this->output
->set_content_type('jpeg') // 你也可以用".jpeg"，它在查找 config/mimes.php 文件之前会移除句号
->set_output(file_get_contents('files/something.jpg'));`

重要: 确保你传递到此方法的非mime字符串在 config/mimes.php 存在，否则设置不起作用。

## $this->output->get_output();

使用这个方法，你可以得到将要输出的数据，并把它保存起来，留着它用（我们做新闻类型网站的时候，常常需要生成静态的HTML文件）. 例如：

`$string = $this->output->get_output();`

注意，如果先前的数据已经被一个类似 $this->load->view() 的 CodeIgniter 函数送到了输出类，那么只能取得那个函数之后的输出。

## $this->output->append_output();

在输出字符串后附加数据。例如：

`$this->output->append_output($data);`

## $this->output->set_header();

使用此方法，允许你设置将会被发送到浏览器的HTTP协议的标头，作用相当于php的标准函数: header()。例如：

`$this->output->set_header("HTTP/1.0 200 OK");
$this->output->set_header("HTTP/1.1 200 OK");
$this->output->set_header('Last-Modified: '.gmdate('D, d M Y H:i:s', $last_update).' GMT');
$this->output->set_header("Cache-Control: no-store, no-cache, must-revalidate");
$this->output->set_header("Cache-Control: post-check=0, pre-check=0");
$this->output->set_header("Pragma: no-cache");`

## $this->output->set_status_header(code, 'text');

允许你手动设置服务器状态头(header)。例如：

`$this->output->set_status_header('401');
// 将header设置为: Unauthorized`

单击这里查看全部的 header 列表。

## $this->output->enable_profiler();

允许你开启或禁用评测器，评测器将在页的底部显示测试基准点或调试、优化需要的其他数据。

在控制器函数的任何位置放置以下函数，可以开启评测器：

`$this->output->enable_profiler(TRUE);`

当开启评测器功能，会在您的页面底部生成一个报告。

你可以用以下语句禁用评测器：

`$this->output->enable_profiler(FALSE);`

## $this->output->set_profiler_sections();

允许你在评测器启用时控制(开/关)其特定部分。请参考评测器了解详细信息。

## $this->output->cache();

CodeIgniter的输出类同样也控制缓存。要获取更多信息，请阅读 缓存文档.

## Parsing Execution Variables

默认情况下，CodeIgniter总会在输出中解析伪变量{elapsed_time}和{memory_usage}。 如需禁用，在控制器中将类属性$parse_exec_vars设为FALSE。 `$this->output->parse_exec_vars = FALSE;`

译者注：此处存在源码级错误，直接应用此代码会报错“Fatal error: Cannot access protected property CI_Output::$parse_exec_vars ”。建议用以下代码： `public $parse_exec_vars = TRUE;` 替换掉源文件systerm/core/Output.php第86行（CI版本2.1.3）的此句代码： `protected $parse_exec_vars = TRUE;`

翻译贡献者: billycui, crazyfriday, csfhc, Glen, Hex, hk_yuhe, lishen2, Raidal, xwjie, yinzhili
最后修改: 2013-11-22 20:12:23