Sockets

&reftitle.intro; L'extension socket implémente une interface bas niveau avec les fonctions de communication par socket, basées sur les sockets BSD si populaires, et fournit la possibilité de fonctionner aussi bien sous forme de client que de serveur. Pour une interface socket cliente plus générique, voyez stream_socket_client, stream_socket_server, fsockopen et pfsockopen. Lorsque vous utilisez ces fonctions, il est important de vous rappeler que si de nombreuses fonctions ont le même nom que leur équivalents en langage C, elles ont souvent des déclarations différentes. Lisez attentivement les descriptions pour éviter des confusions. Cela dit, ceux qui ne sont pas familiers avec la programmation par socket peuvent toujours trouver beaucoup de documentation dans les pages de manuel Unix appropriées, et il y a une grande quantité d'introductions en langage C sur le web, qui peuvent être facilement réutilisés, avec des adaptations mineures. UNIX Socket FAQ est un bon début. &warn.experimental;

&reftitle.required; &no.requirement;

&reference.sockets.configure;

&reftitle.runtime; &no.config;

&reftitle.resources; &no.resource;

&reference.sockets.constants;

L'extension socket a été écrite pour fournir une interface utilisable avec les puissantes sockets fournies par BSD. Un soin particulier a été apporté pour que les fonctions soient aussi efficaces sous Unix que sous Windows. Presque toutes les fonctions de sockets peuvent échouer dans certaines circonstances, et émettent ainsi un message d'alerte E_WARNING décrivant l'erreur. Parfois, cela ne se fait pas selon les souhaits du développeur. Par exemple, la fonction socket_read peut tout à coup émettre un message E_WARNING car la connexion a été inopinément interrompu. Il est commun de supprimer les erreurs avec l'opérateur @ et de traiter les erreurs avec la fonction socket_last_error, au niveau application. Vous pouvez appeler socket_strerror avec le code d'erreur pour connaître le message d'erreur, humainement lisible. Reportez-vous à leur description pour plus de détails. Les messages E_WARNING généré par l'extension socket sont en anglais, mais le message d'erreur s'affichera en fonction de la configuration locale (LC_MESSAGES):

&reftitle.examples; Cet exemple montre comment créer un serveur simple. Changez les variables address et port pour vous adapter à votre configuration, et exécutez le. Vous pourrez alors vous connecter au serveur avec une commande comme ceci : telnet 192.168.1.53 10000 (en supposant que l'adresse et le port correspondent à votre configuration). Tout ce que vous saisissez après cela sera envoyé au serveur, et affiché en retour. Pour vous déconnecter, tapez 'quit'. ]]> Cet exemple implémente un client HTTP simple. Il se connecte simplement à une page, envoie une requête HEAD, affiche le résultat, et se termine. Connexion TCP/IP\n"; /* Lit le port du service WWW. */ $service_port = getservbyname('www', 'tcp'); /* Lit l'adresse IP du serveur de destination */ $address = gethostbyname('www.example.com'); /* Cree une socket TCP/IP. */ $socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP); if ($socket < 0) { echo "socket_create() a échoué : raison : " . socket_strerror ($socket) . "\n"; } else { echo "OK.\n"; } echo "Essai de connexion à '$address' sur le port '$service_port'..."; $result = socket_connect($socket, $address, $service_port); if ($result < 0) { echo "socket_connect() a échoué : raison : ($result) " . socket_strerror($result) . "\n"; } else { echo "OK.\n"; } $in = "HEAD / HTTP/1.0\r\n\r\n"; $in .= "Host: www.example.com\r\n"; $in .= "Connection: Close\r\n\r\n"; $out = ''; echo "Envoi de la requête HTTP HEAD..."; socket_write($socket, $in, strlen($in)); echo "OK.\n"; echo "Lire la réponse : \n\n"; while ($out = socket_read($socket, 2048)) { echo $out; } echo "Fermeture de la socket..."; socket_close($socket); echo "OK.\n\n"; ?> ]]>

&reference.sockets.functions;