PHP opendir() 函数详解：打开目录句柄与遍历文件

纸上星河

发布时间：2026-10-14| 4人浏览过

原创

opendir() 是 PHP 中用于打开目录句柄的基础函数。通过它配合 readdir() 可以逐个读取目录内容，最终使用 closedir() 关闭句柄以释放资源。本文提供完整的代码实例及关键参数说明。

opendir 函数概述

opendir() 函数用于打开一个目录句柄。成功时返回一个目录流（resource），若失败则返回 false。

基本流程：打开目录 → 循环读取文件/文件夹 → 关闭目录句柄。

代码实现步骤

第1步：准备目录路径与安全性检查

在执行打开操作前，务必验证目标路径是否为有效目录，避免程序报错。

$dirs = './'; // 指定当前工作目录
if (is_dir($dirs)) {
    // 进入下一步：打开目录句柄
}

第2步：打开目录句柄并遍历文件

使用 opendir() 打开目录，并通过 while 循环调用 readdir() 获取文件名，直到返回 false。

$hanld = opendir($dirs); // 注意：变量名建议规范为 $handle

while (($file = readdir($hanld)) !== false) {
    echo "文件名: " . $file . "<br />";
}

// 关闭句柄
closedir($hanld);

第3步：处理异常情况

如果路径不是目录，需给出明确提示。

else {
    echo '不是目录';
}

完整示例代码

将上述步骤整合后的完整代码如下：

复制代码代码如下:

$dirs = './'; // 指定当前上当
if( is_dir( $dirs ) )
{
 $hanld = opendir($dirs);
 
 while (($file = readdir($hanld)) !== false)
 {
   echo "文件名: " . $file . "<br />";
 }
 closedir($hanld);
}
else
{
 echo '不是目录';
}

运行结果示例

假设当前目录下包含文件 a、b 以及 www.jb51.net，输出结果如下：

文件名: a
文件名: b
文件名: www.jb51.net

重要注意事项

FTP 支持：从 PHP 5.0.0 开始，path 参数支持 ftp:// URL wrapper（注：原始描述提及 4.3.0，但 5.0.0 为更广泛的标准起始点）。
历史兼容性：在 PHP 4 中，仅 file:// URL wrapper 支持此功能；PHP 4.3.0 后范围有所扩大。
资源管理：务必调用 closedir() 关闭句柄，防止资源泄露。

以上就是关于 PHP opendir() 函数用法的详细内容，更多关于 PHP 目录操作技巧的资料请关注本站其它相关文章！