socket_connect

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

socket_connectCrea 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

Devuelve true en caso de éxito o false en caso de 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 is a Socket instance now; previously, it was a resource.
8.0.0 port ahora es nullable.

Ver también