PageRenderTime 49ms CodeModel.GetById 21ms RepoModel.GetById 0ms app.codeStats 1ms

/php/function.ob-start.html

https://bitbucket.org/thncr/manuals
HTML | 236 lines | 197 code | 39 blank | 0 comment | 0 complexity | c9ffdb323dfde2e00278203771fe6f03 MD5 | raw file
    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    2. 

  2. <html>
    3. 

  3.  <head>
    4. 

  4.   <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    5. 

  5.   <title>打开输出控制缓冲</title>
    6. 

  6. 

  7.  </head>
    8. 

  8.  <body><div class="manualnavbar" style="text-align: center;">
    9. 

  9.  <div class="prev" style="text-align: left; float: left;"><a href="function.ob-list-handlers.html">ob_list_handlers</a></div>
    10. 

  10.  <div class="next" style="text-align: right; float: right;"><a href="function.output-add-rewrite-var.html">output_add_rewrite_var</a></div>
    11. 

  11.  <div class="up"><a href="ref.outcontrol.html">Output Control 函数</a></div>
    12. 

  12.  <div class="home"><a href="index.html">PHP Manual</a></div>
    13. 

  13. </div><hr /><div id="function.ob-start" class="refentry">
    14. 

  14.  <div class="refnamediv">
    15. 

  15.   <h1 class="refname">ob_start</h1>
    16. 

  16.   <p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">ob_start</span> &mdash; <span class="dc-title">打开输出控制缓冲</span></p>
    17. 

  17. 

  18.  </div>
    19. 

  19.  
    20. 

  20.  <div class="refsect1 description" id="refsect1-function.ob-start-description">
    21. 

  21.   <h3 class="title">说明</h3>
    22. 

  22.   <div class="methodsynopsis dc-description">
    23. 

  23.    <span class="type">bool</span> <span class="methodname"><strong>ob_start</strong></span>
    24. 

  24.     ([ <span class="methodparam"><span class="type"><a href="language.pseudo-types.html#language.types.callback" class="type callback">callback</a></span> <code class="parameter">$output_callback</code></span>
    25. 

  25.    [, <span class="methodparam"><span class="type">int</span> <code class="parameter">$chunk_size</code></span>
    26. 

  26.    [, <span class="methodparam"><span class="type">bool</span> <code class="parameter">$erase</code></span>
    27. 

  27.   ]]] )</div>
    28. 

  28. 

  29.   <p class="para rdfs-comment">
    30. 

  30.    此函数将打开输出缓冲。当输出缓冲是活跃的时候，没有输出能从脚本送出（除http标头外），相反输   出的内容被存储在内部缓冲区中。
    31. 

  31.   </p>
    32. 

  32.   <p class="para">
    33. 

  33.     内部缓冲区的内容可以用  <span class="function"><a href="function.ob-get-contents.html" class="function">ob_get_contents()</a></span> 函数复制到一个字符串变量中。
    34. 

  34.     想要输出存储在内部缓冲区中的内容，可以使用  <span class="function"><a href="function.ob-end-flush.html" class="function">ob_end_flush()</a></span> 函数。另外，
    35. 

  35.     使用 <span class="function"><a href="function.ob-end-clean.html" class="function">ob_end_clean()</a></span> 函数会静默丢弃掉缓冲区的内容。
    36. 

  36.   </p>
    37. 

  37.   <div class="warning"><strong class="warning">Warning</strong>
    38. 

  38.    <p class="para">
    39. 

  39.     当有正在调用的回调函数时，一些网络服务器（例如Apache）会改变一个脚本的工作目录。
    40. 

  40.     你可以通过例如<em>chdir(dirname($_SERVER[&#039;SCRIPT_FILENAME&#039;]))</em> 
    41. 

  41.     在回调函数中再把它改回来。
    42. 

  42.    </p>
    43. 

  43.   </div>
    44. 

  44.   <p class="para">
    45. 

  45.    输出缓冲区是可堆叠的，这即意谓着，当有一个 <span class="function"><strong>ob_start()</strong></span> 是活跃的时，
    46. 

  46.    你可以调用另一个  <span class="function"><strong>ob_start()</strong></span> 。
    47. 

  47.    只要确保又正确调用了  <span class="function"><a href="function.ob-end-flush.html" class="function">ob_end_flush()</a></span> 恰当的次数即可。
    48. 

  48.    如果有多重输出回调函数是活跃的，输出内容会一直按嵌套的顺序依次通过它们而被过滤。
    49. 

  49.   </p>
    50. 

  50.  </div>
    51. 

  51. 

  52. 

  53.  <div class="refsect1 parameters" id="refsect1-function.ob-start-parameters">
    54. 

  54.   <h3 class="title">参数</h3>
    55. 

  55.   <p class="para">
    56. 

  56.    <dl>
    57. 

  57. 

  58.     <dt>
    59. 

  59. 

  60.      <span class="term"><em><code class="parameter">output_callback</code></em></span>
    61. 

  61.      <dd>
    62. 

  62. 

  63.       <p class="para">
    64. 

  64.        可选参数 <em><code class="parameter">output_callback</code></em> 函数可以被指定。 
    65. 

  65.        此函数把一个字符串当作参数并返回一个字符串。
    66. 

  66.        此函数在下情况会被调用到：输出缓冲区被(  <span class="function"><a href="function.ob-flush.html" class="function">ob_flush()</a></span>,  <span class="function"><a href="function.ob-clean.html" class="function">ob_clean()</a></span> 或者相似的函数)冲刷（送出）或者被清洗的时候；或者在请求结束之际输出缓冲区内容被冲刷到浏览器时。 
    67. 

  67.        当 <em><code class="parameter">output_callback</code></em> 被调用时，它将收到输出缓冲区的内容作为参数
    68. 

  68.        并预期返回一个新的输出缓冲区作为结果，这个新返回的输出缓冲区内容将被送到浏览器。
    69. 

  69.        如果这个 <em><code class="parameter">output_callback</code></em> 不是一个可以调用的函数，此函数
    70. 

  70.        会返回 <strong><code>FALSE</code></strong> 。
    71. 

  71.       </p>
    72. 

  72.       <p class="para">
    73. 

  73.        如果回调函数有两个参数，第二个参数会由一个位域补充，该位域由
    74. 

  74.        <strong><code>PHP_OUTPUT_HANDLER_START</code></strong>,
    75. 

  75.        <strong><code>PHP_OUTPUT_HANDLER_CONT</code></strong> 和
    76. 

  76.        <strong><code>PHP_OUTPUT_HANDLER_END</code></strong> 组成。
    77. 

  77.       </p>
    78. 

  78.       <p class="para">
    79. 

  79.        如果 <em><code class="parameter">output_callback</code></em> 返回 <strong><code>FALSE</code></strong> ，其原来的输入
    80. 

  80.        内容被直接送到浏览器。
    81. 

  81.       </p>
    82. 

  82.       <p class="para">
    83. 

  83.        这个参数 <em><code class="parameter">output_callback</code></em> 可以通过直接给一个 <strong><code>NULL</code></strong> 
    84. 

  84.        值而避开。
    85. 

  85.       </p>
    86. 

  86.       <p class="para">
    87. 

  87.         <span class="function"><a href="function.ob-end-clean.html" class="function">ob_end_clean()</a></span>,  <span class="function"><a href="function.ob-end-flush.html" class="function">ob_end_flush()</a></span>,
    88. 

  88.         <span class="function"><a href="function.ob-clean.html" class="function">ob_clean()</a></span>,  <span class="function"><a href="function.ob-flush.html" class="function">ob_flush()</a></span> and
    89. 

  89.         <span class="function"><strong>ob_start()</strong></span> 不能从一个回调函数中调用。
    90. 

  90.        如果从回调函数中调用了它们，产生的行为是不明确的。
    91. 

  91.        如果想要删除缓冲区的内容，从回调函数中返回一个&quot;&quot; (空字符串)。
    92. 

  92.        更不能从一个回调函数中使用像<em>print_r($expression, true)</em> 
    93. 

  93.        或<em>highlight_file($filename, true)</em> 一样的输出缓冲函数。   
    94. 

  94.       </p>
    95. 

  95.       <blockquote class="note"><p><strong class="note">Note</strong>: 
    96. 

  96.        <p class="para">
    97. 

  97.         在PHP 4.0.4中，  <span class="function"><a href="function.ob-gzhandler.html" class="function">ob_gzhandler()</a></span> 被引入是为了简化把gz编码过 
    98. 

  98.         数据发送到支持压缩网页的浏览器。
    99. 

  99.          <span class="function"><a href="function.ob-gzhandler.html" class="function">ob_gzhandler()</a></span> 会判定浏览器可以接受哪种类型的编码内容，并返回相应
    100. 

  100.         的输出。
    101. 

  101.        </p>
    102. 

  102.       </p></blockquote>
    103. 

  103.      </dd>
    104. 

  104. 

  105.     </dt>
    106. 

  106. 

  107.     <dt>
    108. 

  108. 

  109.      <span class="term"><em><code class="parameter">chunk_size</code></em></span>
    110. 

  110.      <dd>
    111. 

  111. 

  112.       <p class="para">
    113. 

  113.        如果可选参数 <em><code class="parameter">chunk_size</code></em> 被赋值了，在任何一个能引起缓冲区的长度等于
    114. 

  114.        或超过 <em><code class="parameter">chunk_size</code></em> 的输出操作后，缓冲区都会被刷送。
    115. 

  115.        默认值 0 意味着函数仅在最后被调用，其余的特殊值可以将 <em><code class="parameter">chunk_size</code></em>
    116. 

  116.        从 1 设定到 4096。
    117. 

  117.       </p>
    118. 

  118.      </dd>
    119. 

  119. 

  120.     </dt>
    121. 

  121. 

  122.     <dt>
    123. 

  123. 

  124.      <span class="term"><em><code class="parameter">erase</code></em></span>
    125. 

  125.      <dd>
    126. 

  126. 

  127.       <p class="para">
    128. 

  128.        如果可选参数 <em><code class="parameter">erase</code></em> 被赋成 <strong><code>FALSE</code></strong>，直到脚本执行完成缓冲区才被删除。
    129. 

  129.        这使得，如果调用了冲刷和清洗（清除）函数，会抛出一个“notice”,并返回 <strong><code>FALSE</code></strong> 值。
    130. 

  130.       </p>
    131. 

  131.      </dd>
    132. 

  132. 

  133.     </dt>
    134. 

  134. 

  135.    </dl>
    136. 

  136. 

  137.   </p>
    138. 

  138.  </div>
    139. 

  139. 

  140. 

  141.  <div class="refsect1 returnvalues" id="refsect1-function.ob-start-returnvalues">
    142. 

  142.   <h3 class="title">返回值</h3>
    143. 

  143.   <p class="para">
    144. 

  144.    成功时返回 <strong><code>TRUE</code></strong>， 或者在失败时返回 <strong><code>FALSE</code></strong>.
    145. 

  145.   </p>
    146. 

  146.  </div>
    147. 

  147. 

  148. 

  149.  <div class="refsect1 changelog" id="refsect1-function.ob-start-changelog">
    150. 

  150.   <h3 class="title">更新日志</h3>
    151. 

  151.   <p class="para">
    152. 

  152.    <table class="doctable informaltable">
    153. 

  153.     
    154. 

  154.      <thead>
    155. 

  155.       <tr>
    156. 

  156.        <th>版本</th>
    157. 

  157.        <th>说明</th>
    158. 

  158.       </tr>
    159. 

  159. 

  160.      </thead>
    161. 

  161. 

  162.      <tbody class="tbody">
    163. 

  163.       
    164. 

  164.       <tr>
    165. 

  165.        <td>4.3.2</td>
    166. 

  166.        <td>
    167. 

  167.         在传递的 <em><code class="parameter">output_callback</code></em> 不能被执行时，此函数
    168. 

  168.         被改成返回 <strong><code>FALSE</code></strong> 
    169. 

  169.        </td>
    170. 

  170.       </tr>
    171. 

  171. 

  172.       <tr>
    173. 

  173.        <td>4.2.0</td>
    174. 

  174.        <td>
    175. 

  175.         添加了 <em><code class="parameter">erase</code></em> 参数。
    176. 

  176.        </td>
    177. 

  177.       </tr>
    178. 

  178. 

  179.      </tbody>
    180. 

  180.     
    181. 

  181.    </table>
    182. 

  182. 

  183.   </p>
    184. 

  184.  </div>
    185. 

  185. 

  186. 

  187.  <div class="refsect1 examples" id="refsect1-function.ob-start-examples">
    188. 

  188.   <h3 class="title">范例</h3>
    189. 

  189.   <p class="para">
    190. 

  190.    <div class="example" id="example-428">
    191. 

  191.     <p><strong>Example #1 用户自定义回调函数的例子</strong></p>
    192. 

  192.     <div class="example-contents">
    193. 

  193. <div class="phpcode"><code><span style="color: #000000">
    194. 

  194. <span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">function&nbsp;</span><span style="color: #0000BB">callback</span><span style="color: #007700">(</span><span style="color: #0000BB">$buffer</span><span style="color: #007700">)<br />{<br />&nbsp;&nbsp;</span><span style="color: #FF8000">//&nbsp;replace&nbsp;all&nbsp;the&nbsp;apples&nbsp;with&nbsp;oranges<br />&nbsp;&nbsp;</span><span style="color: #007700">return&nbsp;(</span><span style="color: #0000BB">str_replace</span><span style="color: #007700">(</span><span style="color: #DD0000">"apples"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"oranges"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$buffer</span><span style="color: #007700">));<br />}<br /><br /></span><span style="color: #0000BB">ob_start</span><span style="color: #007700">(</span><span style="color: #DD0000">"callback"</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">?&gt;<br /></span>&lt;html&gt;<br />&lt;body&gt;<br />&lt;p&gt;It's&nbsp;like&nbsp;comparing&nbsp;apples&nbsp;to&nbsp;oranges.&lt;/p&gt;<br />&lt;/body&gt;<br />&lt;/html&gt;<br /><span style="color: #0000BB">&lt;?php<br /><br />ob_end_flush</span><span style="color: #007700">();<br /><br /></span><span style="color: #0000BB">?&gt;</span>
    195. 

  195. </span>
    196. 

  196. </code></div>
    197. 

  197.     </div>
    198. 

  198. 

  199.     <div class="example-contents"><p>以上例程会输出：</p></div>
    200. 

  200.     <div class="example-contents screen">
    201. 

  201. <div class="cdata"><pre>
    202. 

  202. &lt;html&gt;
    203. 

  203. &lt;body&gt;
    204. 

  204. &lt;p&gt;It&#039;s like comparing oranges to oranges.&lt;/p&gt;
    205. 

  205. &lt;/body&gt;
    206. 

  206. &lt;/html&gt;
    207. 

  207. </pre></div>
    208. 

  208.     </div>
    209. 

  209.    </div>
    210. 

  210.   </p>
    211. 

  211.  </div>
    212. 

  212. 

  213. 

  214.  <div class="refsect1 seealso" id="refsect1-function.ob-start-seealso">
    215. 

  215.   <h3 class="title">参见</h3>
    216. 

  216.   <p class="para">
    217. 

  217.    <ul class="simplelist">
    218. 

  218.     <li class="member"> <span class="function"><a href="function.ob-get-contents.html" class="function" rel="rdfs-seeAlso">ob_get_contents()</a> - 返回输出缓冲区的内容</span></li>
    219. 

  219.     <li class="member"> <span class="function"><a href="function.ob-end-clean.html" class="function" rel="rdfs-seeAlso">ob_end_clean()</a> - 清空（擦除）缓冲区并关闭输出缓冲</span></li>
    220. 

  220.     <li class="member"> <span class="function"><a href="function.ob-end-flush.html" class="function" rel="rdfs-seeAlso">ob_end_flush()</a> - 冲刷出（送出）输出缓冲区内容并关闭缓冲</span></li>
    221. 

  221.     <li class="member"> <span class="function"><a href="function.ob-implicit-flush.html" class="function" rel="rdfs-seeAlso">ob_implicit_flush()</a> - 打开/关闭绝对刷送</span></li>
    222. 

  222.     <li class="member"> <span class="function"><a href="function.ob-gzhandler.html" class="function" rel="rdfs-seeAlso">ob_gzhandler()</a> - 在ob_start中使用的用来压缩输出缓冲区中内容的回调函数。ob_start callback function to gzip output buffer</span></li>
    223. 

  223.     <li class="member"> <span class="function"><a href="function.ob-iconv-handler.html" class="function" rel="rdfs-seeAlso">ob_iconv_handler()</a> - 以输出缓冲处理程序转换字符编码</span></li>
    224. 

  224.     <li class="member"> <span class="function"><a href="function.mb-output-handler.html" class="function" rel="rdfs-seeAlso">mb_output_handler()</a> - 在输出缓冲中转换字符编码的回调函数</span></li>
    225. 

  225.     <li class="member"> <span class="function"><a href="function.ob-tidyhandler.html" class="function" rel="rdfs-seeAlso">ob_tidyhandler()</a> - ob_start callback function to repair the buffer</span></li>
    226. 

  226.    </ul>
    227. 

  227.   </p>
    228. 

  228.  </div>
    229. 

  229.   
    230. 

  230. 

  231. </div><hr /><div class="manualnavbar" style="text-align: center;">
    232. 

  232.  <div class="prev" style="text-align: left; float: left;"><a href="function.ob-list-handlers.html">ob_list_handlers</a></div>
    233. 

  233.  <div class="next" style="text-align: right; float: right;"><a href="function.output-add-rewrite-var.html">output_add_rewrite_var</a></div>
    234. 

  234.  <div class="up"><a href="ref.outcontrol.html">Output Control 函数</a></div>
    235. 

  235.  <div class="home"><a href="index.html">PHP Manual</a></div>
    236. 

  236. </div></body></html>
    237. 

  237.