stream_socket_clientOuvre une connexion socket Internet ou Unix
&reftitle.description;
resourcefalsestream_socket_clientstringaddressinterror_code&null;stringerror_message&null;floatnulltimeout&null;intflagsSTREAM_CLIENT_CONNECTresourcenullcontext&null;
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 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.
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.
&reftitle.parameters;
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é.
Ce paramètre n'est appliqué que pour les connexions
qui ne sont pas asynchrones.
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 et
STREAM_CLIENT_PERSISTENT.
context
Une ressource de contexte valide, créée par la fonction
stream_context_create.
&reftitle.returnvalues;
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.
&reftitle.errors;
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 &zero; 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
error_code eterror_message
doivent être passés par référence.
&reftitle.changelog;
&Version;&Description;8.0.0timeout et context sont désormais nullables.
&reftitle.examples;
Exemple avec stream_socket_client
\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);
}
?>
]]>
Utilisation de connexions UDP
Lit la date et l'heure sur un service UDP de type
"daytime" (port 13) sur votre propre machine :
\n";
} else {
fwrite($fp, "\n");
echo fread($fp, 26);
fclose($fp);
}
?>
]]>
&reftitle.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.
&ipv6.brackets;
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 pour une liste de transports natifs.
&reftitle.seealso;
stream_socket_serverstream_set_blockingstream_set_timeoutstream_selectfgetsfgetssfwritefclosefeof