(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
file_get_contents — 將整個(gè)文件讀入一個(gè)字符串
$filename,$use_include_path = false,$context = ?,$offset = 0,$length = ?
和 file() 一樣，只除了
file_get_contents() 把文件讀入一個(gè)字符串。將在參數
offset 所指定的位置開(kāi)始讀取長(cháng)度為
length 的內容。如果失敗，file_get_contents()
將返回 false。
file_get_contents() 函數是用來(lái)將文件的內容讀入到一個(gè)字符串中的首選方法。如果操作系統支持還會(huì )使用內存映射技術(shù)來(lái)增強性能。
注意:
如果要打開(kāi)有特殊字符的 URL （比如說(shuō)有空格），就需要使用 urlencode() 進(jìn)行 URL 編碼。
filename要讀取的文件的名稱(chēng)。
use_include_path注意:
常量
FILE_USE_INCLUDE_PATH用于觸發(fā)搜索 include path。 因為FILE_USE_INCLUDE_PATH是個(gè) int，如果開(kāi)啟了嚴格類(lèi)型 將無(wú)法啟用。 所以要用true來(lái)代替常量。
context
stream_context_create() 創(chuàng )建的有效的上下文（context）資源。
如果你不需要自定義 context，可以用 null 來(lái)忽略。
offset讀取原始數據流的開(kāi)始位置偏移量。負的 offset 會(huì )從數據流的末尾開(kāi)始統計。
遠程文件不支持偏移量尋址（offset）。
對遠程文件以較小的 offset 可能可以正常尋址，
但由于是對緩沖流進(jìn)行操作，所以操作結果不可預測。
length要讀取數據的最大長(cháng)度。 默認情況下會(huì )讀到文件末尾。 注意，該參數會(huì )應用到處理 stream 的過(guò)濾器（filter）中。
函數返回讀取到的數據， 或者在失敗時(shí)返回 false。
以下情況會(huì )導致 E_WARNING 級別錯誤：
無(wú)法找到 filename 文件；
length 小于零；
在 steam 中無(wú)法尋址偏移量 offset。
Windows 下用 file_get_contents() 讀取目錄會(huì )導致 E_WARNING 錯誤。
PHP 7.4 起，其他操作系統也會(huì )出現同樣錯誤。
示例 #1 獲取并輸出網(wǎng)站首頁(yè) HTML 源碼
<?php
$homepage = file_get_contents('http://www.example.com/');
echo $homepage;
?>
示例 #2 在 include_path 里搜索
<?php
// 如果開(kāi)啟了嚴格類(lèi)型，例如 declare(strict_types=1);
$file = file_get_contents('./people.txt', true);
// 否則就這樣寫(xiě)
$file = file_get_contents('./people.txt', FILE_USE_INCLUDE_PATH);
?>
示例 #3 讀取文件一小節
<?php
// 從第 21 個(gè)字符開(kāi)始，讀取 14 字符長(cháng)度
$section = file_get_contents('./people.txt', FALSE, NULL, 20, 14);
var_dump($section);
?>
以上例程的輸出類(lèi)似于：
string(14) "lle Bjori Ro"
示例 #4 使用 stream 上下文（context）
<?php
// 創(chuàng )建 stream
$opts = array(
'http'=>array(
'method'=>"GET",
'header'=>"Accept-language: en\r\n" .
"Cookie: foo=bar\r\n"
)
);
$context = stream_context_create($opts);
// 以下面設置的 HTTP 頭來(lái)打開(kāi)文件
$file = file_get_contents('http://www.example.com/', false, $context);
?>
| 版本 | 說(shuō)明 |
|---|---|
| 7.1.0 |
支持負數 offset。
|
注意: 此函數可安全用于二進(jìn)制對象。
如已啟用fopen 包裝器，在此函數中， URL 可作為文件名。關(guān)于如何指定文件名詳見(jiàn) fopen()。各種 wapper 的不同功能請參見(jiàn) 支持的協(xié)議和封裝協(xié)議，注意其用法及其可提供的預定義變量。
使用 SSL 時(shí)，Microsoft IIS
會(huì )違反協(xié)議不發(fā)送close_notify標記就關(guān)閉連接。PHP 會(huì )在到達數據尾端時(shí)報告“SSL: Fatal Protocol Error”。
要解決此問(wèn)題，error_reporting 應設定為降低級別至不包含警告。
PHP 4.3.7 及更高版本可以在使用 https:// 包裝器打開(kāi)流時(shí)檢測出有問(wèn)題的 IIS 服務(wù)器軟件 并抑制警告。在使用
fsockopen() 創(chuàng )建 ssl:// 套接字時(shí), 開(kāi)發(fā)者需檢測并抑制此警告。