输出类
输出类是只有一个主要功能的简单的类: 发送最终的Web页面到所请求的浏览器。如果您开启缓存功能,他还负责缓存您的网页文件。
输出类虽然很简单,但是它实现的功能却很重要咯: 输出最后的执行结果给发送请示的浏览器. 如果你选择了使用缓存 ,这块也归它管.
注意:输出类的初始化操作是由系统自动完成的,基本上不用你操心.
在一般的情况下你是感觉不到它的存在的(也用不着去关心),对于你来说它就是透明的,不用去干预,它就能正常的工作.比如说, 你使用装载器类加载了一个视图文件, 这个视图文件的内容会自动传递给输出类对象, 然后呢,在方法执行完毕后会自动调用输出类对象将执行的结果输出.但是呢,实际开发的过程当中会遇见一些特殊的情况需要我们干预输出,接管输出的控制权(像是客户要求将数据导出成Excel,提供下载),这种时候,下面的这些个方法就有用啦:
$this->output->set_output();
告诉CodeIgniter方法执行完毕后,用给定的数据作为输出。例如:
**重要:**使用这个方法有一点很重要,就要将它放在最后一句,千万要注意啊,到时候出了错,不要怪我没提醒你. ## $this->output->set_content_type(); 允许你设置页面的mime类型以便于输出 JSON , JPEG, XML 等类型的数据.
$this->output->set_output($data);
**重要:** 确保你传递到此方法的非mime字符串在 config/mimes.php 存在,否则设置不起作用。 ## $this->output->get_output(); 使用这个方法,你可以得到将要输出的数据,并把它保存起来,留着它用(我们做新闻类型网站的时候,常常需要生成静态的HTML文件). 例如:
$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'));
注意,如果先前的数据已经被一个类似 _$this->load->view()_ 的 CodeIgniter 函数送到了输出类,那么只能取得那个函数之后的输出。 ## $this->output->append_output(); 在输出字符串后附加数据。例如:
$string = $this->output->get_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)。例如:
[单击这里](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html)查看全部的 header 列表。 ## $this->output->enable_profiler(); 允许你开启或禁用[评测器]($d71766903305fd06.md),评测器将在页的底部显示测试基准点或调试、优化需要的其他数据。 在[控制器]($e261bd24f4db608d.md)函数的任何位置放置以下函数,可以开启评测器:
$this->output->set_status_header('401');
// 将header设置为: Unauthorized
当开启评测器功能,会在您的页面底部生成一个报告。 你可以用以下语句禁用评测器:
$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 ”。建议用以下代码:
替换掉源文件systerm/core/Output.php第86行(CI版本2.1.3)的此句代码:
public $parse_exec_vars = TRUE;
protected $parse_exec_vars = TRUE;
翻译贡献者:billycui, crazyfriday, csfhc, Glen, Hex, hk_yuhe, Jacklee, lishen2, Raidal, xwjie, yinzhili