萬盛學電腦網

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

PHP 目錄遞迴遍歷:三種實作方式與效能比較 (glob、RecursiveIterator、Generator)

方式一:glob() — 簡單、單層或淺層

// 當前目錄所有 .php 檔
$files = glob(__DIR__ . '/*.php');

// 遞迴 (PHP 5.3+ GLOB_BRACE 不支援遞迴,需自行實作)
function globRecursive(string $pattern, int $flags = 0): array
{
    $files = glob($pattern, $flags);
    foreach (glob(dirname($pattern) . '/*', GLOB_ONLYDIR | $flags) as $dir) {
        $files = array_merge($files, globRecursive($dir . '/' . basename($pattern), $flags));
    }
    return $files;
}
$allPhp = globRecursive(__DIR__ . '/**/*.php'); // 需手動展開 **

**缺點**:遞迴需自寫、一次載入全部路徑佔記憶體、符號連結可能導致無限迴圈。

方式二:RecursiveDirectoryIterator + RecursiveIteratorIterator (標準庫、健壯)

function listFiles(string $dir, array $extensions = []): array
{
    $result = [];
    $it = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS | FilesystemIterator::FOLLOW_SYMLINKS),
        RecursiveIteratorIterator::SELF_FIRST
    );

    foreach ($it as $file) {
        if ($file->isFile()) {
            if (empty($extensions) || in_array(strtolower($file->getExtension()), $extensions, true)) {
                $result[] = $file->getPathname();
            }
        }
    }
    return $result;
}

// 使用
$phpFiles = listFiles('/var/www/project', ['php']);
print_r($phpFiles);

方式三:Generator — 記憶體友善、串流處理 (PHP 5.5+)

function scanFiles(string $dir, array $extensions = []): \Generator
{
    $it = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS),
        RecursiveIteratorIterator::CHILD_FIRST
    );

    foreach ($it as $file) {
        if ($file->isFile() && (empty($extensions) || in_array(strtolower($file->getExtension()), $extensions, true))) {
            yield $file->getPathname() => [
                'path'   => $file->getPathname(),
                'name'   => $file->getFilename(),
                'size'   => $file->getSize(),
                'mtime'  => $file->getMTime(),
                'ext'    => $file->getExtension(),
            ];
        }
    }
}

// 逐個處理,不佔滿記憶體
foreach (scanFiles('/data/logs', ['log']) as $path => $info) {
    if ($info['size'] > 100 * 1024 * 1024) {
        echo "大檔案: $path ({$info['size']} bytes)\n";
    }
}

效能與記憶體對比 (10 萬檔案測試)

進階:排除目錄、深度限制、權限錯誤處理

function scanFilesAdvanced(string $dir, array $options = []): \Generator
{
    $opts = array_merge([
        'extensions'  => [],
        'excludeDirs' => ['.git', 'node_modules', 'vendor', 'storage', 'cache'],
        'maxDepth'    => PHP_INT_MAX,
        'followLinks' => false,
    ], $options);

    $flags = FilesystemIterator::SKIP_DOTS | ($opts['followLinks'] ? FilesystemIterator::FOLLOW_SYMLINKS : 0);
    $iterator = new RecursiveDirectoryIterator($dir, $flags);
    $iterator = new RecursiveIteratorIterator($iterator, RecursiveIteratorIterator::SELF_FIRST);

    $depth = 0;
    foreach ($iterator as $file) {
        $currentDepth = $iterator->getDepth();
        if ($currentDepth > $opts['maxDepth']) continue;

        $baseName = $file->getBasename();
        if ($file->isDir() && in_array($baseName, $opts['excludeDirs'], true)) {
            $iterator->next(); // 跳過此目錄及其子樹
            continue;
        }

        if ($file->isFile() && (empty($opts['extensions']) || in_array(strtolower($file->getExtension()), $opts['extensions'], true))) {
            yield $file->getPathname() => [
                'path' => $file->getPathname(),
                'name' => $baseName,
                'size' => $file->getSize(),
                'mtime' => $file->getMTime(),
                'ext'   => $file->getExtension(),
            ];
        }
    }
}
copyright © 萬盛學電腦網 all rights reserved
方法記憶體峰值耗時適用場景
glob 遞迴~45 MB1.2s小專案、一次性腳本
RecursiveIterator 陣列回傳~38 MB1.0s一般應用、需完整列表
Generator~2 MB0.9s大目錄、串流處理、管線操作