(PHP 4, PHP 5, PHP 7, PHP 8)
ob_start — 打開輸出控制緩沖
$output_callback
= null
, int $chunk_size
= 0, int $flags
= PHP_OUTPUT_HANDLER_STDFLAGS
): bool此函數(shù)將打開輸出緩沖。當輸出緩沖激活后,腳本將不會輸出內容(除http標頭外),相反需要輸出的內容被存儲在內部緩沖區(qū)中。
內部緩沖區(qū)的內容可以用 ob_get_contents() 函數(shù)復制到一個字符串變量中。 想要輸出存儲在內部緩沖區(qū)中的內容,可以使用 ob_end_flush() 函數(shù)。另外, 使用 ob_end_clean() 函數(shù)會靜默丟棄掉緩沖區(qū)的內容。
當有正在調用的回調函數(shù)時,一些網(wǎng)絡服務器(例如Apache)會改變一個腳本的工作目錄。
你可以在回調函數(shù)中再把它改回來,例如
chdir(dirname($_SERVER['SCRIPT_FILENAME']))
。
輸出緩沖區(qū)是可堆疊的,這即意謂著,當有一個 ob_start() 是活躍的時, 你可以調用另一個 ob_start() 。 只要確保又正確調用了 ob_end_flush() 恰當?shù)拇螖?shù)即可。 如果有多重輸出回調函數(shù)是活躍的,輸出內容會一直按嵌套的順序依次通過它們而被過濾。
output_callback
可選參數(shù) output_callback
函數(shù)可以被指定。
此函數(shù)把一個字符串當作參數(shù)并返回一個字符串。
當輸出緩沖區(qū)被( ob_flush(), ob_clean() 或者相似的函數(shù))沖刷(送出)或者被清洗的時候;或者在請求結束之際輸出緩沖區(qū)內容被沖刷到瀏覽器的時候該函數(shù)將會被調用。
當調用 output_callback
時,它將收到輸出緩沖區(qū)的內容作為參數(shù)
并預期返回一個新的輸出緩沖區(qū)作為結果,這個新返回的輸出緩沖區(qū)內容將被送到瀏覽器。
如果這個 output_callback
不是一個可以調用的函數(shù),此函數(shù)
會返回 false
。以下是回調簽名:
$buffer
, int $phase
= ?): stringbuffer
phase
PHP_OUTPUT_HANDLER_*
常量。
如果 output_callback
返回 false
,其原來的輸入
內容被直接送到瀏覽器。
這個參數(shù) output_callback
可以通過直接給一個 null
值而避開。
ob_end_clean(), ob_end_flush(),
ob_clean(), ob_flush() 和
ob_start() 不能從一個回調函數(shù)中調用。
如果從回調函數(shù)中調用了它們,產(chǎn)生的行為是不明確的。
如果想要刪除緩沖區(qū)的內容,從回調函數(shù)中返回一個"" (空字符串)。
更不能從一個回調函數(shù)中使用像print_r($expression, true)
或highlight_file($filename, true)
一樣的輸出緩沖函數(shù)。
注意:
ob_gzhandler() function exists to facilitate sending gz-encoded data to web browsers that support compressed web pages. ob_gzhandler() determines what type of content encoding the browser will accept and will return its output accordingly.
chunk_size
如果可選參數(shù) chunk_size
被賦值了,在任何一個能引起緩沖區(qū)的長度等于
或超過 chunk_size
的輸出操作后,緩沖區(qū)都會被刷送。
默認值 0
意味著函數(shù)僅在最后被調用。
PHP 5.4.0 之前,1
是一個特殊情況下的值,代表將 chunk_size 設置為 4096 字節(jié)。
flags
flags
參數(shù)代表了一個掩碼位,用來控制對緩沖區(qū)的操作。
The default
is to allow output buffers to be cleaned, flushed and removed, which
can be set explicitly via
PHP_OUTPUT_HANDLER_CLEANABLE
|
PHP_OUTPUT_HANDLER_FLUSHABLE
|
PHP_OUTPUT_HANDLER_REMOVABLE
, or
PHP_OUTPUT_HANDLER_STDFLAGS
as shorthand.
每個標志都控制著對一組功能的訪問,詳細介紹如下:
Constant | Functions |
---|---|
PHP_OUTPUT_HANDLER_CLEANABLE |
ob_clean(), ob_end_clean() 和 ob_get_clean()。 |
PHP_OUTPUT_HANDLER_FLUSHABLE |
ob_end_flush(), ob_flush() 和 ob_get_flush()。 |
PHP_OUTPUT_HANDLER_REMOVABLE |
ob_end_clean(), ob_end_flush() 和 ob_get_flush()。 |
成功時返回 true
, 或者在失敗時返回 false
。
示例 #1 用戶自定義回調函數(shù)的例子
<?php
function callback($buffer)
{
// replace all the apples with oranges
return (str_replace("apples", "oranges", $buffer));
}
ob_start("callback");
?>
<html>
<body>
<p>It's like comparing apples to oranges.</p>
</body>
</html>
<?php
ob_end_flush();
?>
以上例程會輸出:
<html> <body> <p>It's like comparing oranges to oranges.</p> </body> </html>
示例 #2 以兼容 PHP 5.3 和 5.4 的方式創(chuàng)建一個不可擦除的輸出緩沖區(qū)
<?php
if (version_compare(PHP_VERSION, '5.4.0', '>=')) {
ob_start(null, 0, PHP_OUTPUT_HANDLER_STDFLAGS ^
PHP_OUTPUT_HANDLER_REMOVABLE);
} else {
ob_start(null, 0, false);
}
?>