Php/docs/function.stream-socket-server

• PHP Manual
• Stream 函数
• Create an Internet or Unix domain server socket

stream_socket_server

(PHP 5, PHP 7)

stream_socket_server — Create an Internet or Unix domain server socket

说明

stream_socket_server ( string $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 the remote_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 and errstr 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 in errno is 0 and the function returned false, 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 the errno and errstr 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 the flags 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