array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.stream-socket-client.php', 1 => 'stream_socket_client', 2 => 'Ouvre une connexion socket Internet ou Unix', ), 'up' => array ( 0 => 'ref.stream.php', 1 => 'Fonctions sur les flux', ), 'prev' => array ( 0 => 'function.stream-socket-accept.php', 1 => 'stream_socket_accept', ), 'next' => array ( 0 => 'function.stream-socket-enable-crypto.php', 1 => 'stream_socket_enable_crypto', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/stream/functions/stream-socket-client.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

stream_socket_client

(PHP 5, PHP 7, PHP 8)

stream_socket_client — Ouvre une connexion socket Internet ou Unix

Description

stream_socket_client(
    string $address,
    int &$error_code = null,
    string &$error_message = null,
    ?float $timeout = null,
    int $flags = STREAM_CLIENT_CONNECT,
    ?resource $context = null
): resource|false

Initie un flux ou une connexion datagramme avec la destination address. 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 address doit être constituée d'un nom d'hôte ou d'une adresse IP suivie de deux-points et d'un numéro de port. 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. Il est possible de passer en mode non bloquant en utilisant la fonction stream_set_blocking().

Liste de paramètres

address

L'adresse du socket.

error_code

Contiendra le numéro de l'erreur système si la connexion échoue.

error_message

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(). Par défaut, default_socket_timeout est utilisé.

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, utiliser 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 et STREAM_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 error_code et error_message 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 error_code 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. Il est à noter que error_code et error_message doivent être passés par référence.

Historique

Version Description
8.0.0 timeout et context sont désormais nullables.

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

Lit la date et l'heure sur un service UDP de type "daytime" (port 13) sur sa propre machine :

<?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

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 l'on essaiera 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 l'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(). Voir Liste des modes de transport de sockets disponibles pour une liste de transports natifs.

Voir aussi