PHP文件处理：读取、处理与写入教程

在PHP开发中，文件处理是一项基础且常用的任务。无论是读取配置文件、处理用户上传的数据，还是生成报告，都离不开对文件的读写操作。本教程将通过一个实际案例——读取学生成绩、提高分数并写入新文件，来详细讲解PHP中文件处理的核心概念和实践技巧。

核心文件操作函数

在PHP中，进行文件读写主要会用到以下几个关键函数：

• file(string $filename, int $flags = 0, resource $context = null): array|false: 此函数将整个文件读入一个数组。数组的每个元素对应文件中的一行，并包含该行的换行符。
• fopen(string $filename, string $mode, bool $use_include_path = false, resource $context = null): resource|false: 此函数用于打开一个文件或URL。$mode参数决定了文件的打开方式，例如'w'表示写入模式（如果文件不存在则创建，如果存在则截断）。
• fwrite(resource $handle, string $string, int $length = 0): int|false: 此函数用于向文件写入内容。$handle是fopen()返回的文件资源，$string是要写入的字符串。
• fclose(resource $handle): bool: 此函数用于关闭一个已打开的文件指针。在完成文件操作后，务必关闭文件资源，以释放系统资源并确保数据完整性。

实践案例：成绩处理脚本

假设我们有一个名为 grades.txt 的文件，其中每行包含一个学生的成绩（0-5）。我们的任务是：

1. 读取 grades.txt 中的所有成绩。
2. 将每个成绩提高1分，但如果成绩已经是5分，则保持不变。
3. 将提高后的成绩写入 results.txt 文件，每个成绩占一行。
4. 同时在控制台输出提高后的成绩。

示例文件 grades.txt 内容：

0
4
1
3
2
4

预期输出 results.txt 和控制台：

1
5
2
4
3
5

实现步骤与代码解析

我们将分步构建这个PHP脚本。

步骤 1：读取原始成绩

使用 file() 函数将 grades.txt 的内容一次性读取到一个数组中。

<?php $grades = file("grades.txt");
// $grades 现在是一个数组，例如：['0\n', '4\n', '1\n', '3\n', '2\n', '4\n']
?>

注意事项： file() 函数读取的每行数据都包含行末的换行符（如 \n）。在进行数值计算前，需要将这些字符串转换为整数。

步骤 2：准备输出文件

使用 fopen() 函数以写入模式 ('w') 打开 results.txt。如果文件不存在，它将被创建；如果文件已存在，其内容将被清空。

<?php // ...
$resultsFileHandle = fopen("results.txt", "w");

// 检查文件是否成功打开
if ($resultsFileHandle === false) {
    die("Error: Could not open results.txt for writing.");
}
?>

步骤 3：遍历处理并写入成绩

现在，我们需要遍历 grades 数组，对每个成绩进行处理，然后写入 results.txt 并输出到控制台。

<?php // ...
foreach ($grades as $index => $gradeLine) {
    // 1. 将每行字符串转换为整数
    // (int) 类型转换会自动忽略字符串末尾的换行符和空格
    $grade = (int) $gradeLine;

    // 2. 根据条件处理成绩
    $raisedGrade = $grade; // 默认不提高
    if ($grade != 5) {
        $raisedGrade = $grade   1;
    }

    // 3. 将处理后的成绩写入 results.txt
    // 确保每个成绩占一行，所以需要手动添加换行符
    fwrite($resultsFileHandle, $raisedGrade . "\n");

    // 4. 同时输出到控制台
    echo $raisedGrade . "\n";
}
?>

步骤 4：关闭文件资源

在所有写入操作完成后，使用 fclose() 关闭 results.txt 的文件句柄。这是非常重要的一步，可以确保所有数据都被刷新到磁盘，并释放系统资源。

<?php // ...
fclose($resultsFileHandle);
?>

完整示例代码

将以上步骤整合，形成完整的PHP脚本：

<?php // 1. 从 grades.txt 读取所有成绩到数组
$grades = file("grades.txt");

// 检查文件是否成功读取
if ($grades === false) {
    die("Error: Could not read grades.txt. Please ensure the file exists and has read permissions.");
}

// 2. 打开 results.txt 文件用于写入
// 'w' 模式会清空文件内容或创建新文件
$resultsFileHandle = fopen("results.txt", "w");

// 检查文件是否成功打开
if ($resultsFileHandle === false) {
    die("Error: Could not open results.txt for writing. Please check file permissions.");
}

echo "New grades:\n"; // 打印标题

// 3. 遍历每个成绩，处理并写入新文件，同时输出到控制台
foreach ($grades as $gradeLine) {
    // 将字符串（包含换行符）转换为整数
    $grade = (int) $gradeLine;

    // 根据业务逻辑提高成绩
    $raisedGrade = $grade;
    if ($grade != 5) {
        $raisedGrade = $grade   1;
    }

    // 将提高后的成绩写入 results.txt，并添加换行符
    fwrite($resultsFileHandle, $raisedGrade . "\n");

    // 同时在控制台输出提高后的成绩
    echo $raisedGrade . "\n";
}

// 4. 关闭 results.txt 文件句柄
fclose($resultsFileHandle);

echo "Processing complete. Raised grades written to results.txt.\n";

?>

运行与验证

1. 创建 grades.txt 文件，并填充上述示例内容。
2. 将上述PHP代码保存为 process_grades.php。
3. 在命令行中运行 php process_grades.php。
4. 检查控制台输出，并查看 results.txt 文件内容是否符合预期。

常见问题与注意事项

• 文件路径： 确保 grades.txt 和 results.txt 文件位于PHP脚本能够访问的正确路径。如果文件不在同一目录下，需要提供完整或相对路径。
• 文件权限： PHP脚本需要有读取 grades.txt 的权限和写入 results.txt 的权限。如果遇到权限问题，请检查文件或目录的权限设置。
• 数据类型转换： 从文件读取的数据通常是字符串。在进行数值运算前，务必进行适当的类型转换（如 (int) 或 intval()）。file() 函数读取的行包含换行符，(int) 转换会智能地忽略这些非数字字符。
• 错误处理： 在实际应用中，应该对 file() 和 fopen() 的返回值进行检查，以处理文件不存在或无法打开等错误情况，提高脚本的健壮性。
• 文件截断： 以 'w' 模式打开文件会清空其现有内容。如果需要追加内容而不是覆盖，请使用 'a' (append) 模式。
• 资源管理： 始终记得在文件操作完成后使用 fclose() 关闭文件句柄，避免资源泄露。

总结

通过本教程，您已经掌握了PHP中进行文件读取、处理和写入的基本流程。理解 file()、fopen()、fwrite() 和 fclose() 等核心函数的使用，以及数据类型转换和错误处理的重要性，将帮助您高效地处理各种文件相关的编程任务。在实际开发中，根据具体需求灵活运用这些技巧，可以构建出功能强大且稳定的文件处理脚本。

以上是PHP文件处理：读取、处理与写入教程的详细内容。更多信息请关注PHP中文网其他相关文章！