######################################### ##標題 關於輸出緩沖的討論 ##整理 Diego Lynn @ 林全國 ##原作 By Zeev Suraski ######################################### 關於輸出緩沖的討論(Output buffering) 目錄 HTTP Header 為什麼要使用Output Buffering技術 Output Buffering的工作原理 基本用法 高級用法 使事情更為簡單 哈哈,我成功了 我個人認為,Output buffering是比較純粹的PHP 4.0特征。盡管從概念上看來相當簡單,但是output buffering功能非常強大,能使開發者更容易地開發高級而有效的程序。 本文將介紹HTTP header,以及output buffering如何幫助您處理HTTP header,並介紹了output buffering的一些高級用法。 HTTP Header[HTTP 標題] 對於使用HTTP 協議建立的每個請求,Web服務器產生的響應通常包括兩個部分 – 標題和主體。例如,如果在Web服務器的文檔根目錄下有一個小文本文件,叫做example.txt,文件中包含文本Hello, world!,那麼對此文件的HTTP 請求響應如下所示: HTTP/1.1 200 OK Date: Sat, 02 Sep 2000 21:40:08 GMT Server: Apache/1.3.11 (Unix) mod_macro/1.1.1 PHP/4.0.2-dev Last-Modified: Sat, 02 Sep 2000 21:39:49 GMT ETag: "12600b-e-39b173a5" Accept-Ranges: bytes Content-Length: 14 Connection: close Content-Type: text/plain Hello, world! 這個請求中的第一部分(就是較多的那部分)就是HTTP header。雖然用戶在浏覽器中看不到HTTP header,但它包含了用於浏覽器的信息,例如文檔內容類型,使用的協議版本,文檔的最後更改日期等等。HTTP header並沒有太多的規則,通常情況下,它的格式如下: Field: Value[字段:值] 必須用空行將它們和文檔主體分開。 可以從PHP腳本添加或更改此HTTP header的信息。例如,可以使用 header() 函數: header("Location: http://www.php.net/"); // 重定向到 http://www.php.net/ 也可以使用 SetCookie() 函數: SetCookie("foo", "bar"); 你可能會知道HTTP cookies是使用 HTTP headers 來實現的。例如,以下PHP文件的 HTTP 請求響應 將會是這樣的: HTTP/1.1 200 OK Date: Sat, 02 Sep 2000 21:43:02 GMT Server: Apache/1.3.11 (Unix) mod_macro/1.1.1 PHP/4.0.2-dev X-Powered-By: PHP/4.0.2-dev Set-Cookie: foo=bar Connection: close Content-Type: text/html Set cookie. 浏覽器讀取從服務器返回的 HTTP header,知道送來了一個叫做 foo 的 cookie (在這裡是一個 session cookie),它的值是 bar。 為什麼要使用Output Buffering技術 早在PHP/FI 2.0時就很明顯需要output buffering技術了。如果你使用過這種版本的PHP,那麼可能還記得經常會碰到 Oops, SetCookie called after header has been sent 這個錯誤消息,並使你捎頭抓耳,也弄不清是什麼原因。 如果你已使用過PHP的最新版本 -- PHP 3.0 甚至 PHP 4.0 -- 那麼你會知道這個錯誤消息: Oops, php_set_cookie called after header has been sent。或者,你在試圖調用 PHP 的 header() 函數時會遇到 Cannot add header information - headers already sent 消息。一般來說,output buffering技術用戶避免這些煩人的錯誤消息,同時開發人員也可用於高級的用途。 這些錯誤是什麼時候產生的呢?如果你在已經發送了HTTP header之後試圖添加或修改標題信息,以及在文檔主體和標題之間缺少空行時,就會產生這些錯誤消息。為了理解這是如何產生的,讓我們來看看PHP是如何處理HTTP header輸出和主體輸出的。 腳本開始執行時,它可以同時發送header(標題)信息和主體信息。 Header信息(來自 header() 或 SetCookie() 函數)並不會立即發送,相反,它被保存到一個列表中。 這樣就可以允許你修改標題信息,包括缺省的標題(例如 Content-Type 標題)。但是,一旦腳本發送了任何非標題的輸出(例如,使用 HTML 代碼塊或 print() 調用),那麼PHP就必須先發送所有的標題,然後再送出空行,終止 HTTP header,而在此之後才會繼續發送主體數據。從這時開始,任何添加或修改標題信息的試圖都是不允許的,並會發送上述的錯誤消息之一。 雖然這並不會引起多大的問題,有時候只是在發出任何輸入之前終止HTTP header,從而引起腳本邏輯的復雜化而已。Output buffering技術可以解決這些問題。 Output Buffering的工作原理 啟用output buffering時,在腳本發送輸出時,PHP並不發送HTTP header。相反,它將此輸出通過管道(pipe)輸入到動態增加的緩存中(只能在PHP 4.0中使用,它具有中央化的輸出機制)。你仍然可以修改,添加標題行,或者設置cookie,因為標題實際上並沒有發送。最簡單的情況是,當腳本終止時,PHP將自動發送HTTP header到浏覽器,然後再發送輸出緩沖中的內容。這簡單吧。 基本用法 可以使用下面的四個函數,它們可以幫助你控制output buffering: ob_start() 啟用output buffering機制。 Output buffering支持多層次 -- 例如,可以多次調用 ob_start() 函數。 ob_end_flush() 發送output buffer(輸出緩沖)並禁用output buffering機制。 ob_end_clean() 清除output buffer但不發送,並禁用output buffering。 ob_get_contents() 將當前的output buffer返回成一個字符串。允許你處理腳本發出的任何輸出。 此外,可以啟用 php.ini 中的 output_buffering 指令。如果啟用了此指令,那麼每個PHP腳本都相當於一開始就調用了ob_start()函數。 Example 1