8.126 Flux
8 Référence des fonctions
Manuel PHP
. Introduction . Filtres de flux . Contextes de flux . Installation . Classes Stream . Constantes pré-définies . Erreurs de flux . Exemples . stream_bucket_append . stream_bucket_make_writeable . stream_bucket_new . stream_bucket_prepend . stream_context_create . stream_context_get_default . stream_context_get_options . stream_context_set_option . stream_context_set_params . stream_copy_to_stream . stream_filter_append . stream_filter_prepend . stream_filter_register . stream_filter_remove . stream_get_contents . stream_get_filters . stream_get_line . stream_get_meta_data . stream_get_transports . stream_get_wrappers . stream_register_wrapper . stream_select . stream_set_blocking . stream_set_timeout . stream_set_write_buffer . stream_socket_accept . stream_socket_client . stream_socket_enable_crypto . stream_socket_get_name . stream_socket_pair . stream_socket_recvfrom . stream_socket_sendto ->stream_socket_server . stream_wrapper_register . stream_wrapper_restore . stream_wrapper_unregister
|
8.126.41 stream_socket_server()
Crée une socket serveur Unix ou Internet
[ Exemples avec stream_socket_server ] PHP 5
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éée est déterminé par le transport spécifié avec le formatage
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
suivi de deux points et d'un numéro de port.
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. La valeur par défaut est
STREAM_SERVER_BIND
|
STREAM_SERVER_LISTEN
.
| Note | |
Pour les sockets UDP, vous devez utiliser
STREAM_SERVER_BIND
comme valeur pour le paramètre
flags
.
|
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 des appels à
connect()
,
bind()
, et
listen()
. Si la valeur retournée dans
errno
est
0
et que la fonction
a retourné
FALSE
, c'est une indication que l'erreur est survenue
avant l'appel à
bind()
. Cela est probablement dû
à un problème d'initialisation de la socket. Notez que
errno
et
errstr
doivent toujours être passés 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
sur le système est accessible via
stream_get_transports
. Voir
Liste des modes de transports de sockets disponibles pour une liste complète des transports disponibles.
| 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, '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
:
| Note | |
La plupart des systèmes ont besoin d'un accès administrateur
pour ouvrir une socket au-delà des ports 1024.
|
| Utiliser un serveur de socket UDP |
<?php $socket = stream_socket_server("udp://0.0.0.0:13", $errno, $errstr, STREAM_SERVER_BIND); 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); } ?>
|
| Note | |
Lors de la spécification d'adresses
IPv6 au format numérique (e.g. fe80::1) vous devez placer l'adresse IP
entre crochets. Par exemple :
tcp://[fe80::1]:80
.
|
Voir aussi
stream_socket_client
,
stream_set_blocking
,
stream_set_timeout
,
fgets
,
fgetss
,
fwrite
,
fclose
,
feof
et
l' extension CURL .
|