文件操作是 PHP 開發的基石。本文涵蓋文件存在性檢測、屬性獲取、打開模式、讀寫操作、指針控制等核心知識點,並提供生產級代碼範例。
<?php
$file = 'config.php';
$dir = 'storage/logs';
var_dump(file_exists($file)); // bool(true/false)
var_dump(file_exists($dir)); // 目錄同樣適用
?>
| 函數 | 功能 | 返回值 | 注意事項 |
|---|---|---|---|
| filesize() | 文件大小(字節) | int|false | 結果會被緩存,需 clearstatcache() 刷新 |
| filetype() | 文件類型 | string | file/dir/link/char/block/fifo/socket |
| filemtime() | 最後修改時間 | int (Unix 時間戳) | 配合 date() 格式化 |
| fileatime() | 最後訪問時間 | int | 部分系統為優化性能會關閉 atime 更新 |
| fileperms() | 文件權限 | int | 需用 substr(sprintf('%o', $perms), -4) 查看八進制 |
| is_readable() | 可讀性 | bool | |
| is_writable() | 可寫性 | bool | |
| is_executable() | 可執行性 | bool |
<?php
$file = 'data/report.pdf';
if (file_exists($file)) {
echo "大小:" . formatBytes(filesize($file)) . "
";
echo "類型:" . filetype($file) . "
";
echo "修改時間:" . date('Y-m-d H:i:s', filemtime($file)) . "
";
echo "權限:" . substr(sprintf('%o', fileperms($file)), -4) . "
";
}
function formatBytes($bytes, $precision = 2) {
$units = ['B', 'KB', 'MB', 'GB', 'TB'];
$pow = floor($bytes ? log($bytes, 1024) : 0);
$pow = min($pow, count($units) - 1);
return round($bytes / (1024 ** $pow), $precision) . ' ' . $units[$pow];
}
?>
| 模式 | 說明 | 指針位置 | 創建文件 | 截斷文件 |
|---|---|---|---|---|
| r | 只讀 | 開頭 | 否 | 否 |
| r+ | 讀寫 | 開頭 | 否 | 否 |
| w | 只寫 | 開頭 | 是 | 是 |
| w+ | 讀寫 | 開頭 | 是 | 是 |
| a | 追加寫入 | 結尾 | 是 | 否 |
| a+ | 追加讀寫 | 結尾 | 是 | 否 |
| x | 獨佔創建寫入 | 開頭 | 僅不存在時 | 否 |
| x+ | 獨佔創建讀寫 | 開頭 | 僅不存在時 | 否 |
注意:x 模式在文件存在時返回 false 並觸發 E_WARNING,適合防止覆蓋的場景。
<?php
// 適合小文件
$content = file_get_contents('large.log'); // 返回字符串
$lines = file('large.log', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES); // 返回數組
?>
<?php
$handle = fopen('huge.log', 'r');
if ($handle) {
while (($line = fgets($handle)) !== false) {
// 處理每一行
processLine($line);
}
if (!feof($handle)) {
echo "讀取錯誤:意外中斷";
}
fclose($handle);
}
?>
fgetc($handle):讀取單字符fgetcsv($handle):解析 CSV 行fread($handle, $length):讀取指定長度(二進制安全)fpassthru($handle):直接輸出剩餘內容到瀏覽器<?php
$file = 'log.txt';
$handle = fopen($file, 'a'); // 追加模式
if ($handle) {
$written = fwrite($handle, "[" . date('Y-m-d H:i:s') . "] 用戶登入\n");
if ($written === false) {
error_log("寫入失敗:$file");
}
fclose($handle);
}
?>
返回寫入字節數,失敗返回 false。注意:fwrite() 可能無法一次寫入所有數據(網絡流),建議循環寫入。
<?php
// 相當於 fopen + fwrite + fclose
file_put_contents('config.json', json_encode($config), LOCK_EX); // 獨佔鎖防併發
file_put_contents('log.txt', $msg . PHP_EOL, FILE_APPEND | LOCK_EX); // 追加寫入
?>
| 函數 | 功能 | 典型用途 |
|---|---|---|
| ftell($handle) | 獲取當前指針位置 | 斷點續傳、進度顯示 |
| fseek($handle, $offset, SEEK_SET|SEEK_CUR|SEEK_END) | 移動指針 | 隨機讀取、跳過頭部 |
| rewind($handle) | 重置到開頭 | 重複讀取 |
| feof($handle) | 判斷是否到達末尾 | 循環讀取終止條件 |
<?php
function readChunk($file, $start, $length) {
$handle = fopen($file, 'rb');
fseek($handle, $start, SEEK_SET);
$data = fread($handle, $length);
fclose($handle);
return $data;
}
// 讀取第 100-199 字節(共 100 字節)
$chunk = readChunk('bigfile.dat', 100, 100);
?>
<?php
$handle = fopen('data.txt', 'r');
echo "第一行:" . fgets($handle);
echo "第二行:" . fgets($handle);
rewind($handle); // 指針歸零
echo "重讀第一行:" . fgets($handle);
fclose($handle);
?>
flock($handle, LOCK_EX) 獨佔鎖,LOCK_SH 共享鎖,LOCK_UN 釋放tmpfile() 創建臨時文件(腳本結束自動刪除),tempnam() 生成唯一臨時文件名DIRECTORY_SEPARATOR、realpath()、pathinfo() 處理跨平台路徑clearstatcache() 刷新 stat 緩存(如文件權限、大小變更後)b 標誌(如 rb、wb)