stream_socket_server

Description

resource stream_socket_server ( string local_socket [, int &errno [, string &errstr [, int flags [, resource context]]]])

stream_socket_server() crée un flux ou un datagramme sur la socket spécifiée local_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.

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. La valeur par défaut est STREAM_SERVER_BIND | STREAM_SERVER_LISTEN.

stream_socket_server() ne fait que créer une socket, et pour accepter des connexions, vous devez utiliser stream_socket_accept().

Si l'appel échoue, stream_socket_server() 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 eterrstr 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().

Exemple 1. Exemple avec stream_socket_server() <?php $socket = stream_socket_server("tcp://0.0.0.0:8000", $errno, $errstr); if (!$socket) {   echo "$errstr ($errno)<br>\n"; } else {   while ($conn = stream_socket_accept($socket)) {     fputs ($conn, 'Merci de vous connecter &agrave; mon serveur. L\'heure locale est ' . date('n/j/Y g:i a') . "\n");     fclose ($conn);   }   fclose($socket); } ?>

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, tel que présenté avec la fonction stream_socket_client() :

Exemple 2. Utiliser un serveur de socket UDP <?php $socket = stream_socket_server("udp://0.0.0.0:13", $errno, $errstr); if (!$socket) {     echo "ERROR: $errno - $errstr<br>\n"; } else {   while ($conn = stream_socket_accept($socket)) {     fwrite($conn, date("D M j H:i:s Y\r\n"));     fclose($conn);   }   fclose($socket); } ?>

Voir aussi stream_socket_client(), stream_set_blocking(), stream_set_timeout(), fgets(), fgetss(), fputs(), fclose(), feof() et l'extension CURL.