嫉谪衬映集成特性架构这个集成分三层C 层nxt_php_sapi.c, nxt_php_extension.c在 PHP 里注册 TrueAsync SAPI给每个请求创建协程通过 nxt_unit_run() 管理事件循环通过 nxt_unit_response_write_nb() 实现非阻塞数据传输PHP 扩展层NginxUnit 命名空间NginxUnit\Request - 请求对象NginxUnit\Response - 响应对象支持非阻塞发送NginxUnit\HttpServer::onRequest() - 注册请求处理器用户代码entrypoint.php通过 HttpServer::onRequest() 注册处理器使用 Request/Response API完全异步执行请求流程HTTP 请求 → NGINX Unit → nxt_php_request_handler()↓创建协程 (zend_async_coroutine_create)↓nxt_php_request_coroutine_entry()↓创建 Request/Response 对象↓调用 entrypoint.php 中的回调函数↓response-write() → nxt_unit_response_write_nb()↓response-end() → nxt_unit_request_done()非阻塞 I/O调用 $response-write($data) 时数据通过 nxt_unit_response_write_nb() 发送缓冲区满了剩余数据进 drain_queue缓冲区空出来触发 shm_ack_handler异步写入不阻塞协程配置unit-config.json{applications: {my-php-async-app: {type: php,async: true, // 启用 TrueAsync 模式processes: 2, // 工作器数量entrypoint: /path/to/entrypoint.php,working_directory: /path/to/,root: /path/to/}},listeners: {127.0.0.1:8080: {pass: applications/my-php-async-app}}}重要async: true 会激活 TrueAsync SAPI而不是标准的 PHP SAPI。加载配置curl -X PUT --data-binary unit-config.json \--unix-socket /tmp/unit/control.unit.sock \http://localhost/configentrypoint.php基本结构use NginxUnit\HttpServer;use NginxUnit\Request;use NginxUnit\Response;set_time_limit(0);// 注册请求处理器HttpServer::onRequest(static function (Request $request, Response $response) {// 拿请求数据$method $request-getMethod();$uri $request-getUri();// 设响应头$response-setHeader(Content-Type, application/json);$response-setStatus(200);// 发数据非阻塞$response-write(json_encode([message Hello from TrueAsync!,method $method,uri $uri]));// 结束响应$response-end();});API 参考RequestgetMethod(): string - HTTP 方法GET、POST 等getUri(): string - 请求 URIgetRequestContext(): ?mixed - 请求上下文TODOgetRequestContextParameters(): ?mixed - 上下文参数TODOcreateResponse(): Response - 创建 Response 对象通常不需要ResponsesetStatus(int $code): bool - 设置 HTTP 状态码setHeader(string $name, string $value): bool - 添加响应头write(string $data): bool - 发送数据非阻塞操作end(): bool - 完成响应并释放资源注意setStatus() 和 setHeader() 要在第一次 write() 之前调用调用过 write() 后响应头就发出去了end() 必须调用完成请求生命周期HttpServer::onRequest(function (Request $req, Response $resp) {// 1. 响应头还能改$resp-setStatus(200);$resp-setHeader(Content-Type, text/plain);// 2. 第一次 write() 把响应头发出去了$resp-write(Hello );// 3. 现在响应头改不了了// $resp-setHeader() → 报错// 4. 可以继续写数据$resp-write(World!);// 5. 结束请求必须调$resp-end();});运行和测试启动 NGINX Unit./build/sbin/unitd \--no-daemon \--log /tmp/unit/unit.log \--state /tmp/unit \--control unix:/tmp/unit/control.unit.sock \--pid /tmp/unit/unit.pid \--modules ./build/lib/unit/modules重要--modules 参数必须加用来加载 PHP 模块。查看日志tail -f /tmp/unit/unit.log测试curl http://127.0.0.1:8080/响应{message: Hello from NginxUnit TrueAsync HttpServer!,method: GET,uri: /,timestamp: 2025-10-04 15:30:00}负载测试wrk -t4 -c100 -d30s http://127.0.0.1:8080/调试GDBgdb ./build/sbin/unitd(gdb) set follow-fork-mode child(gdb) run --no-daemon --log /tmp/unit/unit.log ...设置断点break nxt_php_request_handlerbreak nxt_php_request_coroutine_entrybreak nxt_unit_response_write_nb实用命令# 停止所有 NGINX Unit 进程pkill -9 unitd# 检查控制套接字ls -la /tmp/unit/control.unit.sock# 获取当前配置curl --unix-socket /tmp/unit/control.unit.sock http://localhost/config内部实现初始化nxt_php_extension_init() 在 NginxUnit 命名空间注册类worker 启动时加载 entrypoint.phpHttpServer::onRequest() 把回调存到 nxt_php_request_callback请求处理NGINX Unit 调用 nxt_php_request_handler(req)创建协程zend_async_coroutine_create(nxt_php_request_coroutine_entry)协程指针存到 req协程加入激活队列控制权回到事件循环 nxt_unit_run()协程激活事件循环调用 nxt_unit_response_buf_alloc 回调回调通过 zend_async_coroutine_activate() 激活协程执行 nxt_php_request_coroutine_entry()创建 PHP Request/Response 对象调用用户回调response-end() 后协程结束异步发送response-write() → nxt_unit_response_write_nb()没发完剩下的进 drain_queue缓冲区空了触发 shm_ack_handler()shm_ack_handler 继续写需要的话调 end()未来计划实现 Request::getRequestContext()添加请求头支持添加 POST 数据解析WebSocket 支持流式响应总结NGINX Unit TrueAsync PHP 集成让 PHP 真正拥有了异步处理能力。通过协程机制单个进程可以同时处理多个请求这在过去是无法想象的。对于 PHP 生态来说这是一个重要的转折点。传统的 PHP-FPM 模式下每个请求独占一个进程在高并发场景下资源消耗巨大。现在有了 TrueAsyncPHP 可以像 Node.js、Go 那样高效处理并发请求同时保持语言本身的简洁性。虽然目前还有一些功能在开发中比如完整的请求头支持、POST 数据解析、WebSocket 等但现有的功能已经足够构建高性能的 API 服务。非阻塞 I/O、协程调度、事件循环——这些核心机制都已经就位。对于需要处理高并发请求的 PHP 应用特别是 API 服务、微服务架构NGINX Unit TrueAsync 提供了一个值得认真考虑的选择。它不需要改变太多现有代码结构却能带来性能上的显著提升。