异常教程

PHP 5 Filesystem 函数（一文讲透）

更新时间:

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

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 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 提供的 Filesystem 函数库都扮演着不可替代的角色。本文将深入浅出地讲解 PHP 5 中常用的文件系统函数，通过案例和比喻，帮助开发者从基础到进阶掌握这些工具，同时强调安全实践和常见问题的解决方案。

一、文件系统操作的核心概念

1.1 文件路径与目录结构

PHP 中的文件操作依赖于文件路径和目录结构的管理。可以将路径想象为“数字世界中的地址”，而目录则是“文件的收纳柜”。例如，/var/www/project/data.txt 表示一个文件的绝对路径，而 ./uploads/file.jpg 是相对于当前脚本位置的相对路径。

关键点：

  • 绝对路径：从系统根目录（如 / 或 C:\）开始的完整路径。
  • 相对路径：相对于当前脚本文件所在目录的路径。
  • 路径分隔符：在 Windows 中使用反斜杠 \，Linux/macOS 使用正斜杠 /。PHP 内部会自动处理这些差异。

1.2 文件操作的基本流程

文件操作通常遵循以下流程：

  1. 检查文件或目录是否存在（如 file_exists()）。
  2. 打开或创建文件（如 fopen()）。
  3. 读取或写入数据（如 fwrite()、fread()）。
  4. 关闭文件句柄（如 fclose()）。

比喻：这就像整理文件柜——先确认抽屉是否存在（检查路径），再打开抽屉（打开文件），放入或取出文件（读写数据），最后关上抽屉（关闭文件）。

二、基础 Filesystem 函数详解

2.1 检查文件或目录是否存在

函数：file_exists() 和 is_dir()

if (file_exists('/path/to/file.txt')) {  
    echo "文件存在！";  
} else {  
    echo "文件不存在，需要创建或处理异常。";  
}  

// 检查是否为目录  
if (is_dir('/path/to/directory')) {  
    echo "这是一个目录。";  
}

作用：file_exists() 判断路径指向的文件或目录是否存在，is_dir() 则专门检测是否为目录。

2.2 创建与删除目录

函数：mkdir() 和 rmdir()

// 创建目录，递归参数设置为 true 可创建多级目录  
if (!mkdir('/path/to/newdir', 0755, true)) {  
    echo "目录创建失败，请检查权限！";  
}  

// 删除空目录  
if (!rmdir('/path/to/emptydir')) {  
    echo "目录删除失败，可能非空或权限不足。";  
}

关键参数：

  • 0755 表示目录权限（所有者可读写执行，其他用户可读写）。
  • true 允许递归创建父目录。

2.3 文件的读写操作

函数：fopen()、fwrite()、fclose()

// 写入文件（覆盖模式）  
$handle = fopen('data.txt', 'w');  
if ($handle) {  
    fwrite($handle, "这是要写入的内容。");  
    fclose($handle);  
}  

// 追加内容（追加模式）  
$handle = fopen('data.txt', 'a');  
fwrite($handle, "\n新增一行内容。");  
fclose($handle);

模式参数详解：

  • 'w'：覆盖写入，若文件不存在则创建。
  • 'a'：追加写入，若文件不存在则创建。
  • 'r'：只读模式（无法写入）。

2.4 读取文件内容

函数：file_get_contents() 和 file()

// 一次性读取整个文件为字符串  
$content = file_get_contents('data.txt');  
echo $content;  

// 将文件按行读取为数组  
$lines = file('data.txt');  
foreach ($lines as $line_num => $line) {  
    echo "行号 $line_num: $line";  
}

适用场景：

  • file_get_contents() 适合小文件，而大文件建议使用逐行读取（如 fgets()）。

三、进阶操作：目录遍历与文件信息获取

3.1 遍历目录中的文件

函数：scandir() 和 opendir()

// 使用 scandir() 获取目录列表  
$files = scandir('uploads/');  
foreach ($files as $file) {  
    if ($file != '.' && $file != '..') {  
        echo "文件名：$file\n";  
    }  
}  

// 使用 opendir() 逐个读取（适用于大目录）  
$dir = opendir('uploads/');  
while (false !== ($file = readdir($dir))) {  
    if ($file != '.' && $file != '..') {  
        echo "文件名：$file\n";  
    }  
}  
closedir($dir);

