(PHP 5, PHP 7, PHP 8)
stream_socket_server — Создаёт интернет-сокет или доменный сокет Unix
$address,&$error_code = null,&$error_message = null,$flags = STREAM_SERVER_BIND | STREAM_SERVER_LISTEN,$context = null Создаёт сокет потока или датаграммы на указанном address.
Эта функция только создаёт сокет. Чтобы начать принимать соединения используйте stream_socket_accept().
address Тип создаваемого сокета определяется по транспорту, указанному с использованием стандартного форматирования URL: transport://target.
Для доменных сокетов интернета (AF_INET), таких как TCP и UDP, часть target параметра remote_socket должна состоять из имени хоста или IP-адреса с последующим двоеточием и номера порта. Для доменных сокетов Unix часть target должна указывать на файл сокета в файловой системе.
В зависимости от окружения, доменные сокеты Unix могут быть недоступны. Список доступных транспортов может быть получен при помощи функции stream_get_transports(). Смотрите Список поддерживаемых транспортных протоколов для списка встроенных транспортов.
error_code Если необязательные аргументы error_code и error_message присутствуют, то они будут установлены для указания действительного уровня системной ошибки, которая происходит при системных вызовах socket(), bind() и listen(). Если значение, возвращаемое в error_code, равно 0 и функция возвратила false, это означает, что ошибка произошла до вызова bind(). Скорее всего это произошло из-за проблемы инициализации сокета. Примите во внимание, что аргументы error_code и error_message должны всегда передаваться по ссылке.
error_message Смотрите описание параметра error_code.
flagsБитовая маска, которая может быть установлена в любую комбинацию флагов для создания сокета.
Замечание:
Для UDP-сокетов вы должны использовать
STREAM_SERVER_BINDв качестве параметраflags.
context Возвращает созданный поток или false в случае возникновения ошибки.
| Версия | Описание |
|---|---|
| 8.0.0 | Параметр context теперь допускает значение null. |
Пример #1 Пример использования серверных сокетов TCP
<?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, 'Локальное время ' . date('n/j/Y g:i a') . "\n");
fclose($conn);
}
fclose($socket);
}
?>Пример ниже показывает, как работать в качестве сервера времени, который может отвечать на запросы времени, как показано в примере функции stream_socket_client().
Замечание: Большинство систем требуют доступа с правами root для создания серверного сокета на порту ниже, чем 1024.
Пример #2 Пример использования серверных сокетов UDP
<?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);
?>Замечание: При указании числового адреса IPv6 (например,
fe80::1) вы должны заключать его в квадратные скобки. Например,tcp://[fe80::1]:80.