在PHP中列出一个目录中的文件(详细指南)

547 阅读3分钟

在这篇文章中,我们将讨论如何在PHP中获得一个目录中所有文件的列表。

在日常的PHP开发中,经常需要与文件系统打交道--例如,得到一个特定目录下的文件列表。PHP提供了几种不同的方法,可以用来轻松地读取目录内容。今天,我们将通过所有这些方法和例子来了解每一种方法的工作原理。

opendir,readdirclosedir 函数

在本节中,我们将讨论一个系列的 opendir, readdirclosedir函数,看看你如何使用它来获得一个特定目录下的文件列表。

opendir 函数允许你打开一个目录句柄,你可以和其他函数一起使用,对目录进行不同的操作。你需要在opendir 函数的第一个参数中传递一个目录的路径。如果目录路径是有效的,将返回一个目录句柄资源。

readdir 函数允许你读取一个目录。你需要在readdir 函数的第一个参数中提供一个有效的目录句柄,你可以遍历所有条目,得到一个目录中所有文件的列表。

closedir 函数允许你关闭由opendir 函数打开的目录句柄。一旦你完成了对目录句柄(最初由opendir 函数打开)的操作,使用closedir 函数是一个好的做法。

现在,让我们看看它的操作,如下面的例子所示。

<?php
$arrFiles = array();
$handle = opendir('/path/to/directory');

if ($handle) {
    while (($entry = readdir($handle)) !== FALSE) {
        $arrFiles[] = $entry;
    }
}

closedir($handle);
?>

首先,我们使用opendir 函数来获得目录句柄。接下来,我们使用readdir 函数来遍历$handle 目录句柄,并在$arrFiles 数组中存储一个文件列表。

scandir 函数

在这一节中,我们将看到你如何使用 scandir函数来获取目录内容。

scandir 函数是一种非常直接的方法,可以获得特定目录下的文件和目录列表。你只需要在scandir 函数的第一个参数中传递一个你想要读取的目录路径。

让我们通过下面的例子来了解它是如何工作的。

<?php
$arrFiles = scandir('/path/to/directory');
?>

正如你所看到的,这在一次调用中就提供了一个文件和目录的列表如果你只需要获得一个目录中的文件列表,这比使用opendir,readdirclosedir 是更好的选择。

glob 函数

glob函数的工作原理与scandir 函数类似,不同的是它允许你指定一个模式来过滤和匹配目录中的文件。

让我们看看如何使用glob 函数来读取特定目录的所有内容。

<?php
$arrFiles = glob('/path/to/dir/*');
?>

正如你所看到的,我们已经通过了* 模式,因为我们想读取所有的内容。另一方面,如果你想只列出特定类型的文件,你也可以这样做,如下面的片段所示。

<?php
$arrFiles = glob('/path/to/dir/*.txt');
?>

在这种情况下,$arrFiles 将只包含.txt 的文件名。

dir 函数

到目前为止,我们所讨论的选项允许你以程序化的方式读取目录内容。在本节中,我们将看到你如何使用 dir函数,它是一个面向对象的读取目录的机制。

当你使用dir 函数,并在第一个参数中传递一个目录路径时,它会返回一个 Directory类的实例,你可以随后使用它来读取目录内容。

让我们通过下面的例子来看看它是如何具体工作的。

<?php
$arrFiles = array();
$objDir = dir("/path/to/dir");

while (false !== ($entry = $objDir->read())) {
   $arrFiles[] = $entry;
}

$objDir->close();
?>

首先,我们使用dir 函数将Directory 类的一个实例初始化到$objDir 变量中。接下来,我们使用Directory 类的read 方法来遍历所有的条目。

FilesystemIterator

在本节中,我们将看到你如何使用 FilesystemIterator类来读取目录内容。使用FilesystemIterator 类的好处是,你可以扩展这个类的方法,它还提供了很多其他有用的方法,让你也能获取文件的各种信息。

让我们通过下面的例子来了解它是如何工作的。

<?php
$arrFiles = array();
$iterator = new FilesystemIterator("/path/to/directory");

foreach($iterator as $entry) {
    $arrFiles[] = $entry->getFilename();
}
?>

正如你所看到的,使用FilesystemIterator 类并遍历条目是非常容易的。在上面的例子中,我们使用了FilesystemIterator 类的getFileName 方法来获取文件名。然而,FilesystemIterator 类还提供了几个实用方法,如getExtension,getSize,getPathname 等。

因此,这就是你如何使用FilesystemIterator 类来获得一个目录中的文件列表。

总结

今天,我们讨论了在PHP中列出一个目录中所有文件的不同方法。这里有一个表格来比较每一种方法,以帮助你选择哪一种适合你。

函数或类备注
opendir, readdirclosedir功能不是最简单或功能最丰富的方法
scandir功能读取文件列表的最简单方法
glob功能非常简单,允许模式匹配
dir功能readdir的面向对象版本
FilesystemIterator可以提供关于文件的其他信息,如大小或权限