7.100 Flôts
7 Index des fonctions
Manuel PHP
. Introduction . Filtres de flôts . Contextes de flôts . Installation . Classes Stream . Constantes prédefinies . Erreurs de flôts . Exemples . stream_context_create . stream_context_get_options . stream_context_set_option . stream_context_set_params . stream_copy_to_stream . stream_filter_append . stream_filter_prepend . stream_filter_register . stream_get_filters . stream_get_line . stream_get_meta_data . stream_get_transports . stream_get_wrappers . stream_register_wrapper . stream_select . stream_set_blocking . stream_set_timeout . stream_set_write_buffer . stream_socket_accept ->stream_socket_client . stream_socket_get_name . stream_socket_server . stream_wrapper_register
|
7.100.28 stream_socket_client()
Ouvre une connexion socket Internet ou Unix
[ Exemples avec stream_socket_client ] PHP 5 CVS only
resource
stream_socket_client (
string
remote_socket
,
int
&errno
,
string
&errstr
,
float
timeout
,
int
flags
,
resource
context
)
stream_socket_client
initie un flôt ou une connexion
datagramme avec la destination
remote_socket
. Le type
de socket créé est déterminé par le transport spécifié avec le formattage
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 quelle option de connexion. Actuellement, les valeurs possibles
pour ces options sont
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'appliqu que lors de la connexion à la socket.
|
stream_socket_client
retourne une ressource de flôt,
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ée
FALSE
, c'est une indication que l'erreur est survenue
avant l'appel à
connect()
. Cela est probablement du
à un problème d'initialisation de la socket. Notez que
errno
et
errstr
doivent être passé 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
qui sont disponibles sur le système est accessible via
stream_get_transports
.
Le flôt sera par défaut ouvert en mode bloquant. Vous pouvez le passer
en mode non bloquant en utilisant la fonction
stream_set_blocking
.
Exemple avec stream_socket_client |
<?php $fp = stream_socket_client("tcp://www.exemple.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 :
Utilisation de connexions UDP |
<?php $fp = stream_socket_client("udp://127.0.0.1:13", $errno, $errstr); if (!$fp) { echo "ERREIR : $errno - $errstr<br>\n"; } else { fwrite($fp,"\n"); echo fread($fp, 26); fclose($fp); } ?>
|
Attention |
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'exploitaiton 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 .
|