PHP fopen()：打开、读取和写入文件（模式详解）

fopen('data.txt', 'r') 打开一个文件并返回一个句柄，也就是一个流资源，其他文件函数都把它作为第一个参数。用 fgets()（一行）或 fread()（指定字节数）读取，用 fwrite() 写入，用 fclose() 关闭。第二个参数是模式：'r' 读取，'w' 写入，'a' 追加。

<?php
$fh = fopen('fruits.txt', 'w');          // create or empty the file
fwrite($fh, "apple\n");
fwrite($fh, "banana\n");
fwrite($fh, "cherry\n");
fclose($fh);

$fh = fopen('fruits.txt', 'r');
if ($fh === false) {
    exit("Cannot open fruits.txt\n");
}

while (($line = fgets($fh)) !== false) {
    echo 'Got: ', rtrim($line), "\n";
}
fclose($fh);

输出：

Got: apple
Got: banana
Got: cherry

fopen() 无法打开文件时返回 false（r 模式下文件不存在、文件夹不存在、没有权限），PHP 还会输出类似这样的警告：

Warning: fopen(missing.txt): Failed to open stream: No such file or directory in /home/index.php on line 2

所以使用句柄之前要先检查是否为 false。如果要一次性读取或写入整个小文件，file_get_contents() 和 file_put_contents() 写起来更短；fopen() 适用于分段读取或需要保持打开的文件。

fopen 的模式

有两行常让人意外。r+ 在原位置覆盖已有的字节，而不是插入；a+ 总是写到末尾，即使你用 fseek() 移动了指针也一样（移动指针只影响读取）：

<?php
file_put_contents('letters.txt', "abc\n");

$fh = fopen('letters.txt', 'r+');
fwrite($fh, 'X');                  // overwrites the "a"
fclose($fh);
echo file_get_contents('letters.txt');

$fh = fopen('letters.txt', 'a+');
fseek($fh, 0);                     // back to the start...
fwrite($fh, "end\n");              // ...but the write still goes to the end
rewind($fh);
echo fgets($fh);                   // reads do start at the beginning
fclose($fh);
echo file_get_contents('letters.txt');

输出：

Xbc
Xbc
Xbc
end

在 Windows 上你可能会看到 'rb' 或 'wb'：b 标志表示二进制模式，可以阻止 Windows 转换行尾符。它在 Linux 和 macOS 上没有任何作用，所以加上它既无害，又便于跨平台。

用 fgets() 逐行读取文件

fgets() 返回下一行（包括末尾的 \n），到达文件末尾时返回 false。因为内存中每次只有一行，这个循环能处理任意大小的日志文件，你还可以用 break 提前结束：

<?php
file_put_contents('app.log', <<<LOG
2026-03-14 09:00:01 INFO  server started
2026-03-14 09:00:05 ERROR database timeout
2026-03-14 09:01:12 INFO  request /home
2026-03-14 09:02:40 ERROR disk full
2026-03-14 09:03:00 INFO  request /about
LOG);

$fh = fopen('app.log', 'r');
$number = 0;
$errors = [];

while (($line = fgets($fh)) !== false) {
    $number++;
    if (str_contains($line, 'ERROR')) {
        $errors[] = "line $number: " . trim(substr($line, 26));
    }
}
fclose($fh);

echo count($errors), " errors in $number lines\n";
echo implode("\n", $errors), "\n";

输出：

2 errors in 5 lines
line 2: database timeout
line 4: disk full

要用 !== 与 false 比较，不要直接写 while ($line = fgets($fh))：一行只有 "0" 且没有换行符时（文件的最后一行可能就是这样），它是假值，会让循环提前结束。

用 fwrite() 写入和追加

fwrite() 在当前位置写入一个字符串，返回写入的字节数，失败时返回 false。fputs() 是同一个函数的别名。用 'a' 打开文件，就能在末尾添加内容，而不改动已有的内容：

<?php
$fh = fopen('visits.log', 'a');
foreach (['/home', '/about', '/contact'] as $page) {
    $bytes = fwrite($fh, "visit $page" . PHP_EOL);
    echo "wrote $bytes bytes\n";
}
fclose($fh);

$fh = fopen('visits.log', 'a');      // open again: the old lines stay
fwrite($fh, 'visit /home' . PHP_EOL);
fclose($fh);

echo file_get_contents('visits.log');

输出：

wrote 12 bytes
wrote 13 bytes
wrote 15 bytes
visit /home
visit /about
visit /contact
visit /home

