PHP获取指定目录下文件列表的方法

在Web开发过程中，经常会遇到需要读取服务器上某个目录下的所有文件信息的场景。比如后台管理系统中的附件浏览、图片资源管理、日志文件查看等。PHP作为一门广泛应用于服务端脚本的语言，提供了多种方式来获取并遍历指定目录下的文件列表。掌握这些方法，不仅能够提升开发效率，还能让程序更具灵活性和可维护性。

最基础也是最常见的做法是使用 scandir() 函数。这个函数接收一个目录路径作为参数，返回该目录下所有文件和子目录名称组成的数组。例如：

php $dir = './uploads/'; if (is_dir($dir)) { $files = scandir($dir); foreach ($files as $file) { if ($file !== '.' && $file !== '..') { echo $file . '<br>'; } } }

这里需要注意的是，scandir() 返回的结果中默认包含当前目录（.）和上级目录（..），所以在遍历时通常需要将这两个条目过滤掉。此外，该函数返回的列表是按字母顺序排列的，若需其他排序方式，可在PHP层面进行处理。

除了 scandir()，还可以使用 opendir() 配合 readdir() 来逐个读取目录内容。这种方式更灵活，适合对每个文件做即时判断或处理的场景：

php $dir = './logs/'; if ($handle = opendir($dir)) { while (false !== ($file = readdir($handle))) { if ($file != '.' && $file != '..') { echo '发现文件：' . $file . '<br>'; } } closedir($handle); }

这种结构虽然代码稍多，但在处理大型目录时可以有效控制内存占用，因为它是逐条读取而非一次性加载全部数据。

如果希望获取更详细的文件信息，如大小、修改时间、是否为目录等，推荐使用 glob() 函数。它支持通配符匹配，能方便地筛选特定类型的文件：

php $files = glob('./images/*.jpg'); foreach ($files as $file) { $info = pathinfo($file); $size = filesize($file); $mtime = date('Y-m-d H:i', filemtime($file)); echo "文件名：{$info['basename']}，大小：{$size}字节，修改时间：{$mtime}<br>"; }

通过 glob() 可以轻松实现按扩展名分类读取，比如只列出PDF文档、JS脚本或者隐藏文件等。

对于更复杂的目录操作需求，PHP还提供了 RecursiveDirectoryIterator 和 RecursiveIteratorIterator 这类面向对象的迭代器工具。它们特别适用于需要递归遍历子目录的情况：

php
$iterator = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator('./project/', FilesystemIterator::SKIP_DOTS)
);

foreach ($iterator as $file) {
if ($file->isFile()) {
echo "路径：" . $file->getPathname() . " | 大小：" . $file->getSize() . "字节
";
}
}

这种方式结构清晰，扩展性强，尤其适合构建文件搜索、批量处理等功能模块。

在实际项目中，选择哪种方法应根据具体需求权衡。如果只是简单展示当前目录文件，scandir() 足够高效；若涉及条件筛选，glob() 更加便捷；而面对深层级目录结构，则建议采用迭代器模式。

无论使用哪种方式，安全始终是不可忽视的一环。务必验证用户传入的目录路径，避免出现路径穿越漏洞。同时，应对不存在或无权限访问的目录做好异常处理，防止程序报错暴露敏感信息。

综上所述，PHP提供了丰富且层次分明的目录操作手段。合理运用这些函数与类，不仅能准确获取目标文件列表，还能保证代码的健壮性和可读性。在日常开发中多加实践，自然能熟练掌握其中技巧，写出更加优雅高效的文件处理逻辑。