array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.socket-connect.php', 1 => 'socket_connect', 2 => 'Начинает соединение с сокетом', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Функции модуля Socket', ), 'prev' => array ( 0 => 'function.socket-cmsg-space.php', 1 => 'socket_cmsg_space', ), 'next' => array ( 0 => 'function.socket-create.php', 1 => 'socket_create', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/sockets/functions/socket-connect.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

socket_connect

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

socket_connect — Начинает соединение с сокетом

Описание

socket_connect(Socket $socket, string $address, ?int $port = null): bool

Инициализирует соединение с адресом address, используя экземпляр Socket socket, который должен быть экземпляром Socket, созданным при помощи функции socket_create().

Список параметров

socket

Экземпляр Socket, созданный с помощью socket_create().

address

Параметр address может быть IPv4-адресом в записи, разделённой точками (например, 127.0.0.1), если параметр socket равен AF_INET, правильный IPv6-адрес (например, ::1), если включена поддержка IPv6 и параметр socket равен AF_INET6 или путь к файлу доменного сокета Unix, если используется семейство сокетов AF_UNIX.

port

Параметр port используется и обязателен только в том случае, если происходит соединение с сокетом AF_INET или AF_INET6, и он указывает порт на удалённом хосте, к которому должно быть создано соединение.

Возвращаемые значения

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка. Код ошибки может быть получен при помощи функции socket_last_error(). Этот код может быть затем передан функции socket_strerror() для получения текстового описания ошибки.

Замечание:

Если сокет неблокирующий, то эта функция возвращает false с ошибкой Operation now in progress.

Список изменений

Версия Описание
8.0.0 Параметр socket теперь принимает объект Socket; раньше принимался тип resource.
8.0.0 port теперь допускает значение null.

Смотрите также