注意：scandir() 返回的数组包含 '.'（当前目录）和 '..'（父目录），需过滤掉。

3.2 获取文件信息

函数：stat()、filemtime() 和 filesize()

// 获取文件详细信息  
$info = stat('data.txt');  
echo "文件大小：" . $info['size'] . " 字节\n";  
echo "最后修改时间：" . date('Y-m-d H:i:s', $info['mtime']);  

// 简单获取修改时间  
$last_modified = filemtime('data.txt');  
echo "最后修改时间：" . date('Y-m-d', $last_modified);  

// 获取文件大小（单位：字节）  
$size = filesize('data.txt');  
echo "文件大小：" . $size . " 字节";

用途：这些函数常用于日志分析、缓存策略或文件版本控制。

四、安全与最佳实践

4.1 避免路径遍历攻击

路径遍历漏洞允许攻击者通过特殊路径（如 ../../etc/passwd）访问受限文件。解决方案包括：

  • 白名单验证：限制允许的文件类型和路径。
  • 规范化路径：使用 realpath() 清理用户输入的路径。
// 示例：安全的文件读取  
$user_input = '../secret/file.txt';  
$safe_path = realpath(__DIR__ . '/' . $user_input);  
if ($safe_path && strpos($safe_path, __DIR__) === 0) {  
    // 允许操作  
} else {  
    die("非法路径！");  
}

4.2 权限管理

  • 目录权限：通常设置为 0755（所有者可读写执行，其他用户可读执行）。
  • 文件权限：避免 0777（完全开放权限），建议 0644（所有者可读写，其他用户只读）。

五、综合案例：构建简易文件管理系统

5.1 需求分析

实现一个简单的文件管理界面，支持以下功能：

  1. 列出目录下的文件。
  2. 上传新文件。
  3. 删除指定文件。

5.2 实现代码

<?php  
$upload_dir = 'uploads/';  

// 创建上传目录（如果不存在）  
if (!is_dir($upload_dir)) {  
    mkdir($upload_dir, 0755, true);  
}  

// 处理文件上传  
if ($_SERVER['REQUEST_METHOD'] === 'POST') {  
    $file = $_FILES['userfile'];  
    $target_path = $upload_dir . basename($file['name']);  

    if (move_uploaded_file($file['tmp_name'], $target_path)) {  
        echo "文件上传成功！";  
    } else {  
        echo "上传失败，请检查权限。";  
    }  
}  

// 列出文件  
echo "<h2>文件列表：</h2>";  
$files = scandir($upload_dir);  
foreach ($files as $file) {  
    if ($file !== '.' && $file !== '..') {  
        echo "<div>";  
        echo "<a href='{$upload_dir}{$file}'>下载：$file</a> | ";  
        echo "<a href='?delete={$file}' onclick='return confirm(\"确定删除？\");'>删除</a>";  
        echo "</div>";  
    }  
}  

// 处理删除请求  
if (isset($_GET['delete'])) {  
    $file = basename($_GET['delete']);  
    $target = $upload_dir . $file;  
    if (unlink($target)) {  
        echo "文件 $file 已删除。";  
    } else {  
        echo "删除失败。";  
    }  
}  
?>  

<!-- HTML 表单 -->  
<form method="post" enctype="multipart/form-data">  
    <input type="file" name="userfile">  
    <input type="submit" value="上传">  
</form>

功能说明：

  • 通过 scandir() 展示文件列表。
  • 使用 move_uploaded_file() 安全上传文件。
  • 通过 unlink() 删除文件，并结合用户确认弹窗。

结论

PHP 5 的 Filesystem 函数库为开发者提供了强大而灵活的文件操作能力。从基础的文件读写到进阶的目录遍历，再到安全实践，掌握这些工具能显著提升开发效率和代码健壮性。本文通过案例演示了如何构建一个简易文件管理系统，鼓励读者在实际项目中实践这些函数，并关注权限控制与输入验证，以避免常见的安全漏洞。

未来，随着 PHP 版本的迭代（如 PHP 7+ 引入的 opendir() 的异步支持），文件系统操作会更加高效，但 PHP 5 的核心函数仍是理解后续版本的重要基础。希望本文能帮助开发者在 PHP 文件系统领域迈出扎实的第一步。

最新发布

查看更多文章