(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_connect — Crée une connexion sur un socket
Crée une nouvelle connexion en utilisant l'instance Socketsocket
, qui doit être une instance de Socket créée par socket_create().
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.
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
.
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. |