Ce module est EXPERIMENTAL. Cela signifie que le comportement de ces fonctions, leurs noms et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utiliser ce module à vos risques et périls.
L'extension socket implémente une interface bas niveau avec les
fonctions de communication par socket. Cela permet de mettre en place
un serveur aussi bien qu'un client.
Les fonctions socket décrites ici sont rassemblées dans une extension
PHP. Pour être activées, il faut utiliser l'option de compilation
--enable-sockets au script
configure.
Lorsque vous utiliserez les fonctions de sockets qui sont décrites ici,
gardez bien à l'esprit que même si elles ont souvent des noms identiques
aux fonctions C, elles ont souvent des prototypes différents. Lisez attentivement
la documentation pour éviter les confusions.
Cela dit, ceux qui n'ont pas l'habitude de la programmation avec les sockets
pourront trouver beaucoup de documentation pertinente dans les pages de
manuel Unix, et de nombreux tutorial de programmation C sur le web, dont la
plus part peuvent être repris après de légère
modifications, en PHP.
Exemple 1. Exemple de programmation Socket : serveur TCP/IP
Cet exemple est un serveur perroquete : tout ce que vous lui envoyez
vous est retourné. Changez les variables
address et port pour les adapter à
votre configuration, et lancez le script. Vous pouvez vous connecter
au serveur avec une commande telle que telnet 192.168.1.53 10000
(avec l'adresse et le port qui sont ceux de votre configuration).
Pour vous déconnecter, tapez 'quit'.
<?php
error_reporting(E_ALL);
/* On autorise le script à attendre les connexions indéfiniment. */
set_time_limit(0);
/* Modifiez ces valeurs pour qu'elles soient celles de votre configuration */
$address = '192.168.1.53';
$port = 10000;
if (($sock = socket(AF_INET, SOCK_STREAM, 0)) < 0) {
echo "socket() a échoué : raison : " . strerror($sock) . "\n";
}
if (($ret = bind($sock, $address, $port)) < 0) {
echo "bind() a échoué : raison: " . strerror($ret) . "\n";
}
if (($ret = listen($sock, 5)) < 0) {
echo "listen() a échoué : raison: " . strerror($ret) . "\n";
}
do {
if (($msgsock = accept_connect($sock)) < 0) {
echo "accept_connect() a échoué : raison : " . strerror($msgsock) . "\n";
break;
}
do {
$buf = '';
$ret = read($msgsock, $buf, 2048);
if ($ret < 0) {
echo "read() a échoué : raison : " . strerror($ret) . "\n";
break 2;
}
if ($ret == 0) {
break 2;
}
$buf = trim($buf);
if ($buf == 'quit') {
close($msgsock);
break 2;
}
$talkback = "PHP: Vous avez dit '$buf'.\n";
write($msgsock, $talkback, strlen($talkback));
echo "$buf\n";
} while (TRUE);
close($msgsock);
} while (TRUE);
close($sock);
?>
Exemple 2. Exemple avec les sockets : Client TCP/IP
Cet exemple est un client HTTP basique. Il se connecte à une page
envoi les entêtes (requête HEAD), affiche le retour, et quitte.
<?php
error_reporting(E_ALL);
echo "<h2>TCP/IP Connection</h2>\n";
/* Demande le port du service WWW. */
$service_port = getservbyname('www', 'tcp');
/* Demande l'IP du serveur de destination. */
$address = gethostbyname('www.php.net');
/* Crée la connexion TCP/IP. */
$socket = socket(AF_INET, SOCK_STREAM, 0);
if ($socket < 0) {
echo "socket() a échoué : raison : " . strerror($socket) . "\n";
} else {
"socket() réussi: " . strerror($socket) . "\n";
}
echo "Connexion à '$address' on port '$service_port'...";
$result = connect($socket, $address, $service_port);
if ($result < 0) {
echo "connect() a échoué : raison : : ($result) " . strerror($result) . "\n";
} else {
echo "OK.\n";
}
$in = "HEAD / HTTP/1.0\r\n\r\n";
$out = '';
echo "Envoi des entêtes HTTP HEAD...";
write($socket, $in, strlen($in));
echo "OK.\n";
echo "Lecture de la réponse :\n\n";
while (read($socket, $out, 2048)) {
echo $out;
}
echo "Fermeture de la socket...";
close($socket);
echo "OK.\n\n";
?>
socket_getpeername --
Queries the remote side of the given socket which may either result in host/port
or in a UNIX filesystem path, dependent on its type.
socket_getsockname --
Queries the local side of the given socket which may either result in host/port
or in a UNIX filesystem path, dependent on its type.
socket_iovec_add -- Adds a new vector to the scatter/gather array
socket_iovec_alloc -- ...]) Builds a 'struct iovec' for use with sendmsg, recvmsg, writev, and readv