萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 文件操作核心函數大全:讀寫、屬性、指針控制

PHP 文件系統操作完整指南

文件操作是 PHP 開發的基石。本文涵蓋文件存在性檢測、屬性獲取、打開模式、讀寫操作、指針控制等核心知識點,並提供生產級代碼範例。

一、文件存在性與屬性檢測

1. file_exists() - 判斷文件/目錄是否存在

<?php
$file = 'config.php';
$dir = 'storage/logs';

var_dump(file_exists($file)); // bool(true/false)
var_dump(file_exists($dir));  // 目錄同樣適用
?>

2. 核心屬性獲取函數對照表

函數功能返回值注意事項
filesize()文件大小(字節)int|false結果會被緩存,需 clearstatcache() 刷新
filetype()文件類型stringfile/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

3. 綜合屬性讀取範例

<?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]; } ?>

二、文件打開模式詳解:fopen()

模式說明指針位置創建文件截斷文件
r只讀開頭否否
r+讀寫開頭否否
w只寫開頭是是
w+讀寫開頭是是
a追加寫入結尾是否
a+追加讀寫結尾是否
x獨佔創建寫入開頭僅不存在時否
x+獨佔創建讀寫開頭僅不存在時否

注意:x 模式在文件存在時返回 false 並觸發 E_WARNING,適合防止覆蓋的場景。

三、文件讀取操作

1. 一次性讀取全文

<?php
// 適合小文件
$content = file_get_contents('large.log'); // 返回字符串
$lines = file('large.log', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES); // 返回數組
?>

2. 逐行讀取(大文件推薦)

<?php
$handle = fopen('huge.log', 'r');
if ($handle) {
    while (($line = fgets($handle)) !== false) {
        // 處理每一行
        processLine($line);
    }
    if (!feof($handle)) {
        echo "讀取錯誤:意外中斷";
    }
    fclose($handle);
}
?>

3. 其他讀取函數

  • fgetc($handle):讀取單字符
  • fgetcsv($handle):解析 CSV 行
  • fread($handle, $length):讀取指定長度(二進制安全)
  • fpassthru($handle):直接輸出剩餘內容到瀏覽器

四、文件寫入操作

1. fwrite() - 核心寫入函數

<?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() 可能無法一次寫入所有數據(網絡流),建議循環寫入。

2. file_put_contents() - 便捷封裝

<?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);
?>

六、文件指針實戰:rewind() 經典案例

<?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 緩存(如文件權限、大小變更後)
  • 二進制安全:Windows 下打開二進制文件需加 b 標誌(如 rb、wb)
copyright © 萬盛學電腦網 all rights reserved