PHP_EOL 是 PHP 所在系统的行尾符（Linux 和 macOS 上是 \n，Windows 上是 \r\n）。对于要给其他程序读取的文件，明确选定一种，通常是 "\n"。

用 fgetcsv() 和 fputcsv() 读写 CSV 文件

fputcsv() 把一个数组写成一行 CSV，并给含有逗号、引号或换行符的字段加上引号。fgetcsv() 把一行读回为数组。要显式传入分隔符、包围符和空的转义字符：这样得到的是标准 CSV，而且在 PHP 8.4 中省略转义参数会输出弃用提示。

<?php
$rows = [
    ['name', 'city', 'note'],
    ['Ada', 'London', 'likes "math", a lot'],
    ['Linus', 'Helsinki', 'kernel'],
];

$fh = fopen('people.csv', 'w');
foreach ($rows as $row) {
    fputcsv($fh, $row, ',', '"', '');
}
fclose($fh);
echo file_get_contents('people.csv'), "\n";

// Read it back, using the first row as keys
$fh = fopen('people.csv', 'r');
$header = fgetcsv($fh, null, ',', '"', '');
while (($fields = fgetcsv($fh, null, ',', '"', '')) !== false) {
    $person = array_combine($header, $fields);
    echo "{$person['name']} lives in {$person['city']}: {$person['note']}\n";
}
fclose($fh);

输出：

name,city,note
Ada,London,"likes ""math"", a lot"
Linus,Helsinki,kernel

Ada lives in London: likes "math", a lot
Linus lives in Helsinki: kernel

用 explode(',', $line) 分割行，一旦字段里含有逗号就会出错；fgetcsv() 会替你处理引号。对于用分号分隔的文件（在欧洲的 Excel 导出文件中很常见），把 ';' 作为分隔符传入。

用 fseek()、ftell() 和 rewind() 在文件中移动

打开的文件有一个当前位置。读取和写入都从这里开始，并让位置向前移动。ftell() 告诉你当前位置，fseek() 把它移动到某个字节偏移量，rewind() 回到开头。用 w+ 模式，你可以通过同一个句柄写入文件再把它读回来：

<?php
$fh = fopen('message.txt', 'w+');
fwrite($fh, 'hello world');
echo ftell($fh), "\n";             // after the last byte written

fseek($fh, 6);
echo fread($fh, 5), "\n";          // 5 bytes from offset 6

rewind($fh);
echo stream_get_contents($fh), "\n";  // everything from the position to the end
fclose($fh);

输出：

11
world
hello world

用 flock() 给文件加锁

两个请求同时读取一个计数器、加一再写回去，可能都读到 41，又都写入 42。使用 LOCK_EX 的 flock() 会让第二个请求等待，直到第一个释放锁。这里正好用 c+ 模式：它会在需要时创建文件，而且与 w+ 不同，它不会在你拿到锁之前清空文件。

<?php
function increment(string $path): int
{
    $fh = fopen($path, 'c+');
    flock($fh, LOCK_EX);               // wait for exclusive access

    $count = (int) stream_get_contents($fh);
    $count++;

    ftruncate($fh, 0);                 // empty the file
    rewind($fh);
    fwrite($fh, (string) $count);
    fflush($fh);

    flock($fh, LOCK_UN);
    fclose($fh);
    return $count;
}

for ($i = 0; $i < 3; $i++) {
    echo 'Visitor number ', increment('counter.txt'), "\n";
}

输出：

Visitor number 1
Visitor number 2
Visitor number 3

锁是建议性的：它只能阻止同样调用了 flock() 的其他代码。如果只是追加一行，file_put_contents($path, $line, FILE_APPEND | LOCK_EX) 一次调用就能做到同样的事。

常见错误：while (!feof($fh))

很多老教程用 feof() 控制循环。它只有在某次读取已经碰到末尾之后才返回 true，所以循环会比行数多跑一次，最后一次 fgets() 返回 false：

<?php
file_put_contents('abc.txt', "a\nb\nc\n");

$fh = fopen('abc.txt', 'r');
$rounds = 0;
while (!feof($fh)) {
    $line = fgets($fh);
    $rounds++;
    var_dump($line);
}
fclose($fh);
echo "$rounds rounds for 3 lines\n";

输出：

string(2) "a
"
string(2) "b
"
string(2) "c
"
bool(false)
4 rounds for 3 lines

多出来的这个 false 会变成报表中的一个空行，或者数组中的一个空元素。应该直接以读取操作作为循环条件，即 while (($line = fgets($fh)) !== false)，本页的其他示例都是这样写的。