stream_socket_server
(PHP 5, PHP 7)
stream_socket_server — Create an Internet or Unix domain server socket
说明
$local_socket
[,
int &$errno
[,
string &$errstr
[,
int $flags
= STREAM_SERVER_BIND | STREAM_SERVER_LISTEN [,
resource $context
]]]] ) :
resource
Creates a stream or datagram socket on the specified local_socket
.
This function only creates a socket, to begin accepting connections use stream_socket_accept().
参数
-
local_socket
-
The type of socket created is determined by the transport specified using standard URL formatting: transport://target.
For Internet Domain sockets (
AF_INET
) such as TCP and UDP, the target portion of theremote_socket
parameter should consist of a hostname or IP address followed by a colon and a port number. For Unix domain sockets, the target portion should point to the socket file on the filesystem.Depending on the environment, Unix domain sockets may not be available. A list of available transports can be retrieved using stream_get_transports(). See 所支持的套接字传输器(Socket Transports)列表 for a list of bulitin transports.
-
errno
-
If the optional
errno
anderrstr
arguments are present they will be set to indicate the actual system level error that occurred in the system-level socket(), bind(), and listen() calls. If the value returned inerrno
is 0 and the function returnedFALSE
, it is an indication that the error occurred before the bind() call. This is most likely due to a problem initializing the socket. Note that theerrno
anderrstr
arguments will always be passed by reference. -
errstr
-
See
errno
description. -
flags
-
A bitmask field which may be set to any combination of socket creation flags.
Note:
For UDP sockets, you must use
STREAM_SERVER_BIND
as theflags
parameter. -
context
-
返回值
Returns the created stream, or FALSE
on error.
范例
Example #1 Using TCP server sockets
<?php
$socket = stream_socket_server("tcp://0.0.0.0:8000", $errno, $errstr);
if (!$socket) {
echo "$errstr ($errno)<br />\n";
} else {
while ($conn = stream_socket_accept($socket)) {
fwrite($conn, 'The local time is ' . date('n/j/Y g:i a') . "\n");
fclose($conn);
}
fclose($socket);
}
?>
The example below shows how to act as a time server which can respond to time queries as shown in an example on stream_socket_client().
Note: Most systems require root access to create a server socket on a port below 1024.
Example #2 Using UDP server sockets
<?php
$socket = stream_socket_server("udp://127.0.0.1:1113", $errno, $errstr, STREAM_SERVER_BIND);
if (!$socket) {
die("$errstr ($errno)");
}
do {
$pkt = stream_socket_recvfrom($socket, 1, 0, $peer);
echo "$peer\n";
stream_socket_sendto($socket, date("D M j H:i:s Y\r\n"), 0, $peer);
} while ($pkt !== false);
?>
注释
Note: 当指定数值型的 IPv6 地址(例如 fe80::1)时必须用方括号将 IP 围起来——例如, tcp://[fe80::1]:80。
参见
- stream_socket_client() - Open Internet or Unix domain socket connection
- stream_set_blocking() - 为资源流设置阻塞或者阻塞模式
- stream_set_timeout() - Set timeout period on a stream
- fgets() - 从文件指针中读取一行
- fgetss() - 从文件指针中读取一行并过滤掉 HTML 标记
- fwrite() - 写入文件(可安全用于二进制文件)
- fclose() - 关闭一个已打开的文件指针
- feof() - 测试文件指针是否到了文件结束的位置
- Curl extension