ReactPHP异步事件循环在PHP7中需手动调用$loop->run()启动，为单线程协作式轮询机制；禁用sleep等阻塞函数，改用addTimer等异步API，并依赖react/http等非阻塞组件实现高并发。
ReactPHP 的异步事件循环在 PHP7 里跑起来，核心就一条：**必须手动启动事件循环（run()），且不能被阻塞式代码打断**。它不是自动运行的后台线程，而是单线程、协作式的轮询机制。
1. 安装与基础运行结构
确保用 Composer 安装 ReactPHP 核心组件：
composer require react/event-loop
最简可运行示例：
$loop = React\EventLoop\Factory::create();
$loop->addTimer(2.0, function () {
echo "2秒后执行\n";
});
$loop->run(); // ⚠️ 关键！不调用这句，什么都不会发生
这段代码会等 2 秒后输出，然后退出。没有 $loop->run()，定时器注册了也永远不会触发。
立即学习“PHP免费学习笔记（深入）”；
2. PHP7 下要注意的兼容细节
ReactPHP v1.x（主流稳定版）完全支持 PHP7.0+，但需避开几个常见坑：
已弃用 — 请改用 `auth0` 技能（运行 `npx clawhub install auth0`）。适用于为 React 单页应用（SPA）添加 Auth0 登录、登出、受保护路由或用户会话功能。该技能集成 `@auth0/auth0-react` — 即使用户仅表述为“为我的 React 应用添加登录功能”或“保护我的 React 路由”，而未明确提及 Auth0，也应使用此技能。
-
别用
sleep()或usleep()：它们会彻底阻塞事件循环，导致所有定时器、I/O 回调暂停。要用$loop->addTimer()或$loop->futureTick()模拟延迟。 -
避免同步网络调用：比如
file_get_contents('http://...')或原生mysqli_connect()。这些会卡住整个循环。应改用 ReactPHP 生态的异步客户端（如react/http-client、react/mysql）。 -
扩展依赖要装对：PHP7 默认启用
ext-event（libevent 绑定）或ext-ev（libev 绑定）时，ReactPHP 会自动优先使用它们提升性能；没装则回落到纯 PHP 的StreamSelectLoop（稍慢但完全可用）。
3. 实际跑起来的典型场景
比如启动一个异步 HTTP 服务器：
$loop = React\EventLoop\Factory::create();
$socket = new React\Socket\Server('127.0.0.1:8080', $loop);
$http = new React\Http\Server($socket, $loop);
$http->on('request', function ($request, $response) {
$response->writeHead(200, ['Content-Type' => 'text/plain']);
$response->end("Hello from ReactPHP!\n");
});
echo "Server running on http://127.0.0.1:8080\n";
$loop->run(); // 启动后一直监听，直到被信号终止
此时进程常驻，接收请求、处理响应、触发回调——全靠 $loop->run() 驱动内部的 select/poll/epoll（或 Windows I/O Completion Ports）系统调用轮询文件描述符状态。
4. 调试与观察循环是否在跑
加个每秒打印的定时器，确认循环活跃：
$loop->addPeriodicTimer(1.0, function ($timer) {
echo "[tick] Loop is alive at " . date('H:i:s') . "\n";
});
如果看到持续输出，说明循环正常运转；如果只打一次或不打，大概率是 run() 没调、提前退出、或被异常中断（记得用 try/catch 包住关键逻辑）。
不复杂但容易忽略：ReactPHP 不是“开箱即异步”，它是靠你主动交出控制权给事件循环，并用非阻塞方式写逻辑。PHP7 提供了更稳定的底层支持，但写法思维得从“顺序执行”转向“事件驱动”。
