Gitiles
Code Review Sign In
www.giggi.me / code-igniter-v3-giggi / 7d8a3c7a5de132cd540b637753f10333694b9420 / . / user_guide / libraries / output.html
blob: 0f474555e144a15b02e23bcdd76140b650f558d3 [file] [log] [blame]
adminb0dd10f2006-08-25 17:25:49 +0000[diff] [blame]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html>
3<head>
4
5<title>Code Igniter User Guide</title>
6
7<style type='text/css' media='all'>@import url('../userguide.css');</style>
8<link rel='stylesheet' type='text/css' media='all' href='../userguide.css' />
9
10<script type="text/javascript" src="../scripts/nav.js"></script>
11<script type="text/javascript" src="../scripts/prototype.lite.js"></script>
12<script type="text/javascript" src="../scripts/moo.fx.js"></script>
13<script type="text/javascript">
14window.onload = function() {
15 myHeight = new fx.Height('nav', {duration: 400});
16 myHeight.hide();
17}
18</script>
19
20<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
21<meta http-equiv='expires' content='-1' />
22<meta http-equiv= 'pragma' content='no-cache' />
23<meta name='robots' content='all' />
24<meta name='author' content='Rick Ellis' />
25<meta name='description' content='Code Igniter User Guide' />
26
27</head>
28<body>
29
30<!-- START NAVIGATION -->
31<div id="nav"><div id="nav_inner"><script type="text/javascript">create_menu('../');</script></div></div>
32<div id="nav2"><a name="top"></a><a href="javascript:void(0);" onclick="myHeight.toggle();"><img src="../images/nav_toggle.jpg" width="153" height="44" border="0" title="Toggle Table of Contents" alt="Toggle Table of Contents" /></a></div>
33<div id="masthead">
34<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
35<tr>
admin9fc347d2006-09-21 00:00:28 +0000[diff] [blame]36<td><h1>Code Igniter User Guide Version 1.4.1</h1></td>
adminb0dd10f2006-08-25 17:25:49 +0000[diff] [blame]37<td id="breadcrumb_right"><a href="../toc.html">Full Table of Contents</a></td>
38</tr>
39</table>
40</div>
41<!-- END NAVIGATION -->
42
43
44<!-- START BREADCRUMB -->
45<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
46<tr>
47<td id="breadcrumb">
48<a href="http://www.codeigniter.com/">Code Igniter Home</a> &nbsp;&#8250;&nbsp;
49<a href="../index.html">User Guide Home</a> &nbsp;&#8250;&nbsp;
50Output Class
51</td>
52<td id="searchbox"><form method="get" action="http://www.google.com/search"><input type="hidden" name="as_sitesearch" id="as_sitesearch" value="www.codeigniter.com/user_guide/" />Search User Guide&nbsp; <input type="text" class="input" style="width:200px;" name="q" id="q" size="31" maxlength="255" value="" />&nbsp;<input type="submit" class="submit" name="sa" value="Go" /></form></td>
53</tr>
54</table>
55<!-- END BREADCRUMB -->
56
57<br clear="all" />
58
59
60<!-- START CONTENT -->
61<div id="content">
62
63
64<h1>Output Class</h1>
65
66<p>The Output class is a small class with one main function: To send the finalized web page to the requesting browser. It is
67also responsible for <a href="../general/caching.html">caching</a> your web pages, if you use that feature.</p>
68
69<p class="important"><strong>Note:</strong> This class is initialized automatically by the system so there is no need to do it manually.</p>
70
71<p>Under normal circumstances you won't even notice the Output class since it works transparently without your intervention.
72For example, when you use the <a href="../libraries/loader.html">Loader</a> class to load a view file, it's automatically
73passed to the Output class, which will be called automatically by Code Igniter at the end of system execution.
74It is possible, however, for you to manually intervene with the output if you need to, using either of the two following functions:</p>
75
76<h2>$this->output->set_output();</h2>
77
78<p>Permits you to manually set the final output string. Usage example:<p>
79
80<code>$this->output->set_output($data);</code>
81
82<p><strong>Important:</strong> If you do set your output manually, it must be the last thing done in the function you call it from.
83For example, if you build a page in one of your controller functions, don't set the output until the end.</p>
84
85
86<h2>$this->output->get_output();</h2>
87
88<p>Permits you to manually retrieve any output that has been sent for storage in the output class. Usage example:<p>
89<code>$string = $this->output->get_output();</code>
90
91<p>Note that data will only be retrievable from this function if it has been previously sent to the output class by one of the
92Code Igniter functions like <var>$this->load->view()</var>.</p>
93
94
adminf5136322006-09-21 02:44:57 +0000[diff] [blame]95<h2>$this->output->set_header();</h2>
96
97<p>Permits you to manually set server headers, which the output class will send for you when outputting the final rendered display. Example:<p>
98
99<code>
100$this->output->set_header("HTTP/1.0 200 OK");<br />
101$this->output->set_header("HTTP/1.1 200 OK");<br />
102$this->output->set_header('Last-Modified: '.gmdate('D, d M Y H:i:s', $last_update).' GMT');<br />
103$this->output->set_header("Cache-Control: no-store, no-cache, must-revalidate");<br />
104$this->output->set_header("Cache-Control: post-check=0, pre-check=0", false);<br />
105$this->output->set_header("Pragma: no-cache"); </code>
106
adminb0dd10f2006-08-25 17:25:49 +0000[diff] [blame]107
108</div>
109<!-- END CONTENT -->
110
111
112<div id="footer">
113<p>
114Previous Topic:&nbsp;&nbsp;<a href="language.html">Language Class</a>
115&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
116<a href="#top">Top of Page</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
117<a href="../index.html">User Guide Home</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
118Next Topic:&nbsp;&nbsp;<a href="pagination.html">Pagination Class</a>
119<p>
120<p><a href="http://www.codeigniter.com">Code Igniter</a> &nbsp;&middot;&nbsp; Copyright &#169; 2006 &nbsp;&middot;&nbsp; <a href="http://www.pmachine.com">pMachine, Inc.</a></p>
121</div>
122
123</body>
124</html>