萬盛學電腦網

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

PHP 遍歷目錄與文件的多種方法詳解

前言

遍歷目錄、篩選特定類型文件是 PHP 開發中的高頻需求。PHP 內建了多種函數(scandir、glob、opendir/readdir)以及 SPL 迭代器,各有優缺點。本文通過實例對比幾種主流寫法,助你選出最適合的方案。

方法一:遞歸 + scandir()

scandir() 返回目錄下所有文件/子目錄組成的數組(包含 . 和 ..),需手動過濾。

function getFilesScandir($path) {
    foreach (scandir($path) as $file) {
        if ($file === '.' || $file === '..') continue;
        $full = $path . '/' . $file;
        if (is_dir($full)) {
            getFilesScandir($full); // 遞歸
        } else {
            echo $full . '<br />';
        }
    }
}
getFilesScandir(__DIR__);

優點: 邏輯直觀,兼容性好。
缺點: 需手動過濾 ./..,大目錄下性能一般。

方法二:glob() 模式匹配(推薦)

glob() 直接返回匹配模式的文件路徑數組,自動過濾 ./..,支持通配符,代碼更簡潔。

function getFilesGlob($pattern) {
    foreach (glob($pattern) as $file) {
        if (is_dir($file)) {
            getFilesGlob($file . '/*'); // 遞歸子目錄
        } else {
            echo $file . '<br />';
        }
    }
}
// 列出當前目錄所有文件
getFilesGlob(__DIR__ . '/*');

進階:同時匹配多種擴展名

利用第二個參數 GLOB_BRACE 擴展大括號模式:

foreach (glob($path . '/{*.txt,*.jpg,*.zip}', GLOB_BRACE) as $file) {
    // 處理 txt、jpg、zip 文件
}

方法三:opendir() + readdir()(底層控制)

傳統目錄句柄方式,內存佔用極低,適合超大目錄或需精細控制讀取流程的場景。

function traverse($dir = '.') {
    $handle = opendir($dir);
    while (($file = readdir($handle)) !== false) {
        if ($file === '.' || $file === '..') continue;
        $sub = $dir . DIRECTORY_SEPARATOR . $file;
        if (is_dir($sub)) {
            echo 'Directory ' . $file . ':<br>';
            traverse($sub);
        } else {
            echo 'File in ' . $dir . ': ' . $file . '<br>';
        }
    }
    closedir($handle);
}
traverse('xxtt');

方法四:收集文件名到數組(常見需求)

$dir = 'E:/video';
$files = [];
$handle = opendir($dir);
while (($file = readdir($handle)) !== false) {
    if ($file !== '.' && $file !== '..') {
        $files[] = $file;
    }
}
closedir($handle);
print_r($files);

注意: 文中出現的 explode("/n", trim(`dir/b e://video`)) 依賴系統 dir 命令,**不可移植、不安全,強烈不建議使用**。

方法五:SPL 迭代器(現代、面向對象)

PHP 5.3+ 推薦使用 RecursiveDirectoryIterator + RecursiveIteratorIterator:

$iterator = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator(__DIR__, RecursiveDirectoryIterator::SKIP_DOTS)
);
foreach ($iterator as $fileInfo) {
    if ($fileInfo->isFile()) {
        echo $fileInfo->getPathname() . '<br>';
    }
}

優勢: 代碼簡潔、自動遞歸、可鏈式過濾(如 RegexIterator 篩選擴展名)、內存效率高(惰性迭代)。

總結建議

場景推薦方法理由
簡單腳本、小目錄glob()代碼最少,自動過濾特殊項
需精確控制、超大目錄opendir/readdir底層句柄,內存佔用恆定
現代項目、可維護性優先SPL 迭代器面向對象,功能豐富,可組合過濾器
需按多擴展名篩選glob($pattern, GLOB_BRACE)原生支持大括號擴展
copyright © 萬盛學電腦網 all rights reserved