node.js 直连 php 时需通过复用 http 连接(keep-alive)和 tls 会话来减少握手开销;关键在于 node.js 复用 http.agent 实例并配置 keepalive: true,同时确保 php 服务端(如 nginx)支持长连接与 tls 会话缓存。

Node.js 直连 PHP(比如通过 http 或 https 请求 PHP 后端)本身没有“隐藏连接复用技巧”,但你真正想解决的,是频繁短连接带来的 TCP 握手 + TLS 握手开销。关键不在 Node.js 或 PHP 哪边“藏技巧”,而在 HTTP 客户端是否启用连接复用(keep-alive)并正确管理底层 socket。
HTTP 客户端必须显式启用 keep-alive
Node.js 默认的 http.request() 和 https.request() 不会自动复用连接——除非你手动配置 agent。不配 agent,每次请求都新建 socket,三次握手 +(若 HTTPS)TLS 握手全来一遍。
实操建议:
- 用
http.Agent或https.Agent实例,设置keepAlive: true、maxSockets: 10(按 PHP 后端并发能力调整) - 全局复用同一个 agent 实例,不要每次请求都 new 一个
- PHP 端需响应头包含
Connection: keep-alive(现代 Apache/Nginx + PHP-FPM 默认支持,但若用了某些代理或自定义 SAPI 可能被覆盖)
PHP 端不能关闭 keep-alive 或过早 timeout
即使 Node.js 配了 keep-alive,如果 PHP 所在 Web 服务器主动断开空闲连接,复用就失效。典型表现:Node.js 日志里反复出现 socket hang up 或 ECONNRESET。
立即学习“PHP免费学习笔记(深入)”;
常见问题点:
- Nginx 默认
keepalive_timeout是 75s,但若 PHP-FPM 的request_terminate_timeout或pm.max_requests触发进程重启,可能中断长连接 - Apache 的
KeepAliveTimeout若设为 5s,而 Node.js 请求间隔略超,连接就被回收 - PHP 脚本末尾调用
fastcgi_finish_request()后继续执行,可能延迟响应结束,干扰连接复用判断
避免 request() 每次都重配 options
很多人写法是每次 http.request({ hostname, port, path, method, agent: new http.Agent(...) }),这等于白配——新 agent 实例无法复用已有 socket。
正确做法:
- 提前创建 agent:
const agent = new http.Agent({ keepAlive: true, maxSockets: 20 }) - 所有请求共用它:
http.request({ ..., agent }) - 如需区分 PHP 环境(dev/staging/prod),可为每个 endpoint 创建独立 agent,而非每次 new
- 注意 agent 的
maxFreeSockets(默认 256)一般不用调,但若 PHP 后端只有单台且连接数有限,可适当降低防堆积
HTTPS 场景下 TLS session reuse 更关键
HTTPS 握手比 HTTP 开销大得多。光有 HTTP keep-alive 不够,还得让 TLS 层复用 session ticket 或 session ID。
Node.js 默认已启用 TLS session reuse(只要 agent 复用 + 服务端支持),但要注意:
- PHP 端 Nginx 需开启
ssl_session_cache shared:SSL:10m和ssl_session_timeout 4h - 若 Node.js 请求目标域名有多个(如 api-v1.example.com / api-v2.example.com),不同域名的 TLS session 不共享,得靠 SNI + server name hint 支持
- 用
curl -v https://your-php-endpoint观察响应头是否有Reusing existing connection!类提示(libcurl 日志),或抓包看是否跳过 ServerHello Done
真正卡住复用的,往往不是代码写了没写 keepAlive: true,而是 agent 实例没复用、PHP 侧 timeout 太短、或 HTTPS 证书/ALPN 协商失败导致 fallback 到全量握手。先确认连接是否真的复用了(netstat 查 ESTABLISHED 数、Wireshark 看 handshake 包数量),再调参。











