ReactPHP 是纯 PHP 异步 I/O 库,非前端 React;需匹配 PHP 版本与扩展(如 ext-event),监听地址须显式设为 0.0.0.0,子进程需手动消费 stdout/stderr 流,其异步仅限 I/O 层,无协程,阻塞操作会卡死事件循环。

ReactPHP 不是前端 React,不能直接在 PHP 里写 JSX 或组件;它是一个纯 PHP 的事件循环(event loop)库,用来做 I/O 密集型异步任务,比如长连接、实时日志推送、高并发 HTTP 客户端请求——但别指望它替代 Swoole 或用它跑 Laravel。
为什么 require_once 'vendor/autoload.php' 后 React\EventLoop\Factory::create() 报错?
常见原因是没装对扩展或 PHP 版本不兼容。ReactPHP v1.x 要求 PHP ≥ 7.1,v2.x(当前主干)要求 PHP ≥ 8.0;如果你用的是 PHP 7.4,必须锁定 "react/event-loop": "^1.4",否则 Factory::create() 会因找不到 ExtEvLoop 或 LibuvLoop 类而失败。
- 检查 PHP 版本:
php -v - 确认已安装
ext-event(Linux/macOS 推荐)或ext-libev(已废弃),否则退化为StreamSelectLoop——性能差、不支持信号和定时器精度低 - 安装时加
--with-event编译参数,或用pecl install event(注意:Windows 下基本不可用)
React\Http\Server 启动后浏览器打不开,连不上 127.0.0.1:8080
ReactPHP 的 Server 默认只监听 127.0.0.1,不是 0.0.0.0;而且它不处理静态文件、不支持 HTTPS(除非你自己套 React\Socket\SecureServer)、也不解析 .htaccess 或路由规则。
- 启动命令要显式绑定地址:
$server->listen(new \React\Socket\TcpServer('0.0.0.0:8080', $loop)) - 防火墙/SELinux 可能拦截端口,先试
telnet 127.0.0.1 8080看是否通 - 别用
localhost浏览器访问——某些系统 DNS 解析慢或走 IPv6,直接输http://127.0.0.1:8080 - HTTP Server 不自动返回 404,你得自己写
$request->writeHead(404),否则请求会 hang 住
用 React\ChildProcess\Process 执行 shell 命令,on('exit') 永远不触发
根本原因:子进程的 stdout/stderr 没被消费完,导致内核缓冲区满,进程卡死在 write 阻塞上——ReactPHP 不会自动帮你读流,必须手动 $process->stdout->on('data', ...)。
- 漏掉
stderr监听也会出问题,尤其命令报错时输出全在 stderr - 如果命令输出超大(比如
tar -czf),不及时$stream->pause()可能 OOM - 别在
on('exit')里再调$loop->stop(),ReactPHP v2+ 的 Loop 是单次运行,stop 后无法重启 - 示例关键片段:
$process->stdout->on('data', function ($chunk) { echo $chunk; });<br>$process->stderr->on('data', function ($chunk) { error_log($chunk); });<br>$process->on('exit', function ($code) { echo "done: $code\n"; });
ReactPHP 的“异步”只体现在 I/O 层,没有协程、不自动调度、所有回调都在同一个进程里串行执行;一旦你在某个 on('data') 回调里写了 sleep(5) 或密集计算,整个 event loop 就卡死。真正的高并发能力,取决于你怎么拆分阻塞点、是否及时释放控制权、以及底层扩展是否启用。别把它当“PHP 版 Node.js”来用,它的定位更接近一个轻量级、可嵌入的事件驱动胶水层。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











