编程 PHP 8.6:keepalive、SO_LINGER、收发缓冲,现在直接在 stream_context_create 里配

2026-11-18 21:01:33

PHP 8.6:keepalive、SO_LINGER、收发缓冲,现在直接在 stream_context_create 里配

PHP 8.6 之前,想给一个 stream socket 打开 TCP keepalive 或者设置 SO_LINGER,得先把 stream 导出成 Socket 对象:

$server = stream_socket_server('tcp://0.0.0.0:8080', $errno, $errstr);

$sock = socket_import_stream($server);
socket_set_option($sock, SOL_SOCKET, SO_KEEPALIVE, 1);
socket_set_option($sock, SOL_TCP, TCP_KEEPIDLE, 30);

socket_import_stream() + socket_set_option() 这两步能用,但导出之后走的是 Socket 那条路径,stream wrapper 的缓冲和错误处理就绕过去了。PHP 8.6 把这些选项收进了 stream_context_create() 的 socket 上下文,创建 stream 时一并下发。

一个 context 数组就能完成设置

同一段 keepalive 配置改成:

$ctx = stream_context_create([
    'socket' => [
        'so_keepalive'  => true,
        'tcp_keepidle'  => 30,   // 空闲多少秒开始探测
        'tcp_keepintvl' => 10,   // 探测间隔
        'tcp_keepcnt'   => 3,    // 探测次数
    ],
]);

$server = stream_socket_server(
    'tcp://0.0.0.0:8080',
    $errno,
    $errstr,
    STREAM_SERVER_BIND | STREAM_SERVER_LISTEN,
    $ctx
);

stream_socket_client() 同样接受这个 context,把 $ctx 作为第六个参数传进去即可。

新增选项与取值边界

选项作用
so_reuseaddr控制地址复用(SO_REUSEADDR),可关闭
so_keepalive开关 keepalive
tcp_keepidle / tcp_keepintvl / tcp_keepcntkeepalive 的空闲时间、探测间隔、探测次数
so_linger设置 TCP 的 SO_LINGER
so_rcvbuf / so_sndbuf设置 SO_RCVBUF / SO_SNDBUF,单位为字节

几个需要注意的边界条件:

so_rcvbuf / so_sndbuf 必须是 1 到 2147483647 之间的整数。 传其他值(0、负数、超出上界的数、非整数)会让 stream 创建直接失败,不是警告,是失败。另外,设置窗口大小不等于内核会按这个值来分配,操作系统可能做 round、cap 或其他调整,甚至可能因此不再自动调节这个缓冲区,所以读回来的值和请求值不一致是正常的。

so_linger 超过 65535 会被 clamp。 正值表示开启 linger 并等待对应秒数,0 或负数表示关闭 linger。由于部分平台上 linger 时间是 unsigned short,超过 65535 的取值会被压到这个上限。

so_reuseaddr => false 在 Windows 上走的是 SO_EXCLUSIVEADDRUSE。 即显式独占绑定,而不是简单地不设 SO_REUSEADDR。

三组配置片段

TCP 探活。 长连接或者经过 NAT / 负载均衡的连接,服务端和客户端都可能长时间没有数据往来,靠 keepalive 探测对端是否还在。注意 tcp_keepidle 这些是秒级参数,设得太激进会增加无谓的探测包:

$ctx = stream_context_create([
    'socket' => [
        'so_keepalive'  => true,
        'tcp_keepidle'  => 60,
        'tcp_keepintvl' => 15,
        'tcp_keepcnt'   => 4,
    ],
]);

短连接与 close 行为。 so_linger 给正值,close 会等待发送缓冲区里的数据送出(或超时)再返回,避免数据还没发完连接就被拆掉。设为 0 或负数则是关闭 linger,回到默认行为。密集短连接场景下不要把 linger 秒数设大,阻塞的是当前进程:

$ctx = stream_context_create([
    'socket' => [
        'so_linger'      => 2,
        'so_reuseaddr'   => false, // 不希望别的进程复用这个地址
    ],
]);

收包缓冲。 高吞吐、单个连接上有突发流量的场景,抬一下接收缓冲,减少应用层来不及 fread 时的丢包。给的值只是请求值,内核会按 net.core.rmem_max 之类的限制做调整:

$ctx = stream_context_create([
    'socket' => [
        'so_rcvbuf' => 4 * 1024 * 1024,
        'so_sndbuf' => 1 * 1024 * 1024,
    ],
]);

$client = stream_socket_client(
    'tcp://api.example.com:80',
    $errno,
    $errstr,
    5,
    STREAM_CLIENT_CONNECT,
    $ctx
);

UDP socket 同样支持 so_rcvbuf / so_sndbuf。

同批落地的其他 streams 变更

PHP 8.6 的 streams 部分还有几处改动,和上面这批选项一起发布:

  • filtered stream 现在可以转换成 file descriptor,用于 select。
  • 新增 stream 错误 API:StreamError / StreamException 类,StreamErrorStore / StreamErrorMode / StreamErrorCode 枚举,以及 stream_last_errors() 和 stream_clear_errors(),通过 error_mode / error_store / error_handler 三个 stream context 选项控制行为。
  • php://filter 新增 filter.max_filter_count context 选项:URL 里叠加的 filter 数量超过配置值时,打开 stream 会失败并给出警告;设为负值则关闭这个限制。

这批 socket 选项的完整说明在 PHP 8.6 migration 页面 和源码包的 UPGRADING 文件里。

复制全文 生成海报 PHP Socket 运维

推荐文章

程序员茄子在线接单