大网数据广告活动
PHP 语言与运行手册

socket_write · 向套接字写数据

· 52CE 我爱测

可选参数 length 可以指定写入 socket 的字节长度。如果写入的字节长度大于 data 的长度,默认将被截取为 data 长度。

socket_write

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

socket_write — 向套接字写数据

说明

function socket_write(Socket $socket, string $data, ?int $length = null): int|false

函数 socket_write() 向 socket 写入 data。

参数

socket

data

要写入到缓冲区的数据。

length

可选参数 length 可以指定写入 socket 的字节长度。如果写入的字节长度大于 data 的长度,默认将被截取为 data 长度。

返回值

返回成功写入 socket 的字节数 或者在失败时返回 false。可以通过调用 socket_last_error() 来检索实际的错误码。将错误码作为参数传递给 socket_strerror() 以获得错误的文本解释。

注意:

对于 socket_wirte() 来说返回 0 是完全有效的,这代表没有字节被写入。如果发生错误,务必使用 === 运算符来判断是否为 false。

更新日志

版本 说明
8.0.0 现在 socket 是 Socket 实例, 之前是 resource。
8.0.0 length 现在允许为 null。

注释

注意:

socket_write() 不一定会写入 data 的所有字节。根据网络缓冲区等因素,即使 data 较长,也可能只写入部分数据,甚至是一个字节。必须使用循环来确保已完整传输剩余 data。

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。