rewind() 仅对可寻址流有效,失败时静默返回 false;需显式检查返回值,且不适用于 'a'/'a+' 模式;调用前须确保流有效、已打开、未关闭,并配合 fflush() 保证写入持久化。

rewind() 只在可寻址(seekable)的流上有效,对 fopen() 打开的普通文件总是可用,但对 php://stdin、php://memory、某些压缩流(如 gzopen() 返回的句柄)或网络流(如 http:// URL)会失败并返回 false。
直接调用 rewind($fp) 前不检查流类型,是 PHP 文件操作中最隐蔽的“静默失效”来源之一。
rewind() 失败时不会报错,但后续读写可能出错
rewind() 返回 bool,成功为 true,失败为 false。它不会抛出异常,也不会触发 warning —— 除非你开了 E_WARNING 并且流底层明确报告错误(极少发生)。
- 常见错误现象:调用
rewind($fp)后,fread($fp, 10)仍从原位置继续读,而不是从开头;fwrite($fp, 'abc')覆盖失败,内容被追加到末尾 - 根本原因:流不可 seek,
rewind()实际没生效,但程序继续执行,误以为已重置 - 必须显式判断返回值:
if (!rewind($fp)) { /* 处理失败 */ } - 不要依赖
ftell($fp)验证:某些非 seekable 流调用ftell()也返回0或旧值,不能作为rewind()成功的依据
以 'a' 或 'a+' 模式打开的文件,rewind() 无效于写入
即使 rewind() 调用成功(返回 true),对 'a' 或 'a+' 模式打开的文件,所有 fwrite() 仍强制追加到文件末尾 —— 这是 PHP 的 POSIX 兼容行为,与指针位置无关。
立即学习“PHP免费学习笔记(深入)”;
- 典型误用场景:想用
fopen('log.txt', 'a+') + rewind() + fwrite()覆盖开头内容,结果日志还是追加在最后 - 正确做法:改用
'r+'模式(需文件存在)或'c+'模式(存在则打开,不存在则创建,不截断) -
'c+'更安全:fopen('data.bin', 'c+')可 seek、可读写、不意外清空文件,适合需要反复覆盖的场景
rewind() 等价于 fseek($fp, 0, SEEK_SET),但不等价于 fflush()
rewind($fp) 底层就是调用 fseek($fp, 0, SEEK_SET) 并清除 errno 和 EOF 标志。但它**不刷新缓冲区**,也不影响已写入但未 flush 的数据。
- 如果之前用
fwrite($fp, 'hello')写了内容但没fflush($fp),再rewind($fp),接着fread($fp, 5)可能读不到 'hello' —— 因为写缓存还没落盘,文件实际长度仍是 0 - 需要确保写入已持久化?先
fflush($fp),再rewind($fp) - 二进制文件尤其敏感:
fwrite()后立即rewind()读取,若没fflush(),很可能读到旧内容或空
PHP 7.4 下 rewind() 的兼容性注意点
PHP 7.4 对资源类型更严格,rewind() 的第一个参数必须是有效的 resource,传入 null、false 或已 fclose() 的句柄会触发致命错误(Fatal error: Uncaught TypeError)。
- 常见坑:
$fp = fopen('missing.txt', 'r'); rewind($fp);——fopen()失败返回false,直接传给rewind()就崩 - 务必前置校验:
if (!$fp = fopen('file.txt', 'r+')) { die('open failed'); } - 不要复用已关闭句柄:
fclose($fp); rewind($fp);在 7.4+ 是明确不允许的 - 替代方案:PHP 7.4+ 推荐用
stream_get_meta_data($fp)['wrapper_type']判断是否为plainfile,再决定能否安全rewind()
文件指针重置这件事,表面看只是调个函数,背后牵扯流类型、打开模式、缓冲状态、PHP 版本约束四层逻辑。漏掉任意一层,rewind() 就变成一个看起来成功、实则失效的“幽灵操作”。


















