深入浅出：PHP 文件操作

引言

在开发Web应用时，文件系统操作是不可或缺的一部分。无论是上传用户文件、记录日志，还是读取配置文件，PHP 提供了丰富的内置函数和类来帮助我们高效地管理文件和目录。本文将深入探讨 PHP 中的文件系统操作，帮助你掌握如何轻松处理文件和目录。

文件的基本操作

打开文件

在 PHP 中，使用 fopen() 函数可以打开一个文件。fopen() 返回一个文件指针，用于后续的读写操作。常见的模式包括：

• r：只读模式，文件必须存在。
• w：写入模式，如果文件存在则清空内容，如果不存在则创建新文件。
• a：追加模式，如果文件存在则在末尾追加内容，如果不存在则创建新文件。
• r+：读写模式，文件必须存在。
• w+：读写模式，如果文件存在则清空内容，如果不存在则创建新文件。
• a+：读写模式，如果文件存在则在末尾追加内容，如果不存在则创建新文件。

<?php
$file = fopen("example.txt", "r");
if ($file) {echo "File opened successfully.";
} else {echo "Failed to open file.";
}
?>

这段代码尝试以只读模式打开 example.txt 文件，并输出相应的结果。

读取文件

逐行读取

使用 fgets() 函数可以逐行读取文件内容。这在处理大文件时非常有用，因为它不会一次性将整个文件加载到内存中。

<?php
$file = fopen("example.txt", "r");
if ($file) {while (($line = fgets($file)) !== false) {echo $line . "\n";}fclose($file);
} else {echo "Failed to open file.";
}
?>

这段代码会逐行读取 example.txt 文件的内容并输出每一行。

读取整个文件

如果你需要一次性读取整个文件的内容，可以使用 file_get_contents() 函数。它会返回文件的全部内容作为字符串。

<?php
$content = file_get_contents("example.txt");
if ($content !== false) {echo $content;
} else {echo "Failed to read file.";
}
?>

这段代码会读取 example.txt 文件的全部内容并输出。

写入文件

追加写入

使用 fopen() 函数以追加模式 (a) 打开文件，然后使用 fwrite() 或 fputs() 函数写入内容。这样可以在文件末尾添加新的内容，而不会覆盖原有内容。

<?php
$file = fopen("example.txt", "a");
if ($file) {fwrite($file, "This is a new line.\n");fclose($file);echo "Content appended successfully.";
} else {echo "Failed to open file.";
}
?>

这段代码会在 example.txt 文件末尾追加一行新内容。

覆盖写入

使用 fopen() 函数以写入模式 (w) 打开文件，然后使用 fwrite() 或 fputs() 函数写入内容。这样会清空文件的原有内容，并用新内容替换。

<?php
$file = fopen("example.txt", "w");
if ($file) {fwrite($file, "This is the new content.\n");fclose($file);echo "Content written successfully.";
} else {echo "Failed to open file.";
}
?>

这段代码会覆盖 example.txt 文件的原有内容，写入新的内容。

关闭文件

使用 fclose() 函数可以关闭文件指针。关闭文件是非常重要的，因为它释放了文件资源，确保数据正确保存。

<?php
$file = fopen("example.txt", "r");
if ($file) {// 读取或写入文件的操作fclose($file);echo "File closed successfully.";
} else {echo "Failed to open file.";
}
?>

这段代码在完成文件操作后关闭了文件指针。

文件和目录的管理

检查文件或目录是否存在

使用 file_exists() 函数可以检查文件或目录是否存在。这对于避免不必要的错误非常重要。

<?php
$filename = "example.txt";
if (file_exists($filename)) {echo "File exists.";
} else {echo "File does not exist.";
}
?>

这段代码会检查 example.txt 文件是否存在，并输出相应的结果。

创建和删除文件

使用 touch() 函数可以创建一个空文件，或者更新现有文件的时间戳。使用 unlink() 函数可以删除文件。

<?php
$filename = "newfile.txt";// 创建文件
if (touch($filename)) {echo "File created successfully.";
} else {echo "Failed to create file.";
}// 删除文件
if (unlink($filename)) {echo "File deleted successfully.";
} else {echo "Failed to delete file.";
}
?>

这段代码会创建一个名为 newfile.txt 的文件，然后删除它。

创建和删除目录

使用 mkdir() 函数可以创建目录，使用 rmdir() 函数可以删除空目录。如果要删除非空目录，可以使用递归方法或第三方库（如 RecursiveDirectoryIterator）。

