PHP 檔案操作常見問題解答大全

PHP 檔案操作常見問題解答大全

PHP 提供豐富的檔案系統函數，但開發過程中常遇到權限、編碼、路徑等問題。本文整理實務上最常見的問答，涵蓋建立、讀取、寫入、權限、屬性取得、鎖定與刪除等操作。

基本操作篇

Q1: 如何新建檔案？

A: 兩種主要方式：

// 方式一：fopen（推薦，可控制模式）
$fp = fopen("newfile.txt", "w"); // w: 寫入，截短現有內容
fclose($fp);

// 方式二：系統指令（不推薦，有安全風險）
exec("touch newfile.txt"); // Linux/Unix
// 或
file_put_contents("newfile.txt", ""); // PHP 5.4+ 簡潔寫法

Q2: 為什麼無法建立檔案？

A: 常見三大原因：

1. 模式參數錯誤：fopen 需使用 w、w+、a、a+ 等寫入模式
2. 目錄權限不足：PHP 執行身份（如 www-data）需擁有目錄寫入權限
3. 路徑錯誤：相對路徑基於執行腳本位置，建議使用 __DIR__ 組合絕對路徑

Q3: 如何將檔案讀入陣列？

A: file() 函數自動按行分割，回傳陣列：

$lines = file("data.txt", FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);

Q4: 如何一次讀取整個檔案內容？

A: 視 PHP 版本選擇：

// PHP 4.3.0+ 推薦
$content = file_get_contents("data.txt");

// 舊版相容寫法
$fp = fopen("data.txt", "r");
$content = fread($fp, filesize("data.txt"));
fclose($fp);

進階判斷與屬性篇

Q5: 如何判斷檔案是否存在？

A: 使用 file_exists()。不要用 fopen() 判斷，因為權限不足時 fopen 會失敗導致誤判。

Q6: 讀取遠端網頁出錯怎麼辦？

A: 確認兩點：

• 只能用 r 模式開啟遠端 URL
• 需在 php.ini 啟用 allow_url_fopen = On
• 目標網頁必須可正常存取（無防火牆、認證攔截）

Q7: 如何取得檔案屬性（修改時間、擁有者、大小等）？

A: PHP 提供完整函數族群：

特殊操作篇

Q8: PHP 能像 C 語言用 fseek() 定位檔案指標嗎？

A: 可以。fseek($fp, $offset, SEEK_SET) 支援 SEEK_SET（開頭）、SEEK_CUR（目前位置）、SEEK_END（結尾）三種基準點。

Q9: 如何獨佔存取檔案（防止同時寫入）？

A: 使用 flock()：

$fp = fopen("data.txt", "c+");
if (flock($fp, LOCK_EX)) { // 獨佔鎖定
    // 安全讀寫操作
    flock($fp, LOCK_UN); // 釋放鎖定
}
fclose($fp);

注意：flock() 僅在同一系統進程間有效，分散式系統需用 Redis 鎖或資料庫行鎖。

Q10: 如何刪除檔案指定行（如第 3 行）？

A: PHP 無內建函數，需組合處理：

function deleteLine($filename, $lineNum) {
    $lines = file($filename, FILE_IGNORE_NEW_LINES);
    if ($lineNum > 0 && $lineNum <= count($lines)) {
        unset($lines[$lineNum - 1]);
        file_put_contents($filename, implode("\n", $lines));
        return true;
    }
    return false;
}
// 刪除第 3 行
deleteLine("test.dat", 3);

常見陷阱與最佳實踐

1. 路徑分隔符：Windows 用 \，Linux 用 /，建議統一用 DIRECTORY_SEPARATOR 或 /（PHP 自動轉換）
2. 編碼問題：中文檔名在 Windows 下常為 Big5/GBK，Linux 為 UTF-8，跨平台請用 iconv() 轉換
3. 大檔案處理：避免 file_get_contents() 讀入記憶體，改用 fopen() 串流逐塊處理
4. 錯誤抑制：別濫用 @fopen()，應檢查回傳值並記錄錯誤日誌
5. 資源釋放：務必 fclose()，長期執行腳本否則會洩漏檔案描述符

掌握這些檔案操作核心概念，能讓你在處理上傳、匯入匯出、日誌、快取等場景時更得心應手。