socket_recvfrom
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_recvfrom — 从套接字接收数据,无论它是否是面向连接的
说明
Socket
$socket,string
&$data,int
$length,int
$flags,string
&$address,int
&$port = null): int|false
函数 socket_recvfrom() 使用 socket
从 address 的 port
端口上接收 length 字节数据到 data
中(如果套接字不是 AF_UNIX 类型)。socket_recvfrom()
可用于从已连接或未连接的套接字上收集数据。另外,可以指定一个或多个标志来修改函数的行为。
address 和 port
必须是引用传递。如果套接字不是面向连接的,address
将设置为远程主机的互联网协议地址或 UNIX 套接字路径。如果套接字是面向连接的,address
是 null。另外,在 AF_INET 或 AF_INET6
套接字未连接的情况下,port 将包含远程主机的端口号。
注意: 此函数可安全用于二进制对象。
参数
socket-
socket必须是先前由 socket_create() 创建的 Socket 实例。 data-
收到的数据将提取到
data指定的变量。 length-
最多可从远程主机获取的
length字节数。 flags-
flags的值可以是下列任意 flag 的组合。使用按位或运算符(|)来组合不同的 flag。flags可用值Flag 描述 MSG_OOB处理带外数据。 MSG_PEEK从接收队列的起始位置接收数据,但不将他们从接收队列中移除。 MSG_WAITALL在接受到至少 length字节数据前阻塞。但是,如果接收到中断信号,或远程主机断开链接,函数可能返回不足length字节的数据。MSG_DONTWAIT如果指定了该 flag,即使原有套接字是阻塞的,此函数也不会阻塞。 address-
如果套接字是
AF_UNIX类型,address是文件路径。否则,对于未连接的套接字,address是远程主机的 IP 地址,如果套接字是面向连接的,是null。 port-
此参数只适用于
AF_INET和AF_INET6类型的套接字,并指定接收数据的远程端口。如果套接字是面向连接的,port是null。
返回值
socket_recvfrom() 返回接收到的字节数,发生错误时返回 false。可以通过调用 socket_last_error()
来检索实际的错误代码。此错误码可以传递给 socket_strerror() 获得错误的文本解释。
示例
示例 #1 socket_recvfrom() 示例
<?php
$socket = socket_create(AF_INET, SOCK_DGRAM, SOL_UDP);
socket_bind($socket, '127.0.0.1', 1223);
$from = '';
$port = 0;
socket_recvfrom($socket, $buf, 12, 0, $from, $port);
echo "Received $buf from remote address $from and remote port $port" . PHP_EOL;
?>此示例将在 127.0.0.1 的 1233 端口上初始化 UDP 套接字,并打印从远程主机收到的至少 12 个字符。
参见
- socket_recv() - 从已连接的 socket 接收数据
- socket_send() - 向已连接的套接字发送数据
- socket_sendto() - 向套接字发送消息,无论它是否已建立连接
- socket_create() - 创建一个套接字(通讯节点)
用户贡献的备注 4 notes
If you use socket_recvfrom on a UDP socket and combine it with the MSG_DONTWAIT flag, it will raise a PHP Warning if there is nothing to read. AFAIK, there is no way around that warning except suppressing it with @ (i.e. you cannot check if there is data before calling socket_recvfrom).MSG_DONTWAIT doesn't seem to exist in windows sockets. However socket_set_nonblock() seems to do the trick.Pay attention! On some PHP version the MSG_DONTWAIT flag is not defined (see https://bugs.php.net/bug.php?id=48326)I'm confused about the rerturn value of socket_recvfrom(), it said -1 when failed, but when I call like this:
if (($len = @socket_recvfrom($sock, $result, 32, 0, $ip, $port)) == -1) {
if ($this->_debug) {
echo "socket_read() failed: " . socket_strerror(socket_last_error()) . "\n";
}
return false;
}
variable $len = false, when I change the buffer length from 32 to 4096, it becomes right.备份地址:http://www.lvesu.com/blog/php/function.socket-recvfrom.php