您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 綜合知識

PHP 目錄遍歷的兩種經典實現方法詳解

編輯：PHP 綜合知識

前言

在 PHP 開發中，遍歷目錄結構是常見的需求，例如建立檔案索引、批次處理檔案、生成網站地圖等。本文將介紹兩種經典且實用的目錄遍歷方法，分別基於 glob() 函數與 dir() 類，並提供完整的程式碼範例供參考。

方法一：使用 glob() 遞迴掃描

glob() 函數能依據模式尋找檔案路徑，配合遞迴函數即可輕鬆實現深度優先遍歷。此方法程式碼簡潔，適合快速開發原型。

<?php
function myscandir($pathname) {
    foreach (glob($pathname) as $filename) {
        if (is_dir($filename)) {
            // 遇到目錄則遞迴進入，注意路徑尾部加上 '/*'
            myscandir($filename . '/*');
        } else {
            // 遇到檔案則輸出路徑
            echo $filename . '<br/>';
        }
    }
}

// 範例：掃描 D:/wamp/www/exe1/ 目錄下所有檔案
myscandir('D:/wamp/www/exe1/*');
?>

關鍵點說明：

glob($pathname) 返回符合模式的檔案/目錄陣列。
遞迴呼叫時需在路徑後附加 /*，否則無法匹配子目錄內容。
此寫法會同時列出檔案與目錄，若需過濾可自行加入條件判斷。

方法二：使用 dir() 類搭配 while 迴圈

dir() 類提供物件導向的目錄讀取介面，配合 read() 方法逐項讀取，邏輯更貼近底層操作，效能上略優於 glob()，且對特殊檔案名（如包含空格、中文）的相容性較好。

<?php
function myscandir($path) {
    $mydir = dir($path);
    while ($file = $mydir->read()) {
        // 組合完整路徑
        $p = $path . '/' . $file;

        // 排除當前目錄 '.' 與上層目錄 '..'
        if (($file != ".") && ($file != "..")) {
            echo $p . '<br>';
        }

        // 若為目錄且非特殊目錄，則遞迴處理
        if ((is_dir($p)) && ($file != ".") && ($file != "..")) {
            myscandir($p);
        }
    }
    $mydir->close(); // 良好習慣：關閉目錄句柄
}

// 範例：掃描當前檔案所在目錄的上兩層目錄
myscandir(dirname(dirname(__FILE__)));
?>

關鍵點說明：

dir($path) 返回一個 Directory 物件，擁有 read()、rewind()、close() 方法。
必須顯式排除 . 與 ..，否則會陷入無限遞迴。
建議在函數結束前呼叫 $mydir->close() 釋放資源。

兩種方法對比與選擇建議

比較項目	glob() 遞迴	dir() 類迴圈
程式碼簡潔度	高	中
執行效能	較低（大量檔案時明顯）	較高
特殊檔名支援	一般	良好
適用場景	快速原型、小型專案	正式專案、大量檔案、長期維護

進階提示：SPL 迭代器——現代 PHP 的最佳選擇

PHP 5.3+ 內建 RecursiveDirectoryIterator 與 RecursiveIteratorIterator，提供更強大、更符合現代開發習慣的遍歷方式：

<?php
$iterator = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator('/path/to/dir', FilesystemIterator::SKIP_DOTS)
);

foreach ($iterator as $fileInfo) {
    echo $fileInfo->getPathname() . '<br/>';
}
?>

優點包括：自動處理遞迴、可靈活過濾（如 RegexIterator）、記憶體效率高（逐項產生）、支援鏈式操作。建議新專案優先採用 SPL 迭代器。