stream_socket_client

stream_socket_client(string $address, [int $error_code], [string $error_message], [float $timeout], [int $flags], [resource $context]): resource
```php

Inicia un flujo o una conexión de datagrama con el destino `address`. El tipo de socket creado se determina por el transporte especificado con el formato URL siguiente: `transport://target`. Para un socket de Internet, (AF_INET) como TCP y UDP, el `objetivo` de `address` será una dirección IP o un nombre de host. Para un socket Unix, el `objetivo` debe ser un fichero de socket del sistema.

> [!NOTE]
> El flujo se abrirá por omisión en modo bloqueante. Puede pasarse a modo no bloqueante utilizando la función `stream_set_blocking`.

## Parámetros

`address`  
La dirección del socket.

`error_code`  
Contendrá el número del error del sistema si la conexión falla.

`error_message`  
Contendrá el mensaje del error del sistema si la conexión falla.

`timeout`  
Tiempo límite, en segundos, para la llamada al sistema `connect()`. Por omisión, se utiliza [default_socket_timeout](#ini.default-socket-timeout).

> [!NOTE]
> Este parámetro solo se aplica para conexiones que no son asíncronas.

> [!NOTE]
> Para definir un tiempo límite al leer/escribir datos a través de un socket, utilice la función `stream_set_timeout`, ya que el parámetro `timeout` solo se aplica durante la conexión al socket.

`flags`  
Campo de bits que puede ser la combinación de cualquier opción de conexión. Actualmente, los valores posibles para estas opciones son `STREAM_CLIENT_CONNECT` (por omisión), `STREAM_CLIENT_ASYNC_CONNECT` y `STREAM_CLIENT_PERSISTENT`.

`context`  
Un recurso de contexto válido, creado por la función `stream_context_create`.

## Valores devueltos

En caso de éxito, se devuelve un recurso de flujo, que puede ser utilizado con otras funciones de ficheros, como `fgets`, `fgetss`, `fwrite`, `fclose`, y `feof`, `false` si ocurre un error.

## Errores/Excepciones

Si la llamada falla, `stream_socket_client` devolverá `false` y si los parámetros opcionales `error_code` y `error_message` son proporcionados, recibirán el error exacto que ocurrió en el sistema durante la llamada a `connect()`. Si el valor devuelto en `error_code` es `0` y la función ha devuelto `false`, es una indicación de que el error ocurrió antes de la llamada a `connect()`. Esto es probablemente debido a un problema de inicialización del socket. Tenga en cuenta que `error_code` y `error_message` deben ser pasados por referencia.

## Historial de cambios

| Versión | Descripción                                   |
|---------|-----------------------------------------------|
| 8.0.0   | `timeout` y `context` ahora pueden ser nulos. |

## Ejemplos

Ejemplo con `stream_socket_client`

Uso de conexiones UDP

Lee la fecha y hora en un servicio UDP de tipo "`daytime`" (puerto 13) en su propia máquina: