函式名:file()
適用版本:PHP 4, PHP 5, PHP 7
用法:file() 函式將整個檔案讀入一個陣列中。每個陣列元素對應檔案中的一行,包括換行符。
語法:file(string $filename, int $flags = 0, resource $context = null): array|false
引數:
- $filename:要讀取的檔名,可以是本地檔案或遠端檔案的URL。
- $flags(可選):用於指定檔案讀取模式的標誌。預設為 0,表示以普通的文字模式讀取檔案。
- $context(可選):用於指定上下文的資源控制代碼,可以在函式呼叫中指定更多的引數。
返回值:返回包含檔案內容的陣列,每個陣列元素對應檔案中的一行。如果讀取檔案失敗,則返回 false。
示例:
- 讀取本地檔案並輸出每一行的內容:
$lines = file("example.txt");
foreach ($lines as $line) {
echo $line;
}
- 讀取遠端檔案並將內容儲存在陣列中:
$lines = file("http://example.com/file.txt");
print_r($lines);
- 讀取檔案時指定讀取模式和上下文:
$lines = file("example.txt", FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES, $context);
print_r($lines);
注意事項:
- 如果要讀取大型檔案,建議使用逐行讀取的方式,而不是將整個檔案讀入陣列中,以避免記憶體佔用過大。
- 如果檔案讀取失敗,可透過檢查返回值是否為 false 來進行錯誤處理。
- 在讀取遠端檔案時,確保 PHP 配置中啟用了相關的網路函式和選項。