方法一:傳統 dir() 類(PHP 4+)
<?php
function listDirRecursive(string $path, int $depth = 0): void {
$dir = dir($path);
if (!$dir) return;
$indent = str_repeat(' ', $depth);
echo "{$indent}📁 {$dir->path}\n";
while (($entry = $dir->read()) !== false) {
if ($entry === '.' || $entry === '..') continue;
$fullPath = $dir->path . DIRECTORY_SEPARATOR . $entry;
if (is_dir($fullPath)) {
listDirRecursive($fullPath, $depth + 1);
} else {
echo $indent . " 📄 $entry\n";
}
}
$dir->close();
}
// 使用
listDirRecursive(__DIR__);
?>
方法二:現代 SPL RecursiveDirectoryIterator(推薦,PHP 5+)
<?php
$path = __DIR__;
$iterator = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($path, RecursiveDirectoryIterator::SKIP_DOTS),
RecursiveIteratorIterator::SELF_FIRST
);
foreach ($iterator as $fileInfo) {
$depth = $iterator->getDepth();
$indent = str_repeat(' ', $depth);
$prefix = $fileInfo->isDir() ? '📁' : '📄';
echo "{$indent}{$prefix} {$fileInfo->getFilename()}\n";
// 可取得更多資訊
// $fileInfo->getSize() // 檔案大小
// $fileInfo->getMTime() // 修改時間
// $fileInfo->getPerms() // 權限
// $fileInfo->getPathname() // 完整路徑
}
?>
進階:過濾特定副檔名
$filter = new RegexIterator(
new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($path, RecursiveDirectoryIterator::SKIP_DOTS)
),
'/\.php$/i' // 只匹配 .php 結尾
);
foreach ($filter as $file) {
echo $file->getPathname() . "\n";
}
比較總結
| 特性 | dir() 類 | RecursiveDirectoryIterator |
| 風格 | 程序式 | 物件導向、可迭代 |
| 功能 | 基礎遍歷 | 支援過濾、排序、深度控制、檔案資訊豐富 |
| 記憶體 | 逐項讀取 | 逐項讀取(迭代器模式) |
| 推薦度 | 舊專案維護 | ✅ 新專案首選 |