# socket_connect

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

socket_connect — Crée une connexion sur un socket

### Description

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

Crée une nouvelle connexion en utilisant l'instance Socket `socket`, qui doit être une instance de Socket créée par socket_create().

### Liste de paramètres

`socket`

  Une instance de Socket créée avec socket_create().

`address`

  Le paramètre `address` est soit une adresse valide IPv4 (e.g. `127.0.0.1`) si `socket` vaut `AF_INET`, soit une adresse valide IPv6 (e.g. `::1`) si le support IPv6 est actif et que le paramètre `socket` vaut `AF_INET6`, soit un chemin vers un socket de domaine Unix, si la famille de sockets vaut `AF_UNIX`.

`port`

  Le paramètre `port` n'est utilisé et mandaté que lors d'une connexion à un socket `AF_INET` ou `AF_INET6`, et désigne le port de l'hôte distant sur lequel la connexion doit être effectuée.

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient. Le code d'erreur généré peut être obtenu en appelant la fonction socket_last_error(). Ce code d'erreur peut être passé à la fonction socket_strerror() pour obtenir un message d'erreur humainement lisible.

> Note:

> Si le socket est non-bloquant, alors cette fonction retourne `false` avec l'erreur suivant : `Operation now in progress`.

### Historique

Version | Description
--- | ---
8.0.0 | `socket` est désormais une instance de Socket ; auparavant, c'était une resource.
8.0.0 | `port` est désormais nullable.

### Voir aussi

- socket_bind() - Lie un nom à un socket
- socket_listen() - Attend une connexion sur un socket
- socket_create() - Crée un socket
- socket_last_error() - Lit la dernière erreur générée par un socket
- socket_strerror() - Retourne une chaîne décrivant un message d'erreur