PHP stream_get_contents 读取后为何拿不到第二遍：资源指针、偏移与 rewind 边界

调试 PHP 导入脚本时，经常会遇到一个看似奇怪的结果：同一个资源第一次用 stream_get_contents 能读到内容，紧接着再读却只剩空字符串。多数时候不是数据丢了，而是资源指针已经停在 EOF。只要把读取位置、偏移参数和回退动作分开看，问题就很清楚。

stream_get_contents 默认从当前指针向后读；想从头再读，先调用 rewind，想从指定位置读取则明确传入 offset，并检查它是否超过文件尾。

第一次读取成功，第二次为什么变成空字符串

下面用内存流模拟一个可重复测试的资源。stream_get_contents 读取的是当前指针之后的内容，第一次调用会把指针推到末尾：

这里的关键不是 stream_get_contents 只允许调用一次，而是第一次调用已经消费了从当前位置到 EOF 的全部字节。第二次调用仍然遵守“从当前指针继续读取”的规则，所以得到空字符串，feof 也会报告已经到达文件尾。

用 rewind 重新读取时，先确认资源支持定位

对 php://memory 这类可定位资源，重新读取前调用 rewind 即可：

rewind($handle);
$again = stream_get_contents($handle);

if ($again === $first) {
    echo "rewind 后内容一致\n";
}

rewind 会把指针移回开头，但它不是所有流的通用“重试按钮”。文件和内存流通常支持定位；读取 socket、管道或某些网络响应时，数据可能已经被消费，不能假设还能回到开头。生产代码里可以先用 stream_get_meta_data($handle)['seekable'] 判断，再决定回退还是把第一次结果缓存下来。

offset 不是长度：从指定位置读取的边界

stream_get_contents 的第二个参数是长度，第三个参数才是 offset。要从第 11 个字节开始读取，可以这样写：

rewind($handle);
$tail = stream_get_contents($handle, -1, 11);
echo $tail;

如果 offset 超过资源长度，结果会是空字符串；如果只给第二个参数，它表示最多读取多少字节，不会改变起始位置。中文内容还要注意 offset 按字节计算，不按汉字个数计算，直接截断多字节字符可能得到不完整的 UTF-8 片段。

把读取逻辑写成不容易误用的函数

业务层通常不需要让调用方操心指针状态。下面的函数只接收可定位资源，每次调用都从开头取得完整内容：

function readFromStart($handle): string
{
    $meta = stream_get_meta_data($handle);
    if (empty($meta['seekable'])) {
        throw new RuntimeException('stream is not seekable');
    }

    if (rewind($handle) === false) {
        throw new RuntimeException('cannot rewind stream');
    }

    return stream_get_contents($handle);
}

如果资源不可定位，就在第一次读取时保存返回值，例如 $body = stream_get_contents($handle)，后续解析都使用 $body。这样比尝试再次读取网络流更可靠，也能避免同一请求被不同模块重复消费。

常见误区与检查清单

• 把空字符串当成“文件为空”：先检查 ftell、feof 和当前指针，而不是马上重新下载。
• 把 offset 当成长度：按“长度、偏移”两个参数的位置核对调用。
• 无条件调用 rewind：先确认 seekable，不可定位流改为缓存。
• 忽略返回值：读取失败、空内容和已经读完都可能表现为相近的结果，要结合资源状态判断。

相关问题

stream_get_contents 和 fread 有什么区别？

stream_get_contents 适合从当前位置一次取出指定范围；fread 更适合按固定块大小循环读取，处理大文件时可以控制单次内存占用。

调用 rewind 后 feof 会变成 false 吗？

对可定位资源，成功回到开头后通常可以继续读取；实际判断仍应以新的读取结果和资源状态为准，不要只依赖一个标志位。

怎样让多个解析器共享同一份流内容？

最稳妥的办法是第一个消费者读取后缓存字符串，再把字符串传给多个解析器；共享同一资源指针会形成隐式的消费顺序。

小结

PHP 流读取的核心是“当前位置”。第一次 stream_get_contents 后读不到第二遍，通常只是指针已经到达 EOF。可定位资源用 rewind 回到开头，不可定位资源则缓存第一次结果；涉及 offset 时再核对长度与字节边界，基本就能避开这类重复读取问题。