php file_get_contents 函數
file_get_contents
( PHP 4中“ = 4.3.0 , PHP 5中)
file_get_contents -讀取整個文件轉換成字符串
描述
字符串file_get_contents (字符串$文件[摘要$國旗= 0 [ ,資源$背景[摘要$抵消= -1 [摘要$ maxlen = -1 ] ] ] ] )
這個功能類似文件( ) ,但file_get_contents ( )返回的字符串中的文件,開始在指定的抵消最多maxlen字節。如果失敗, file_get_contents ( )將返回FALSE 。
file_get_contents ( )是首選的方式讀取文件內容為一個字符串。它將使用內存映射技術的支持下,如果您的操作系統,以提高性能。
注:如果您打開的URI的特殊字符,如空格,你需要的URI的編碼進行urlencode ( ) 。
參數
文件名
文件名改為。
旗幟
警告
所有之前的版本的PHP 6 ,此參數被稱為use_include_path是布爾。國旗參數只適用於自PHP 6 。如果您使用的是舊版本,並希望搜索的文件名中包含路徑,這個參數必須是真實的。自PHP 6 ,您必須使用FILE_USE_INCLUDE_PATH國旗代替。
國旗的價值可任意組合下列旗幟(與一些限制) ,加入的二進位或( | )操作符。
可懸掛國旗描述
FILE_USE_INCLUDE_PATH搜索文件名中包含目錄。見include_path中獲取更多信息。
FILE_TEXT自PHP 6 ,默認編碼的讀取數據是UTF - 8的。您可以指定一個不同的編碼,建立一個自定義的范圍內,或通過改變默認使用stream_default_encoding ( ) 。此標志不能用於FILE_BINARY 。
FILE_BINARY有了這個標志,該文件是只讀二進制模式。這是默認設置,並不能用於FILE_TEXT 。
背景
資源的有效范圍內建立stream_context_create ( ) 。如果你不需要使用自定義的情況下,可以跳過此參數為null 。
抵消
抵銷在讀啟動。
maxlen
最大長度的數據讀取。
返回值
該函數返回讀取數據或FALSE的失敗。
實例
例如# 1 Get和輸出源的網頁,網站
$homepage = file_get_contents('http://www.example.com/');
echo $homepage;
?>
Example #2 Searching within the include_path
// <= PHP 5
$file = file_get_contents('./people.txt', true);
// > PHP 5
$file = file_get_contents('./people.txt', FILE_USE_INCLUDE_PATH);
?>