正确命令是按需安装具体组件而非 react/react 元包；react/react 仅装 event-loop 基础依赖，不包含 HTTP/DNS/Socket 等扩展，易致依赖膨胀与版本锁定。
ReactPHP 的 Composer 安装命令写对了吗？
直接运行 composer require react/react 就能装上核心组件，但别急着跑——它只装 react/event-loop 和基础依赖，不包含 HTTP、DNS、Stream 等常用扩展。你真正需要的，往往不是 react/react 这个“元包”，而是按需引入具体组件。
- 要开 HTTP 服务？补装
composer require react/http - 要处理 TCP 连接？加
composer require react/socket - 要发异步 DNS 查询？装
composer require react/dns - 用
react/react元包会导致不必要的依赖膨胀，且版本锁定更死，推荐跳过
为什么 require 后 new React\EventLoop\StreamSelectLoop() 报错？
常见错误是 PHP 版本或扩展缺失：ReactPHP v1.x 要求 PHP ≥ 7.1，v2.x（当前稳定版）强制要求 PHP ≥ 8.0；同时 ext-mbstring 是硬依赖，ext-sockets 在 Linux/macOS 基本可用，但 Windows 上若没启用，StreamSelectLoop 会 fallback 到低效轮询，而 ExtEventLoop 或 UvLoop 更快但需额外扩展支持。
- 检查 PHP 版本：
php -v，低于 8.0 就别硬上 v2.x - 确认扩展加载：
php -m | grep -E 'mbstring|sockets|uv|event' - Windows 下优先试
composer require react/event-loop:^1.4（v1.x 最后维护版），避免 uv/event 扩展坑 -
StreamSelectLoop是纯 PHP 实现，兼容性最好但性能最差，别在压测环境默认用它
autoload 后 React\EventLoop\Factory::create() 不自动选最优 Loop？
这个工厂方法确实会按顺序尝试 UvLoop → ExtEventLoop → StreamSelectLoop，但前提是对应扩展已加载且可用。它不会报错提示“为啥没选 uv”，而是静默降级——你得自己验证实际用的是哪个：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
use React\EventLoop\Factory; $loop = Factory::create(); var_dump(get_class($loop)); // 看输出是 UvLoop 还是 StreamSelectLoop
- 如果期望用
UvLoop却拿到StreamSelectLoop，大概率是ext-uv没装或版本不匹配（如 uv 扩展编译时 PHP 版本和运行时不一致） - 某些 Docker 镜像（如
php:8.2-cli）默认不含ext-uv，需手动docker-php-ext-install uv并确认php.ini加了extension=uv.so - 生产环境别依赖工厂自动选型，显式 new 更可控：
new UvLoop()+ try/catch 回退
引入 ReactPHP 后 Composer 自动加载变慢、内存占用升高？
ReactPHP 组件大量使用匿名函数、动态类名和运行时反射（尤其在 react/promise 和 react/async 中），加上 Composer 的 PSR-4 自动加载路径较多，冷启动时扫描开销明显。这不是 bug，是事件驱动框架的典型权衡。
立即学习“PHP免费学习笔记（深入）”；
- 开发阶段开启 OPcache 并配置
opcache.enable_cli=1，能显著缓解 CLI 场景下的重复解析 - 避免在循环中反复
require_once或手动includeReactPHP 文件——Composer autoloader 已覆盖全部 - 如果项目同时用 Laravel/Symfony，注意它们的 EventDispatcher 和 ReactPHP Loop 互不兼容，别试图混用；ReactPHP 必须独占主事件循环
- 调试时用
composer dump-autoload -o生成优化后的 classmap，比 PSR-4 查找快，但牺牲开发期文件新增的即时性
ReactPHP 的“轻量”是相对传统阻塞框架而言的，它的灵活性和可组合性代价就是加载链路更长、运行时抽象层更多。想压到极致，就得接受手动管理 Loop 实例和组件生命周期——没人替你兜底。
