file_get_contents

(PHP 4 >= 4.3.0, PHP 5)

file_get_contents -- 將整個檔案讀入一個字串

說明

string file_get_contents ( string filename [, bool use_include_path [, resource context [, int offset [, int maxlen]]]] )

file() 一樣,只除了 file_get_contents() 把檔案讀入一個字串。將在參數 offset 所特殊的位置開始讀取長度為 maxlen 的內容。若果失敗,file_get_contents() 將返回 FALSE

file_get_contents() 函數是用來將檔案的內容讀入到一個字串中的偏好方法。若果動作系統支援還會使用記憶體映射技術來增強效能。

注: 若果要開啟有特殊字元的 URL (比如說有空格),就需要使用 urlencode() 進行 URL 編碼。

注: context 參數可以用 NULL 來忽略。

更新日誌

版本說明
5.0.0 增加了對 context 的支援。
5.1.0 增加了 offsetmaxlen 參數。

注解

注: 本函數可安全用於二進位對象。

提示: 若果「fopen wrappers」已經被啟動,則在本函數中可以把 URL 作為檔案名來使用。請參閱 fopen() 函數來取得怎樣指定檔案名的詳細訊息以及支援 URL 封裝協定的清單:附錄 M

注: 對 context 的支援是 PHP 5.0.0 增加的。有關 context 的說明見參考 CXLV, Stream Functions

警示

當使用 SSL 時,Microsoft IIS 將違反協定不傳送 close_notify 旗標就關閉連線。PHP 將在到達資料尾端時報告 "SSL: Fatal Protocol Error"。要繞過此問題,應將 error_reporting 層級降低為不內含警示。PHP 4.3.7 及更高版本可以在當使用 https:// 封裝協定開啟流的時候檢驗出有此問題的 IIS 伺服器並抑制警示。若果使用 fsockopen() 來建立一個 ssl:// 套接字,則需要自己檢驗並抑制警示訊息。