应使用 fopen() + fread() 分块读取大文件，避免 file_get_contents() 等一次性加载导致内存暴涨；s3 场景用 storage::readstream() 配合流式处理；csv 解析需限制行长、统一编码并用生成器封装，确保内存恒定。
直接用 file_get_contents() 或 Storage::get() 读整个大文件，PHP 进程内存立刻飙到几 GB —— 这不是配置调得高就能扛住的，是设计层面的错误姿势。
用 fopen() + fread() 分块读取原始文件
这是最可控、最低开销的方式，尤其适合日志、CSV、纯文本等无格式大文件。核心是避免一次性载入，靠指针移动 + 固定缓冲区控制内存峰值。
- 别用
file()或file_get_contents()，它们会把整文件塞进内存再切数组，1GB 文件 = 至少 1GB PHP 内存 - 用
fopen($path, 'rb')打开二进制流，配合fread($fp, 8192)每次只读 8KB（可调） - 手动处理换行符或分隔符：比如 CSV 行末是
\n，需在缓冲区里找断点，不能简单按字节切 - 记得
fclose($fp)，否则句柄泄漏；异常时也要确保关闭，建议用try/finally
Storage::readStream() 适用于 S3 或远程磁盘
当文件存在对象存储（如 AWS S3、MinIO）时，readStream() 返回原生 PHP 流资源，可直接传给 fread() 或 stream_copy_to_stream()，不落地、不缓存全量内容。
PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
- 本地 disk 不推荐用它，因为底层仍是
file_get_contents()封装，没节省内存 - S3 场景下必须配好
streaming相关选项，例如'stream' => true在 S3 客户端配置中开启 - 别对 stream 调
filesize()或stat()，S3 不支持随机 seek，会触发完整 HEAD 请求甚至下载 - 若要边读边解析 CSV，可用
League\Csv\Reader::createFromStream()接这个 stream，它内部做缓冲和行切分
逐行处理 CSV 时别踩 fgetcsv() 的坑
fgetcsv() 看似方便，但默认行为会尝试读整行 —— 如果某行超长（比如字段含大段 JSON），缓冲区溢出导致内存暴涨或解析失败。
- 显式传入长度参数：
fgetcsv($fp, 4096)，限制单行最大字节数，超出部分截断或报错，防止 OOM - 确保 CSV 文件编码统一（如 UTF-8），否则
fgetcsv()可能误判引号、逗号位置，导致行错位 - 字段含换行符？标准 CSV 允许，但
fgetcsv()默认不跨行解析 —— 必须保证文件生成时正确转义，否则需换用更鲁棒的解析器（如spout） - 别在循环里反复
fseek($fp, 0)重置，S3 stream 不支持，本地文件也会破坏顺序读性能
用生成器封装流式逻辑，复用且可控
把文件读取 + 行解析打包成生成器函数，调用方用 foreach 消费，内存恒定在几 MB，还能组合其他流式操作（如过滤、转换）。
- 函数内用
yield $row，不要 collect 到数组；生成器退出后资源自动释放 - 示例：
foreach (csvRows('/var/log/app.log') as $line) { process($line); }，csvRows()内部就是fopen+fgetcsv循环 - 生成器里别做阻塞 IO（如 HTTP 请求、DB 查询），否则整个流卡住；耗时操作应提前拉取或扔队列
- 如果需要“断点续传”，得把当前文件偏移量（
ftell($fp)）持久化，下次从该位置继续，而不是依赖行号
真正难的不是选哪个函数，而是判断哪段逻辑必须流式（如读文件）、哪段可以缓存（如映射规则）、哪段必须落地（如生成临时索引文件）——比如读 500MB CSV 时，解析行用生成器，但写入数据库必须用 chunkById() 配合批量 SQL，两者节奏不同，中间还得防 GC 滞后拖慢吞吐。
