PHP实现目录文件查找与读取的最优方案及数组返回需求

嘿，针对你的问题，咱们分两部分来梳理：

一、查找目录文件的最优方法 #

• 单层目录场景：用scandir()或者glob()就足够简洁高效。scandir()会返回目录下所有文件和子目录的数组，glob()还能通过通配符过滤文件（比如只筛选.zip文件），适合简单的单层遍历需求。
• 多层递归目录场景：优先用PHP SPL库的RecursiveDirectoryIterator + RecursiveIteratorIterator组合。这是原生实现的遍历工具，性能比手动写递归函数更好，还能灵活控制规则（比如跳过隐藏文件、只处理特定后缀）。

二、生成指定格式数组的完整代码 #

结合你给出的代码片段和需求，我整理了一段适配的代码，会遍历目标目录（或目录数组），生成你需要的结构：

<?php
$download_list = array();
$PROTECTED_DOWNLOADS = ['download/']; // 假设这是你的目标目录数组

// 初始化文件信息检测器，用于准确获取MIME类型
$finfo = new Finfo(FILEINFO_MIME_TYPE);

if (is_array($PROTECTED_DOWNLOADS)) {
    foreach ($PROTECTED_DOWNLOADS as $dir) {
        // 先检查目录是否存在且可读，避免报错
        if (!is_dir($dir) || !is_readable($dir)) {
            continue;
        }

        // 递归遍历目录，自动跳过.和..目录
        $iterator = new RecursiveIteratorIterator(
            new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS),
            RecursiveIteratorIterator::SELF_FIRST
        );

        foreach ($iterator as $file) {
            // 只处理文件，跳过子目录
            if (!$file->isFile()) {
                continue;
            }

            $file_path = $file->getPathname();
            $file_name = $file->getFilename();

            // 组装你需要的数组结构
            $download_list[] = array(
                'content_type' => $finfo->file($file_path),
                'suggested_name' => $file_name,
                'protected_path' => str_replace(realpath('./'), '', $file_path) // 生成相对根目录的路径，可根据实际调整
            );
        }
    }
}

// 打印结果示例
print_r($download_list);
?>

代码关键点说明： #

1. MIME类型获取：用Finfo类替代已废弃的mime_content_type()，兼容性和准确性更有保障。
2. 遍历容错：增加了目录存在性和可读性检查，避免因无效目录导致的运行错误。
3. 路径处理：str_replace(realpath('./'), '', $file_path)用于生成相对项目根目录的路径，你可以根据自己的部署结构调整这部分逻辑。
4. 过滤规则：通过isFile()跳过子目录，确保只处理文件类型。

如果你的$PROTECTED_DOWNLOADS里是具体的文件路径而非目录，那可以简化遍历逻辑，直接循环处理每个文件即可。

内容的提问来源于stack exchange，提问作者Oktam Yaqubov