fsockopenOuvre un socket de connexion Internet ou Unix
&reftitle.description;
resourcefalsefsockopenstringhostnameintport-1interror_code&null;stringerror_message&null;floatnulltimeout&null;
Initialise une connexion par socket à la ressource spécifiée par
hostname.
PHP supporte les cibles dans les domaines Internet et Unix comme décrit dans
. Une liste des types de transports peut également
être trouvée en utilisant la fonction stream_get_transports.
Le socket sera ouvert par défaut en mode bloquant. Vous pouvez
changer de mode en utilisant : stream_set_blocking.
La fonction stream_socket_client est similaire
mais fournit plus d'options, incluant la connexion non-bloquante
et la possibilité de fournir un contexte de flux.
&reftitle.parameters;
hostname
Si le support OpenSSL est
installé, vous pouvez préfixer hostname
avec ssl:// ou tls:// pour utiliser
une connexion cliente SSL ou TLS sur TCP/IP pour vous connectez à l'hôte
distant.
port
Le numéro du port. Ce paramètre peut être omis et ignoré
en utilisant la valeur -1 pour les transports
qui n'utilisent pas les ports, comme unix://.
error_code
Si fourni, contient le numéro de l'erreur système qui survient
lors de l'appel système à connect().
Si la valeur retournée par error_code est
0 et que la fonction retourne &false;, ce peut
être une indication laissant penser que l'erreur est survenue
avant l'appel à connect(). La plupart du temps,
cela est du à un problème d'initialisation du socket.
error_message
Le message d'erreur, sous la forme d'une &string;.
timeout
Le délai d'attente maximal, en secondes. Si &null; le paramètre &php.ini;
default_socket_timeout est utilisé.
Si vous avez besoin de définir un délai limite pour lire/écrire des
données à travers ce socket, utilisez la fonction
stream_set_timeout, car le paramètre
timeout de la fonction
fsockopen est uniquement appliqué lors de la
connexion du socket.
&reftitle.returnvalues;
fsockopen retourne un pointeur de fichier qui peut
être utilisé avec d'autres fonctions fichiers, telles
fgets, fgetss,
fputs, fclose et
feof. Si l'appel échoue, la fonction retourne
&false;.
&reftitle.errors;
Lance une alerte de type E_WARNING si le paramètre
hostname n'est pas un domaine valide.
&reftitle.changelog;
&Version;&Description;8.0.0timeout est désormais nullable.
&reftitle.examples;
Exemple avec fsockopen
\n";
} else {
$out = "GET / HTTP/1.1\r\n";
$out .= "Host: www.example.com\r\n";
$out .= "Connection: Close\r\n\r\n";
fwrite($fp, $out);
while (!feof($fp)) {
echo fgets($fp, 128);
}
fclose($fp);
}
?>
]]>
Utilisation d'une connexion UDP
L'exemple ci-dessous décrit comment lire la date et l'heure grâce à
un service UDP "daytime" (port 13), sur votre propre machine.
\n";
} else {
fwrite($fp, "\n");
echo fread($fp, 26);
fclose($fp);
}
?>
]]>
&reftitle.notes;
Suivant les environnements, le type 'domaine Unix' ou l'option
timeout ne sont pas toujours disponibles.
Les sockets UDP semblent quelques fois avoir été ouverts sans erreur,
même si l'hôte distant n'est pas accessible. L'erreur apparaît alors
uniquement lorsque vous tentez de lire/écrire sur le socket.
La raison de cela est que UDP est un protocole "connectionless",
ce qui signifie que le système ne tentera pas d'établir un lien pour le socket
tant qu'il ne doit pas recevoir/envoyer de données.
&ipv6.brackets;
&reftitle.seealso;
pfsockopenstream_socket_clientstream_set_blockingstream_set_timeoutfgetsfgetssfwritefclosefeofsocket_connectL'extension Curl