Manuel PHP
Précédent |  | Suivant

# stream_socket_client

(PHP 5)

stream_socket_client -- Ouvre une connexion socket Internet ou Unix

## Description

resource stream_socket_client ( string remote_socket [, int &errno [, string &errstr [, float timeout [, int flags [, resource context]]]]] )

stream_socket_client() initie un flux ou une connexion datagramme avec la destination `remote_socket`. Le type de socket créée est déterminé par le transport spécifié avec le formatage URL suivant : `transport://target`. Pour une socket Internet, (`AF_INET`) comme TCP et UDP, la `cible` de `remote_socket` sera une adresse IP ou un nom d'hôte. Pour une socket Unix, la `cible` doit être un fichier de socket du système.

Le paramètre optionnel `timeout` sert à imposer un délai d'expiration, en secondes, à l'appel système.

`flags` est un champ de bits qui peut être la combinaison de n'importe quelles options de connexion. Actuellement, les valeurs possibles pour ces options sont `STREAM_CLIENT_ASYNC_CONNECT` (défaut), `STREAM_CLIENT_ASYNC_CONNECT` et `STREAM_CLIENT_PERSISTENT`.

> Note : Si vous n'avez pas besoin de mettre de délai d'expiration pour les opérations via la socket, utilisez la fonction stream_set_timeout(), car `timeout` de stream_socket_client() ne s'applique que lors de la connexion à la socket.

stream_socket_client() retourne une ressource de flux, qui peut être utilisée avec d'autres fonctions de fichiers, comme fgets(), fgetss(), fputs(), fclose() et feof()).

Si l'appel échoue, stream_socket_client() va retourner `FALSE` et si les paramètres optionnels `errno` et `errstr` sont fournis, ils recevront l'erreur exacte qui est survenue dans le système lors de l'appel à `connect()`. Si la valeur retournée dans `errno` est `0` et que la fonction a retourné `FALSE`, c'est une indication que l'erreur est survenue avant l'appel à `connect()`. Cela est probablement dû à un problème d'initialisation de la socket. Notez que `errno` et`errstr` doivent être passés par référence.

Suivant votre environnement, les sockets Unix ou le délai d'expiration peuvent ne pas être disponibles. Une liste des transports disponibles sur le système est accessible via stream_get_transports(). Voyez Annexe O pour une liste de transports natifs.

Le flux sera par défaut ouvert en mode bloquant. Vous pouvez le passer en mode non bloquant en utilisant la fonction stream_set_blocking().

Exemple 1. Exemple avec stream_socket_client()

`<?php $fp = stream_socket_client("tcp://www.example.com:80", $errno, $errstr, 30); if (!$fp) { echo "$errstr ($errno)<br />\n"; } else { fputs($fp, "GET / HTTP/1.0\r\nHost: www.example.com\r\nAccept: */*\r\n\r\n"); while (!feof($fp)) { echo fgets ($fp,1024); } fclose($fp); } ?>`

L'exemple ci-dessous vous montre comment lire la date et l'heure sur un service UDP de type "`daytime`" (port 13) sur votre propre machine :

Exemple 2. Utilisation de connexions UDP

`<?php $fp = stream_socket_client("udp://127.0.0.1:13", $errno, $errstr); if (!$fp) { echo "ERREUR : $errno - $errstr<br />\n"; } else { fwrite($fp,"\n"); echo fread($fp, 26); fclose($fp); } ?>`

Avertissement

Les sockets UDP sembleront parfois s'ouvrir sans erreur, même si l'hôte distant n'est pas accessible. Cette erreur ne deviendra apparente que lorsque vous essaierez de lire ou écrire des données avec cette socket. La raison à cela est que UDP est un protocole sans connexion, ce qui signifie que le système d'exploitation n'a pas à établir de lien pour la socket, jusqu'à ce qu'il commence à échanger des données.

> Note : Lors de la spécification d'adresses IPv6 au format numérique (e.g. fe80::1) vous devez placer l'adresse IP entre crochets. Par exemple : `tcp://[fe80::1]:80`.

Voir aussi stream_socket_server(), stream_set_blocking(), stream_set_timeout(), fgets(), fgetss(), fputs(), fclose(), feof() et l'extension CURL.

Précédent | Sommaire | Suivant
stream_socket_accept | Niveau supérieur | stream_socket_enable_crypto