PHP Conference Nagoya 2025

套接字上下文选项

套接字上下文选项套接字上下文选项列表

说明

套接字上下文选项可用于所有工作在套接字上的封装协议,像 tcp, httpftp

可选项

bindto

用户 PHP 访问网络的指定的 IP 地址(IPv4 或 IPv6 其中的一个)和/或 端口号,这个语法是 ip:port。 设置 IP 或者 port 为 0 将会让系统选择 IP 或 port。

注意:

由于 FTP 在正常操作时会创建两个 socket 连接,因此无法使用此选项指定端口号。

backlog

用于限制 socket 监听队列中未完成连接的数量。

注意:

这仅适用于 stream_socket_server()

ipv6_v6only

覆盖有关 IPv4 映射到 IPv6 的操作系统默认值。

注意:

[::] 上存在绑定的时候,当尝试在各自的 Ipv4 地址上监听,这是尤其重要。

这仅适用于 stream_socket_server()

so_reuseport

即使来自不同的进程,也能对同一个 ip:port 对进行多个绑定。

注意:

这仅适用于 stream_socket_server()

so_broadcast

允许向广播地址发送数据,从广播地址接收数据。

注意:

这仅适用于 stream_socket_server()

tcp_nodelay

设置此选项为 true 将相应地设置 SOL_TCP,NO_DELAY=1, 从而禁用 TCP Nagle 算法。

更新日志

版本 说明
7.1.0 添加 tcp_nodelay
7.0.1 添加 ipv6_v6only

示例

示例 #1 基础的 bindto 用法示例

<?php
// 使用 IP '192.168.0.100' 连接到互联网
$opts = array(
'socket' => array(
'bindto' => '192.168.0.100:0',
),
);


// 使用 IP '192.168.0.100' 和端口 '7000' 连接到互联网
$opts = array(
'socket' => array(
'bindto' => '192.168.0.100:7000',
),
);


// 使用 IPv6 地址 '2001:db8::1' 和端口 '7000' 连接到互联网
$opts = array(
'socket' => array(
'bindto' => '[2001:db8::1]:7000',
),
);


// 使用端口 '7000' 连接到互联网
$opts = array(
'socket' => array(
'bindto' => '0:7000',
),
);


// 创建上下文...
$context = stream_context_create($opts);

// ...并使用它来读取数据
echo file_get_contents('http://www.example.com', false, $context);

?>

添加备注

用户贡献的备注 2 notes

up
9
mix at ater dot me
5 years ago
The right way for forcing IPv6 is 'bindto' => '[::]:0'
up
2
guru at jnt-finland dot fi
9 years ago
You can set "bindto" to "0:0" to force use IPv4 instead of IPv6. And probably "[0]:0" to force use IPv6, thou this I couldn't test.
To Top