PHP文件与目录操作：路径解析、读写及目录遍历指南

路径解析与基本信息获取

在处理文件之前，准确理解路径字符串的结构至关重要。PHP 提供了一组内置函数用于分析路径组成，例如提取目录名、文件名或扩展名。

第1步：解析路径各组成部分

目的：从完整路径字符串中提取 dirname、basename 等信息。

• 入口：一个表示文件路径的字符串变量 $path。
• 动作：使用 pathinfo($path) 返回关联数组，或使用 dirname() 直接获取目录部分，basename() 获取文件名。
• 重要参数：$path 可以是绝对路径或相对路径。
• 完成状态：成功输出文件的目录路径和具体文件名。

<?php
// 定义一个完整的路径
$path = '/var/www/html/demo/index.php';

// 方法一：使用 pathinfo 一次性获取所有信息
$info = pathinfo($path);
echo '目录: ' . $info['dirname'] . '<br>';
echo '文件名: ' . $info['basename'] . '<br>';
echo '扩展名: ' . $info['extension'] . '<br>';

// 方法二：单独调用函数
echo '独立获取目录: ' . dirname($path) . '<br>';
?>

第2步：将相对路径转换为绝对路径

目的：确保后续文件操作使用的是系统可识别的标准路径。

• 入口：包含 './'、'../' 等语法的相对路径。
• 动作：调用 realpath($path)。
• 结果：若路径有效，返回对应的绝对路径字符串；若路径不存在，返回 false。

<?php
$relativePath = '../config/app.conf';
$absolutePath = realpath($relativePath);
echo $absolutePath ? $absolutePath : '路径无效';
?>

文件的大小、空间与元数据

在进行备份或日志记录前，通常需要检查文件的具体属性，如大小、磁盘剩余空间以及时间戳。

第3步：获取文件大小与磁盘空间

• 文件体积：使用 filesize($filename) 获取字节数。如需显示为 KB/MB，可结合除法运算。
• 磁盘空间：使用 disk_free_space('C:') 获取指定分区的可用空间，单位均为字节。

第4步：获取文件的时间戳

PHP 提供三种常见的时间属性，需注意它们的区别：

1. fileatime()：上次访问时间 (Last Access Time)。
2. filemtime()：内容修改时间 (Last Modification Time)，即最后一次编辑代码或数据的时间。
3. filectime()：元数据修改时间 (Inode Change Time)，包括权限、所有权改变时也会更新此时间。

配合 date('Y-m-d H:i:s', ...) 可将 UNIX 时间戳格式化为可读日期。

文件的创建、写入与追加

写操作是风险最高的环节，务必注意模式选择，防止误覆盖重要数据。

第5步：一次性写入文件内容

适用于简单的文本配置或小量数据持久化。

• 覆盖写：使用 file_put_contents('file.txt', 'content')。如果文件已存在，将被清空后重写。
• 追加写：添加第三个参数 FILE_APPEND：file_put_contents('file.txt', 'new content', FILE_APPEND)。

第6步：流式文件操作（fopen/fwrite/fclose）

当需要处理大文件或复杂的读写逻辑时，建议使用资源句柄方式。

1. 打开文件：
   $fp = fopen('log.txt', 'a+b');
   - a+: 只读并追加（指针指向末尾），不存在则创建。
   - w: 只写，截断文件到0（慎用）。
   - r: 只读，指针在开头。
2. 写入数据：
   使用 fwrite($fp, $data, $length)。注意中文等多字节字符需计算正确的字节长度，通常直接使用字符串本身即可。
3. 锁定文件：
   并发写入时，先调用 flock($fp, LOCK_EX) 获取独占锁，写入后再调用 flock($fp, LOCK_UN) 释放锁。
4. 关闭连接：
   始终执行 fclose($fp) 以释放资源并强制刷盘。

文件的读取操作

第7步：多种读取方式对比

第8步：逐行与逐字符读取

对于超大文件，不能直接 load 进内存，需使用循环：

<?php
$fp = fopen('large_file.log', 'r');
if ($fp) {
    // 方法A：按行读取 (fgets)
    while (!feof($fp)) {
        $line = fgets($fp);
        if ($line === false) break;
        processLogLine($line); 
    }
    fclose($fp);
}
?>

第9步：随机定位读取

使用 fseek($fp, $offset) 调整指针位置，配合 ftell($fp) 获取当前位置，可实现断点续传或跳过文件头部。

目录的操作：遍历与删除

第10步：列出目录内容

• 简单列表：使用 scandir('/path/to/dir')，返回排序后的文件名数组。
• 手动遍历：结合 opendir() 和 readdir()。注意判断返回值是否为空或 '.'/'..' 隐藏目录。

第11步：目录的重命名与删除

• 重命名：rename('old_name', 'new_name')。既可用于文件也可用于目录。
• 删除：rmdir('dir_name')。
• 风险提醒：目录必须为空才能被 rmdir 删除。若要递归删除整个目录树，需编写自定义函数，先删除内部所有文件和子目录，最后再删除父目录。

安全与排错建议

在执行任何文件修改操作（删除、覆盖）前，请遵循以下原则：

1. 存在性检测：操作前先使用 file_exists($path) 验证目标是否存在，避免对不存在的资源报错。
2. 权限检查：确保运行脚本的用户对目标目录具有相应的读写执行权限。
3. 敏感词过滤：如果文件名来自用户输入（如上传），务必进行严格的白名单校验，防止路径遍历攻击（如输入 ../../etc/passwd）。

以上就是PHP文件与目录操作技巧的详细总结。涵盖了从基础的路径解析到高级的流控制与并发锁处理。更多关于PHP文件管理的实践资料请关注本站其它相关文章！