<?php
$dirname = "newdir";// 创建目录
if (mkdir($dirname)) {echo "Directory created successfully.";
} else {echo "Failed to create directory.";
}// 删除目录
if (rmdir($dirname)) {echo "Directory deleted successfully.";
} else {echo "Failed to delete directory.";
}
?>

这段代码会创建一个名为 newdir 的目录，然后删除它。

复制和移动文件

使用 copy() 函数可以复制文件，使用 rename() 函数可以移动或重命名文件。

<?php
$source = "example.txt";
$destination = "copied_example.txt";// 复制文件
if (copy($source, $destination)) {echo "File copied successfully.";
} else {echo "Failed to copy file.";
}// 移动文件
if (rename($destination, "moved_example.txt")) {echo "File moved successfully.";
} else {echo "Failed to move file.";
}
?>

这段代码会复制 example.txt 文件为 copied_example.txt，然后将其重命名为 moved_example.txt。

处理文件权限

设置文件权限

使用 chmod() 函数可以设置文件的权限。权限值通常以八进制表示，例如 0644 表示所有者可读写，其他用户只读。

<?php
$filename = "example.txt";
if (chmod($filename, 0644)) {echo "Permissions set successfully.";
} else {echo "Failed to set permissions.";
}
?>

这段代码会将 example.txt 文件的权限设置为 0644。

获取文件权限

使用 fileperms() 函数可以获取文件的权限信息。返回值是一个整数，可以通过位运算符解析具体的权限。

<?php
$filename = "example.txt";
$permissions = fileperms($filename);echo "File permissions: " . decoct($permissions & 0777) . "\n";
?>

这段代码会输出 example.txt 文件的权限，格式化为八进制表示。

处理文件属性

获取文件大小

使用 filesize() 函数可以获取文件的大小，单位为字节。

<?php
$filename = "example.txt";
$size = filesize($filename);echo "File size: " . $size . " bytes\n";
?>

这段代码会输出 example.txt 文件的大小。

获取文件最后修改时间

使用 filemtime() 函数可以获取文件的最后修改时间，返回值是一个 Unix 时间戳。

<?php
$filename = "example.txt";
$last_modified = filemtime($filename);echo "Last modified: " . date("Y-m-d H:i:s", $last_modified) . "\n";
?>

这段代码会输出 example.txt 文件的最后修改时间。

使用 SPL 进行文件操作

PHP 提供了标准库（SPL）中的多个类来简化文件和目录的操作。以下是两个常用的类：

DirectoryIterator 类

DirectoryIterator 类用于遍历目录中的文件和子目录。它提供了简单的方法来访问每个条目。

<?php
$dir = new DirectoryIterator(".");foreach ($dir as $file) {if ($file->isFile()) {echo "File: " . $file->getFilename() . "\n";} elseif ($file->isDir() && !$file->isDot()) {echo "Directory: " . $file->getFilename() . "\n";}
}
?>

这段代码会遍历当前目录中的所有文件和子目录，并分别输出文件和目录的名称。

FilesystemIterator 类

FilesystemIterator 类是 DirectoryIterator 的扩展，提供了更多的选项来控制遍历行为。例如，你可以选择是否忽略点文件（. 和 ..）。

<?php
$dir = new FilesystemIterator(".", FilesystemIterator::SKIP_DOTS);foreach ($dir as $file) {echo "Entry: " . $file->getFilename() . "\n";
}
?>

这段代码会遍历当前目录中的所有条目，并忽略点文件。

综合案例

让我们通过一个更复杂的例子来巩固所学的知识。假设我们要编写一个程序，该程序接收用户输入的文件名，检查文件是否存在，如果存在则读取文件内容并显示；如果不存在则提示用户创建新文件并写入初始内容。

<?php
function handleFile($filename) {if (file_exists($filename)) {echo "File exists. Reading content:\n";$content = file_get_contents($filename);if ($content !== false) {echo $content;} else {echo "Failed to read file.";}} else {echo "File does not exist. Creating new file and writing initial content.\n";$file = fopen($filename, "w");if ($file) {fwrite($file, "This is the initial content of the file.\n");fclose($file);echo "File created and initial content written successfully.";} else {echo "Failed to create file.";}}
}// 获取用户输入
$user_filename = readline("Please enter the filename: ");// 处理文件
handleFile($user_filename);
?>

这段代码展示了如何结合文件操作函数来处理用户输入，并根据不同的情况作出响应。

参考资料

• PHP 官方文档 - Filesystem Functions
• W3Schools - PHP Filesystem
• Real PHP - Working with Files in PHP
• PHP The Right Way - Filesystem
• PHP SPL Documentation

欢迎在评论区互动，彼此交流相互学习！ 😊