stream_socket_client
(PHP 5)
stream_socket_client — Ouvre une connexion socket Internet ou Unix
Description
$remote_socket
[, int &$errno
[, string &$errstr
[, float $timeout
= ini_get("default_socket_timeout")
[, int $flags
= STREAM_CLIENT_CONNECT
[, resource $context
]]]]] )
Initie un flux ou une connexion datagramme avec la destination
remote_socket
. Le type de socket créé est déterminé
par le transport spécifié avec le formatage URL suivant :
transport://target. Pour un socket Internet,
(AF_INET) comme TCP et UDP, la cible
de remote_socket
sera une adresse IP ou un nom d'hôte.
Pour un socket Unix, la cible doit être un fichier de
socket du système.
Note:
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().
Liste de paramètres
-
remote_socket
-
L'adresse du socket.
-
errno
-
Contiendra le numéro de l'erreur système si la connexion échoue.
-
errstr
-
Contiendra le message de l'erreur système si la connexion échoue.
-
timeout
-
Délai d'expiration, en secondes, pour l'appel système connect().
Note: Ce paramètre n'est appliqué que pour les connexions qui ne sont pas asynchrones.
Note:
Pour définir un délai d'expiration lors de la lecture/écriture de données via un socket, utilisez la fonction stream_set_timeout(), vu que le paramètre
timeout
n'est appliqué que lors de la connexion au socket. -
flags
-
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_CONNECT
(défaut),STREAM_CLIENT_ASYNC_CONNECT
etSTREAM_CLIENT_PERSISTENT
. -
context
-
Une ressource de contexte valide, créée par la fonction stream_context_create().
Valeurs de retour
En cas de succès, une ressource de flux est retournée, qui peut être utilisée
avec d'autres fonctions de fichiers, comme
fgets(), fgetss(),
fwrite(), fclose(), et
feof(), FALSE
si une erreur survient.
Erreurs / Exceptions
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 du socket. Notez que
errno
eterrstr
doivent être passés par référence.
Exemples
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 { fwrite($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); } ?>
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); } ?>
Notes
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 cet 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 le 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.
Note:
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 Liste des modes de transport de sockets disponibles pour une liste de transports natifs.
Voir aussi
- stream_socket_server() - Crée un socket serveur Unix ou Internet
- stream_set_blocking() - Configure le mode bloquant d'un flux
- stream_set_timeout() - Configure la durée d'expiration d'un flux
- stream_select() - Surveille la modification d'un ou plusieurs flux
- fgets() - Récupère la ligne courante sur laquelle se trouve le pointeur du fichier
- fgetss() - Renvoie la ligne courante du fichier et élimine les balises HTML
- fwrite() - Écrit un fichier en mode binaire
- fclose() - Ferme un fichier
- feof() - Teste la fin du fichier
- Fonctions cURL