异常教程

PHP 5 Directory 函数（长文解析）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

在 PHP 开发中，目录操作是文件管理的核心功能之一。PHP 5 版本虽然已逐渐被 PHP 7 和 PHP 8 取代，但在部分企业级应用中仍被广泛使用。本文聚焦 PHP 5 Directory 函数，通过通俗易懂的讲解和实战案例，帮助开发者掌握如何高效管理文件系统。无论是初学者还是中级开发者，都能通过本文快速上手目录操作，解决实际开发中的常见需求。

一、PHP 5 目录函数基础概念

1.1 目录函数的核心作用

PHP 5 提供了多个用于操作目录的函数，例如 opendir()、readdir()、closedir() 等。这些函数可以完成以下任务：

  • 打开指定目录
  • 读取目录中的文件或子目录
  • 关闭目录句柄
  • 过滤特定类型的文件
  • 递归遍历多级目录

形象比喻：可以将这些函数想象成一位“文件柜管理员”。当开发者需要整理文件时，管理员会先打开柜门（opendir()），逐个查看文件（readdir()），最后关闭柜门（closedir()），并根据需求筛选出需要的文件类型（如 .php 或 .jpg）。

1.2 目录操作的核心函数详解

1.2.1 opendir()：打开目录

opendir() 函数用于打开指定目录，返回目录句柄。其语法如下：

resource opendir ( string $path [, bool $use_include_path = false ] )

参数说明：

  • $path：要打开的目录路径（绝对路径或相对路径）。
  • $use_include_path：是否在 include_path 中搜索目录（默认 false）。

示例代码：

$dir = opendir('/var/www/project/uploads');  
if ($dir === false) {  
    echo "无法打开目录！";  
}

1.2.2 readdir()：读取目录内容

readdir() 函数通过目录句柄逐个读取目录中的文件或子目录，返回当前文件名（字符串类型）。

string readdir ( resource $dir_handle )

使用注意：

  • 每次调用 readdir() 会移动指针到下一个文件。
  • 返回值包含 .（当前目录）和 ..（父目录），需过滤掉这些特殊项。

示例代码：

$dir = opendir('.');  
while (false !== ($file = readdir($dir))) {  
    if ($file !== '.' && $file !== '..') {  
        echo $file . "<br>";  
    }  
}  
closedir($dir);

1.2.3 closedir()：关闭目录句柄

closedir() 用于关闭通过 opendir() 打开的目录句柄，释放系统资源。

void closedir ( resource $dir_handle )

示例代码：

$dir = opendir('images');  
// ...读取文件逻辑...  
closedir($dir);

二、进阶用法与实战案例

2.1 结合 scandir() 简化操作

PHP 5.1.0 引入了 scandir() 函数，可一次性返回目录下所有文件名的数组。

array scandir ( string $directory [, int $sorting_order = 0 [, resource $context ]] )

参数说明：

  • $sorting_order：排序方式（如 SORT_ASC 或 SORT_DESC）。

示例代码：

$files = scandir('uploads');  
foreach ($files as $file) {  
    if ($file[0] !== '.') {  // 过滤隐藏文件  
        echo $file . "<br>";  
    }  
}

2.2 过滤特定文件类型

通过结合 pathinfo() 函数，可以筛选出特定扩展名的文件。

// 获取文件扩展名  
$extension = pathinfo($file, PATHINFO_EXTENSION);  

// 过滤 .php 文件  
if ($extension === 'php') {  
    // 处理逻辑  
}

完整案例：列出目录下所有 .jpg 文件

$dir = 'images';  
$files = scandir($dir);  

foreach ($files as $file) {  
    if (pathinfo($file, PATHINFO_EXTENSION) === 'jpg') {  
        echo "$dir/$file<br>";  
    }  
}

2.3 递归遍历多级目录

使用递归函数可以遍历目录及其子目录中的所有文件。

function list_files($dir) {  
    $dir_handle = opendir($dir);  
    while (false !== ($file = readdir($dir_handle))) {  
        if ($file !== '.' && $file !== '..') {  
            $full_path = "$dir/$file";  
            if (is_dir($full_path)) {  
                list_files($full_path);  // 递归子目录  
            } else {  
                echo $full_path . "<br>";  
            }  
        }  
    }  
    closedir($dir_handle);  
}  

list_files('projects');

三、错误处理与最佳实践

3.1 处理目录不存在的情况

使用 is_dir() 函数验证目录是否存在，避免因路径错误导致的致命错误。

if (!is_dir($path)) {  
    die("目录 $path 不存在！");  
}

3.2 关闭目录句柄的注意事项

未关闭的目录句柄可能导致资源泄漏。建议在 finally 块中关闭句柄（需 PHP 5.5+）：

$dir = opendir('logs') ?: die("目录打开失败");  
try {  
    // 读取文件逻辑  
} finally {  
    closedir($dir);  
}

四、常见问题与解决方案

4.1 readdir() 返回 . 和 .. 的处理

通过条件判断过滤特殊项：

if ($file !== '.' && $file !== '..') {  
    // 处理文件逻辑  
}

4.2 文件名乱码问题

确保文件编码与 PHP 文件编码一致（如 UTF-8）。可在开头添加：

header('Content-Type: text/html; charset=utf-8');

五、总结与扩展

通过本文，开发者可以掌握 PHP 5 Directory 函数 的核心用法，并通过实战案例理解如何高效管理文件目录。随着 PHP 版本的迭代，PHP 7+ 引入了更简洁的 glob() 函数和 DirectoryIterator 类，但掌握 PHP 5 的基础函数仍然是理解后续版本功能的重要基础。

进阶方向：

  • 学习 PHP 7+ 的 glob() 函数（支持通配符匹配）
  • 使用 RecursiveDirectoryIterator 实现更强大的递归遍历
  • 结合 filemtime() 筛选特定时间范围的文件

希望本文能帮助开发者快速上手目录操作，为后续的文件管理、批量处理等场景提供扎实的基础。

最新发布

查看更多文章