函式名稱:file()
適用版本:所有PHP版本
函式用法:file()函式用於將檔案的內容讀取到陣列中。它將整個檔案讀取為一個陣列,每一行作為陣列的一個元素。
語法:file(string $filename, int $flags = 0, resource $context = null): array|false
引數:
- $filename:要讀取的檔名,可以是本地檔案或遠端檔案的URL。
- $flags(可選):可選的標誌引數,用於指定檔案的開啟模式,預設為0。常用的標誌有:
- FILE_USE_INCLUDE_PATH:在include_path中搜尋檔案。
- FILE_IGNORE_NEW_LINES:在每個陣列元素的末尾不包含換行符。
- FILE_SKIP_EMPTY_LINES:跳過空行。
- $context(可選):一個資源型別的上下文,用於指定檔案開啟的上下文。
返回值:成功時返回包含檔案內容的陣列,失敗時返回false。
示例:
- 讀取本地檔案:
$lines = file('path/to/file.txt');
foreach ($lines as $line) {
echo $line;
}
- 讀取遠端檔案:
$lines = file('http://example.com/file.txt');
foreach ($lines as $line) {
echo $line;
}
- 使用標誌引數:
$lines = file('path/to/file.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
foreach ($lines as $line) {
echo $line;
}
注意事項:
- 如果指定的檔案不存在或無法讀取,file()函式將返回false。
- 如果要讀取大檔案,建議使用fopen()和fread()函式進行逐行讀取,以節省記憶體。