PHP 檔案與目錄操作完全指南：8 大核心場景實戰解析

前言

PHP 處理本地檔案系統功能強大，但常遇到權限、路徑、跨平台相容性問題。本文系統整理 8 大核心操作場景，提供最佳實務範例與避坑指南。

1. 開啟檔案：fopen() 完整參數解析

resource fopen ( string $filename, string $mode [, bool $use_include_path [, resource $context ]] )

模式對照表

關鍵建議

• 二進位檔案必須加 'b' 標記：'rb', 'wb' 避免 Windows \r\n 轉換損壞圖片/二進位資料
• 路徑支援相對、絕對、URL 協議（https://, ftp:// 需 allow_url_fopen=On）
• 錯誤處理：$fp = @fopen($file, 'rb') ?: throw new Exception("無法開啟: $file")

2. 關閉檔案：fclose() 釋放資源

bool fclose ( resource $handle )

確保緩衝區資料寫入磁碟、釋放檔案鎖定、歸還系統檔案描述符。良好習慣：配合 try/finally 或 register_shutdown_function 確保關閉。

3. 讀取檔案：多種方式對比

大檔案分塊讀取標準模式

$handle = fopen('large.log', 'rb');
while (!feof($handle)) {
    $chunk = fread($handle, 8192); // 8KB 緩衝區
    process($chunk); // 處理邏輯
}
fclose($handle);

4. 檔案指標狀態判斷

• feof($handle)：到達 EOF 回傳 true
• ftell($handle)：取得當前指標位移（位元組）
• fseek($handle, $offset, SEEK_SET|CUR|END)：移動指標
• rewind($handle)：指標歸零
• filesize($filename)：取得檔案大小（快取結果，明確需 clearstatcache()）

5. 寫入檔案：fwrite() 與檔案鎖定

int fwrite ( resource $handle, string $string [, int $length ] )

安全寫入範本（含獨佔鎖定）

$file = 'data.txt';
$content = "新資料\n";

$fp = fopen($file, 'c+'); // 開啟讀寫、不截斷、建立新檔
if (flock($fp, LOCK_EX)) { // 獨佔鎖定
    ftruncate($fp, 0); // 清空內容（如需覆寫）
    fwrite($fp, $content);
    fflush($fp); // 強制刷新到作業系統緩衝區
    flock($fp, LOCK_UN); // 釋放鎖定
} else {
    throw new Exception("無法取得檔案鎖定");
}
fclose($fp);

二進位資料寫入

$binary = file_get_contents('image.png');
$result = fwrite($fp, $binary, strlen($binary)); // PHP 5.6+ 可省略長度
// 或 mb_strlen($binary, '8bit') 確保位元組長度

6. 檔案權限與屬性檢查

7. 刪除與重命名

bool unlink ( string $filename )      // 刪除檔案
bool rename ( string $old, string $new ) // 移動/重命名（跨檔案系統可能失敗）

注意： 刪除前建議 is_writable() 檢查目錄權限；重命名可用於原子性更新（寫暫存檔 → rename 覆蓋目標）。

8. 目錄操作完整 API

路徑處理

basename($path)        // 檔案名
dirname($path)         // 目錄路徑
pathinfo($path)        // 關聯陣列：dirname, basename, extension, filename
realpath($path)        // 絕對路徑（解析連結、相對路徑）

目錄讀取

$dh = opendir('/path/to/dir');
while (($entry = readdir($dh)) !== false) {
    if ($entry === '.' || $entry === '..') continue;
    $full = '/path/to/dir/' . $entry;
    echo is_dir($full) ? "[DIR] $entry\n" : "[FILE] $entry\n";
}
closedir($dh);

// 現代寫法：DirectoryIterator (SPL)
foreach (new DirectoryIterator('/path') as $file) {
    if ($file->isDot()) continue;
    echo $file->getFilename() . ($file->isDir() ? '/' : '') . "\n";
}

目錄建立/刪除/切換

mkdir($path, 0755, true)  // 遞迴建立，權限受 umask 影響
rmdir($path)              // 僅限空目錄
chdir($path)              // 改變當前工作目錄（影響相對路徑）

實用工具函式：遞迴複製/刪除目錄

function rcopy($src, $dst) {
    $dir = opendir($src);
    @mkdir($dst, 0755, true);
    while (($file = readdir($dir)) !== false) {
        if ($file == '.' || $file == '..') continue;
        $srcPath = "$src/$file";
        $dstPath = "$dst/$file";
        if (is_dir($srcPath)) rcopy($srcPath, $dstPath);
        else copy($srcPath, $dstPath);
    }
    closedir($dir);
}

function rdelete($dir) {
    $items = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS),
        RecursiveIteratorIterator::CHILD_FIRST
    );
    foreach ($items as $item) {
        $item->isDir() ? rmdir($item->getPathname()) : unlink($item->getPathname());
    }
    rmdir($dir);
}

跨平台路徑最佳實務

• 統一使用正斜線 /，PHP 在 Windows 也能正確解析
• 使用 DIRECTORY_SEPARATOR 常數組合路徑
• 避免硬編碼 C:\path，改用 __DIR__、getcwd()、環境變數

現代 PHP（7.1+）建議使用 SplFileObject 物件導向檔案操作，內建迭代器、CSV 解析、鎖定支援，程式碼更優雅、型別安全。大量檔案處理考慮非同步 I/O（Swoole、ReactPHP）或外部工具。