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_keepcnt | keepalive 的空闲时间、探测间隔、探测次数 |
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_countcontext 选项:URL 里叠加的 filter 数量超过配置值时,打开 stream 会失败并给出警告;设为负值则关闭这个限制。
这批 socket 选项的完整说明在 PHP 8.6 migration 页面 和源码包的 UPGRADING 文件里。