socket_connect

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

socket_connect — Crea una conexión en un socket

Descripción

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

Crea una nueva conexión utilizando la instancia Socket socket, que debe ser una instancia de Socket creada por socket_create().

Parámetros

socket: Una instancia de Socket creada con socket_create().
address: El argumento address es una dirección IPv4 válida (por ejemplo, 127.0.0.1) si socket es AF_INET, o una dirección IPv6 válida (por ejemplo, ::1) si el soporte IPv6 está activo y el argumento socket es AF_INET6, o una ruta hacia un socket de dominio Unix, si la familia de sockets es AF_UNIX.
port: El argumento port solo se utiliza y es obligatorio al conectarse a un socket AF_INET o AF_INET6, e indica el puerto del host remoto al que debe realizarse la conexión.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error. El código de error generado puede obtenerse llamando a la función socket_last_error(). Este código de error puede pasarse a la función socket_strerror() para obtener un mensaje de error legible por humanos.

Nota:
Si el socket es no bloqueante, entonces esta función devuelve false con el siguiente error: Operation now in progress.

Historial de cambios

Versión	Descripción
8.0.0	`socket` ahora es una instancia de Socket ; anteriormente, era un resource.
8.0.0	`port` ahora es nullable.

Ver también

socket_bind() - Asocia un nombre a un socket
socket_listen() - Espera una conexión en un socket
socket_create() - Crea un socket
socket_last_error() - Lee el último error generado por un socket
socket_strerror() - Devuelve un string describiendo un mensaje de error