遍歷目錄、篩選特定類型文件是 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 命令,**不可移植、不安全,強烈不建議使用**。
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) | 原生支持大括號擴展 |