PHP原生不支持异步非阻塞文件IO：8.3及之前所有版本的fopen()、file_get_contents()等默认同步阻塞，无内置事件循环；需依赖amphp/file等库配合ext-uv等扩展实现真正异步。
PHP原生不支持异步非阻塞文件IO
直接说结论：PHP 8.3 及之前所有稳定版本的 fopen()、file_get_contents()、stream_socket_client() 等原生文件/网络 I/O 操作，**默认全是同步阻塞的**。你无法靠“开启某个开关”或“加个 flag”让它们变成非阻塞——底层 libc 的 read()/write() 调用就是阻塞的，PHP 运行时本身也没有事件循环调度层。
所以，“利用 Composer 库实现 PHP 原生的异步非阻塞文件 IO 分发”这个说法存在根本性误解：Composer 只是包管理器，它不提供运行时能力；真正起作用的是你引入的第三方库（比如 amphp/file、reactphp/filesystem），它们通过用户态协程 + 扩展（如 ext-uv 或 ext-event）或进程/线程模拟来绕过 PHP 原生限制。
amphp/file 是目前最实用的选择
如果你真需要在单进程内并发读写多个文件且不阻塞主线程（比如同时处理 100 个日志片段），amphp/file 是当前生态里最轻量、兼容性最好、文档最清晰的方案。它依赖 amphp/amp 提供协程调度，底层可选 ext-uv（推荐）或 ext-event，Windows 下也能跑（靠 libuv 的兼容层）。
常见错误现象：
– 安装后 Amp\Promise 报错 “EventLoop not running” —— 忘了用 Amp\Loop::run() 包裹入口；
– file_get_contents() 被替换成 File::get() 后返回空或超时 —— 没启用 ext-uv，回退到了低效的轮询模式。
立即学习“PHP免费学习笔记（深入）”；
- 必须先安装扩展：
pecl install uv（Linux/macOS）或从 预编译包 获取 Windows 版 - 在
php.ini中启用：extension=uv - 代码入口必须用
Amp\Loop::run()启动事件循环，不能直接执行协程函数 -
File::read()和File::write()返回Promise，需yield或await（在协程内）
示例（读取两个大文件并行）：
use Amp\Loop;
use Amp\File;
Loop::run(function () {
$promises = [
File::read('/var/log/syslog'),
File::read('/var/log/auth.log'),
];
$results = yield Amp\Promise\all($promises);
var_dump(strlen($results[0]), strlen($results[1]));
});
ReactPHP filesystem 不适合纯文件场景
reactphp/filesystem 名字有误导性：它本质是为配合 reactphp/http 做请求体临时文件流转设计的，**没有实现真正的异步文件读写**。它的 read() 内部仍是 file_get_contents()，只是包装成 Promise 并扔进 React 的事件循环——但 I/O 本身仍阻塞当前 tick。并发读 10 个文件？实际还是串行，只是回调时机可控。
使用场景仅限于：
– 接收 HTTP 上传时，把 tmp_name 文件异步移到目标位置（move 操作是原子的，快）；
– 配合 React\Stream\ReadableStreamInterface 做流式转发，而非随机读取。
容易踩的坑：
– 误以为 $filesystem->read() 是非阻塞的，结果压测时 CPU 100%、响应延迟飙升；
– 在 CLI 脚本里单独用它，没启动 React\EventLoop\Loop::run()，Promise 永远不 resolve。
别碰 pthreads 或 parallel 扩展做“伪异步”
有人想用 parallel\run() 开多个线程去调 file_get_contents()，这看似“并发”，实则代价极高：每个线程都带完整 PHP 解释器副本，内存暴涨；文件句柄数受系统限制（ulimit -n）；线程间无共享状态，结果要序列化传递——对中小规模文件 IO 来说，往往比单线程更慢。
性能影响明显：
– 读 50 个 1MB 文件，amphp/file（uv）耗时约 120ms；parallel\run() 耗时常超 800ms（含线程创建/销毁开销）；
– parallel 不支持 Windows，pthreads 自 PHP 7.2 起已废弃。
真正该用多线程的场景只有：
– 文件内容需 CPU 密集型处理（如图像缩放、XML 解析）；
– 且你已确认磁盘 I/O 不是瓶颈（SSD + 大缓存），否则线程全卡在 wait io 上。
关键点始终是：异步文件 IO 的有效性高度依赖底层扩展支持，不是光靠 Composer require 就能生效。没 ext-uv 或 ext-event，所有“异步”库都只能降级为模拟，吞吐和延迟会断崖下跌。别跳过扩展安装验证这一步。
