在日常的PHP项目开发中，文件读写无疑是常见的操作。我们用 fopen 打开文件，用 fwrite 写入数据，用 fread 读取内容。一切看起来都很顺利，直到有一天，产品经理或安全团队提出了新的需求：
“我们需要对所有敏感文件的读写操作进行详细日志记录，包括写入了什么数据，读取了多少字节。”
“另外，为了数据安全，所有上传的文件在写入磁盘前都必须进行加密，读取时自动解密。”
听到这些需求，你的第一反应可能是在每一个 fopen、fwrite、fread 调用周围加上日志或加密解密逻辑。但很快你就会发现，在一个已经存在的、庞大的代码库中，这种做法简直是噩梦！
立即学习“PHP免费学习笔记（深入）”；
面对的困难与挑战
- 代码侵入性强：你不得不修改散落在项目各处的上百个文件操作点，这不仅工作量巨大，而且极易遗漏或引入新的bug。
- 维护成本高：业务逻辑与I/O增强逻辑（如日志、加密）混杂在一起，使得代码变得臃肿、难以阅读和维护。
- 缺乏通用性：如果未来又需要添加缓存、压缩等功能，你又要重复一遍痛苦的修改过程。
- PHP原生流包装器复杂：虽然PHP提供了强大的流包装器机制，允许我们创建自定义的协议处理器，但对于仅仅是想在现有流操作上添加一些回调逻辑的需求来说，实现一个完整的流包装器显得过于重量级和复杂。
难道就没有一种更优雅、更灵活的方式来解决这个问题吗？答案是肯定的，icewind/streams 库中的 CallBackWrapper 就是你一直在寻找的利器！
icewind/streams：优雅的流回调解决方案
icewind/streams 是一个为PHP提供通用流包装器的库，它允许我们以编程方式创建和管理流包装器。其中，CallBackWrapper 是一个特别实用的组件，它能将回调函数注册到任何现有流的读、写和关闭事件上，而无需修改原始的流操作代码。
想象一下，你有一个文件流 $source，你希望在每次读取、写入和关闭时都执行一些自定义逻辑。CallBackWrapper 就像一个透明的“中间人”，它包裹住你的 $source 流，然后将所有对它的操作都先转发给你的回调函数，再转发给原始流。
如何使用 CallBackWrapper？
首先，通过 Composer 安装 icewind/streams：
composer require icewind/streams
然后，你可以像下面这样使用它：
代码解析：
-
CallBackWrapper::wrap()方法是核心。它接受一个原始流作为第一个参数，然后是三个可选的回调函数：$readCallback、$writeCallback和$closeCallback。 -
$readCallback会在每次fread()操作时被调用，参数$count表示PHP内部缓冲区尝试读取的字节数（注意：这可能与你fread()请求的字节数不同，因为PHP有自己的内部流缓冲机制，通常为8192字节）。 -
$writeCallback会在每次fwrite()操作时被调用，参数$data包含实际写入的数据。 -
$closeCallback会在fclose()操作时被调用。
CallBackWrapper 的优势与实际应用
-
非侵入式与解耦：这是最大的优势！你无需修改任何原始的业务逻辑代码。只需在创建或获取流后，用
CallBackWrapper包装一下，就能透明地添加功能。这使得核心业务逻辑与I/O增强逻辑彻底分离，代码结构更清晰。 - 强大的可观测性：轻松实现文件I/O的实时监控和日志记录。你可以记录谁、何时、向哪个文件写入了什么，或者从哪个文件读取了多少数据，这对于调试、审计和安全监控至关重要。
- 灵活的功能扩展：无需修改底层代码，即可为现有流添加加密/解密、压缩/解压缩、数据校验、内容过滤、甚至是简单的缓存层等功能。
-
易用性：相比于手动实现一个完整的PHP流包装器，
CallBackWrapper的配置和使用要简单直观得多，大大降低了开发难度。 -
测试便利性：在单元测试或集成测试中，你可以用
CallBackWrapper模拟或拦截文件操作，验证I/O行为，而无需实际触碰文件系统，提高测试效率和可靠性。
总结
icewind/streams 及其 CallBackWrapper 为PHP开发者提供了一种强大而优雅的方式来处理文件流操作。它不仅解决了在现有代码中添加I/O增强功能的痛点，还促进了代码的模块化和可维护性。无论你是需要为文件操作添加日志、加密，还是进行更复杂的实时处理，CallBackWrapper 都能让你以最少的代码改动，实现最强大的功能扩展。下次再遇到类似问题，不妨试试这个强大的工具吧！
