fsockopen

fsockopen(string $hostname, [int $port], [int $error_code], [string $error_message], [float $timeout]): resource
```php

Inicializa una conexión por socket al recurso especificado por `hostname`.

PHP soporta los objetivos en los dominios Internet y Unix como se describe en [???](#transports). Una lista de los tipos de transportes también puede ser encontrada utilizando la función `stream_get_transports`.

El socket se abrirá por omisión en modo bloqueante. Se puede cambiar de modo utilizando: `stream_set_blocking`.

La función `stream_socket_client` es similar pero proporciona más opciones, incluyendo la conexión no bloqueante y la posibilidad de proporcionar un contexto de flujo.

## Parámetros

`hostname`  
Si el soporte OpenSSL [está instalado](#openssl.installation), se puede prefijar `hostname` con `ssl://` o `tls://` para utilizar una conexión cliente SSL o TLS sobre TCP/IP para conectarse al host remoto.

`port`  
El número del puerto. Este argumento puede ser omitido e ignorado utilizando el valor `-1` para los transportes que no utilizan puertos, como `unix://`.

`error_code`  
Si se proporciona, contiene el número del error del sistema que ocurre durante la llamada al sistema `connect()`.

Si el valor devuelto por `error_code` es `0` y la función devuelve `false`, puede ser una indicación de que el error ocurrió antes de la llamada a `connect()`. La mayoría de las veces, esto se debe a un problema de inicialización del socket.

`error_message`  
El mensaje de error, en forma de `string`.

`timeout`  
El tiempo máximo de espera, en segundos. Si es `null` el parámetro `php.ini` [default_socket_timeout](#ini.default-socket-timeout) es utilizado.

> [!NOTE]
> Si se necesita establecer un tiempo límite para leer/escribir datos a través de este socket, utilice la función `stream_set_timeout`, ya que el argumento `timeout` de la función `fsockopen` se aplica únicamente durante la conexión del socket.

## Valores devueltos

`fsockopen` devuelve un puntero de fichero que puede ser utilizado con otras funciones de ficheros, tales como `fgets`, `fgetss`, `fputs`, `fclose` y `feof`. Si la llamada falla, la función devuelve `false`.

## Errores/Excepciones

Lanza una alerta de tipo `E_WARNING` si el argumento `hostname` no es un dominio válido.

## Historial de cambios

| Versión | Descripción                  |
|---------|------------------------------|
| 8.0.0   | `timeout` es ahora nullable. |

## Ejemplos

Ejemplo con `fsockopen`

Uso de una conexión UDP

El ejemplo a continuación describe cómo leer la fecha y la hora gracias a un servicio UDP "daytime" (puerto 13), en su propia máquina.