PHP php://temp 怎样控制内存与临时文件切换

PHP 的 php://temp 适合承接“大小暂时不确定，但又需要一个可读写临时流”的数据。它会先把内容放在内存里，累计数据达到阈值后再转为临时文件；默认阈值是 2 MB，也可以在路径后用 /maxmemory:NN 按字节指定。这里的阈值控制的是存储介质切换，不是“最多只能写多少字节”。

官方手册：https://www.php.net/manual/en/wrappers.php.php

最常用的写法是 fopen('php://temp/maxmemory:524288', 'w+')：先把 512 KB 作为内存阈值，写入后用 rewind() 回到流开头，再读取内容。超过阈值并不会自动报容量错误，而是由 PHP 使用临时文件继续承接数据。

php://temp 到底什么时候切到临时文件

php://temp 和 php://memory 都是可读写的临时流，但两者的资源策略不同：php://memory 始终把数据放在内存中；php://temp 在数据量达到预设内存阈值后使用临时文件。PHP 手册还说明，这个临时文件的位置按 sys_get_temp_dir() 的规则决定。

因此，“控制内存”应该理解成控制愿意让临时流在内存中保留多少。例如缩略图元数据、短文本或小型 CSV 片段可以给出较高阈值；上传内容、导出结果或中间归档大小波动较大时，可以给出较低阈值，让大对象更早转到临时文件。它不会替你限制业务输入，也不会替代请求体大小限制。

用 maxmemory 指定阈值并打开可读写流

/maxmemory:NN 中的 NN 是字节数，不是带单位的字符串。下面把 512 KB 转成字节，使用 w+ 打开一个既能写又能读的流，并在每个可能失败的资源操作处保留错误处理。

这里的 512 * 1024 只是一个示例值。把阈值抽成配置时，建议在进入 fopen() 前把配置换算成明确的正整数，并记录业务上允许的内存预算。不要把 maxmemory 误写成“最大文件大小”；它只决定内存承接到什么程度。

为什么写完直接读取会得到空内容

临时流仍然遵循文件指针规则。fwrite() 完成后，指针在已写内容的末尾；此时直接调用 stream_get_contents()，读取的是“当前位置之后的剩余内容”，自然可能得到空字符串。需要完整读取时，先调用 rewind()。

当数据本身可能很大时，不要为了读取临时流又一次性复制出完整字符串。可以保持流式读取，下面的示例把一个输入流分块写入 php://temp，再分块读出；代码只展示指针、阈值和错误边界，不依赖本地文件或真实运行结果。

四个容易混淆的边界

另外，临时文件位置由运行环境的临时目录规则决定，部署时应确认 PHP 进程对该目录具备所需权限。某些扩展如果要求标准 I/O 流，把内存流转换成标准流可能失败；这是扩展与平台边界，不能只靠调大阈值解决。

怎样选择一个合适的阈值

可以先按数据的常态大小和并发数估算，而不是只看单个请求：单个临时流的内存阈值越大，多个并发请求同时停留在内存中的总量越可能上升。对可接受延迟且通常很小的数据给出适中阈值；对大小波动明显的导出或上传中间结果，给出较低阈值，再用应用层的输入大小限制保护总量。

最终可以记住三件事：php://temp 的阈值控制内存与临时文件的切换；rewind() 决定能否从头读取；fclose() 负责结束当前句柄生命周期。把这三点和打开失败、临时目录权限、读写返回值一起处理，通常就能避免“内存占用不可控”和“写完读不到”的两类问题。

php://temp 的默认内存阈值是多少？

PHP 官方手册当前说明默认值为 2 MB。需要不同策略时，用 php://temp/maxmemory:NN 明确传入字节数，不要依赖默认值表达业务预算。

超过阈值后会立刻删除内存中的内容吗？

不要把实现细节理解成业务可见的删除动作。对调用方而言，它仍是同一个可读写流；你只需要继续写入、在正确的位置读取，并在结束时关闭句柄。

可以用 php://temp 替代上传大小限制吗？

不可以。它解决的是临时数据的承接方式，不能代替请求体、文件大小、并发量和磁盘空间等业务及运行环境限制。