XCVI. Sockets

Avertissement

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.

Pour une interface client plus générique, reportez vous à fsockopen() et pfsockopen().

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"; ?>

Table des matières
socket_accept -- Accepts a connection on a socket
socket_bind -- Binds a name to a socket
socket_clear_error -- Clears the error on the socket or the last error code
socket_close -- Closes a socket resource
socket_connect -- Initiates a connection on a socket
socket_create_listen -- Opens a socket on port to accept connections
socket_create_pair -- Creates a pair of indistinguishable sockets and stores them in fds.
socket_create -- Create a socket (endpoint for communication)
socket_get_option -- Gets socket options for the socket
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
socket_iovec_delete -- Deletes a vector from an array of vectors
socket_iovec_fetch -- Returns the data held in the iovec specified by iovec_id[iovec_position]
socket_iovec_free -- Frees the iovec specified by iovec_id
socket_iovec_set -- Sets the data held in iovec_id[iovec_position] to new_val
socket_last_error -- Returns the last error on the socket
socket_listen -- Listens for a connection on a socket
socket_read -- Reads a maximum of length bytes from a socket
socket_readv -- Reads from an fd, using the scatter-gather array defined by iovec_id
socket_recv -- Receives data from a connected socket
socket_recvfrom -- Receives data from a socket, connected or not
socket_recvmsg -- Used to receive messages on a socket, whether connection-oriented or not
socket_select -- Runs the select() system call on the given arrays of sockets with a timeout specified by tv_sec and tv_usec
socket_send -- Sends data to a connected socket
socket_sendmsg -- Sends a message to a socket, regardless of whether it is connection-oriented or not
socket_sendto -- Sends a message to a socket, whether it is connected or not
socket_set_nonblock -- Sets nonblocking mode for file descriptor fd
socket_set_option -- Sets socket options for the socket
socket_shutdown -- Shuts down a socket for receiving, sending, or both.
socket_strerror -- Return a string describing a socket error
socket_write -- Write to a socket
socket_writev -- Writes to a file descriptor, fd, using the scatter-gather array defined by iovec_id