PHP 8.6 的 stream 支持 TLS 会话复用与 0-RTT:session_data 和 early_data 怎么用
PHP 8.6 计划 2026-11-19 GA,feature freeze 在 2026-09-22。这个版本给 stream 层加了一批 TLS 能力:会话复用、TLS 外部 PSK、TLS 1.3 early data(0-RTT),都通过 stream context 选项暴露,不需要绕到 openssl_* 函数去自己做握手。
会话复用的 RFC 在 。
会话复用:新增的九个 context 选项
全部挂在 ssl context 下:
session_data:把上次握手得到的会话数据带进来,尝试恢复。session_new_cb:新会话协商完成时触发,用来把会话数据存到进程外。session_cache:决定会话走进程内缓存,还是交给回调管理。session_cache_size:缓存条目上限。session_timeout:会话有效期。session_id_context:会话 ID 的上下文标识,服务端区分不同服务时用。session_get_cb/session_remove_cb:自定义服务端会话的读取与移除。num_tickets:TLS 1.3 session ticket 数量。
对应三件事:跨请求保存与恢复客户端会话、实现自定义的服务端会话存储、控制会话缓存行为。同时新增 Openssl\Session 类承载会话对象。
跨请求恢复的写法
思路是「先握手一次,把会话搬出去,下次带回来」。
第一次连接正常握手,在 session_new_cb 里把会话数据落进 Redis 或文件:
$ctx = stream_context_create([
'ssl' => [
'verify_peer' => true,
'session_new_cb' => function ($stream, $sessionData) use ($redis) {
// 回调签名以 PHP 手册为准
$redis->setex('tls:sess:' . $key, 3600, $sessionData);
},
],
]);
$stream = stream_socket_client('tls://example.com:443', $errno, $errstr, 5, STREAM_CLIENT_CONNECT, $ctx);
后续请求把取回来的会话数据塞进 session_data,握手阶段就会尝试恢复,省掉一次完整密钥交换:
$ctx = stream_context_create([
'ssl' => [
'verify_peer' => true,
'session_data' => $redis->get('tls:sess:' . $key),
],
]);
session_cache 决定会话是留在进程内缓存,还是完全交给 session_get_cb / session_remove_cb 处理。多进程或多机部署时,进程内缓存基本没用,得靠回调把会话放到共享存储;单进程长驻的场景(常驻 worker、CLI 守护进程)留在本地缓存更省事。session_cache_size 和 session_timeout 分别控住缓存体积和过期时间,别让会话无限堆积。
服务端侧如果要自己管 session store,session_id_context 要按服务区分设置,否则不同服务之间的会话标识会混。
TLS 外部 PSK
新增 psk_client_cb 和 psk_server_cb 两个 context 选项,客户端用前者提供 PSK,服务端用后者接收并校验 PSK。配套的类是 Openssl\Psk。这条路径不依赖证书,适合设备间或内部服务之间已经预共享密钥的场景。
TLS 1.3 early data
客户端用 early_data 选项在握手完成前就把数据发出去;服务端用 max_early_data 表示愿意接受多少字节,并通过 early_data_cb 拿到这段数据。
服务端接受 early data 的片段:
$ctx = stream_context_create([
'ssl' => [
'local_cert' => '/etc/ssl/server.pem',
'max_early_data' => 8192,
'early_data_cb' => function ($stream, $data) use ($log) {
$log->info('early data', ['len' => strlen($data)]);
// 只处理可重放的操作
},
],
]);
$server = stream_socket_server(
'tls://0.0.0.0:8443',
$errno,
$errstr,
STREAM_SERVER_BIND | STREAM_SERVER_LISTEN,
$ctx
);
结果不在返回值里,而是落在 stream_get_meta_data() 的 crypto.early_data 中,取值是 accepted、rejected、not_sent 三者之一:
$meta = stream_get_meta_data($stream);
$status = $meta['crypto']['early_data'] ?? 'not_sent';
switch ($status) {
case 'accepted':
// 服务端收下了,early data 生效
break;
case 'rejected':
// 服务端拒绝,早发的数据没有生效,必须在握手完成后重发
fwrite($stream, $payload);
break;
case 'not_sent':
// 本次没有发 early data,走正常握手后的写入
fwrite($stream, $payload);
break;
}
rejected 分支必须处理。服务端可能因为 anti-replay 策略、ticket 过期或 max_early_data 配置不匹配而拒绝,此时早发的数据不会被应用层看到,客户端不能假设它已经送达,要按普通请求重发一次。
0-RTT 只适合幂等请求
early data 在握手完成前就发出,天然可被重放——这是 TLS 1.3 的既有性质,不是 PHP 的实现问题。服务端在缺少 anti-replay 机制时应把 early data 当作可重放数据处理。因此 0-RTT 适合幂等请求:读接口、静态资源拉取、可重复执行的查询。登录、支付、下单这类有副作用的操作不要走 early data,宁可等完整握手。
新增类与函数
Openssl\Session:会话对象,配合session_data/ 回调使用。Openssl\Psk:外部 PSK 对象。Openssl\OpensslException:OpenSSL 相关异常。stream_socket_get_crypto_status():读取流的加密状态,early data 结果也可以从这条路径拿。
8.6 里其他 stream 变更
同一版本还加了 stream 错误 API:StreamError / StreamException、StreamErrorStore / StreamErrorMode / StreamErrorCode、stream_last_errors()、stream_clear_errors(),以及 error_mode / error_store / error_handler 三个 context 选项。socket context 新增 so_keepalive / so_linger / so_rcvbuf / so_sndbuf,另有 filter.max_filter_count 限制过滤器数量。
会话复用这块,先把 session_new_cb 的落盘和 session_data 的恢复跑通,再决定 session_cache 交给谁管,比一上来就配一堆回调更稳。