(PHP 5, PHP 7, PHP 8)
stream_socket_server — Crée un socket serveur Unix ou Internet
$address
,&$error_code
= null
,&$error_message
= null
,$flags
= STREAM_SERVER_BIND | STREAM_SERVER_LISTEN,$context
= null
stream_socket_server() crée un flux ou un datagramme sur le socket spécifié address
.
stream_socket_server() ne fait que créer un socket et, pour accepter des connexions, vous devez utiliser stream_socket_accept().
address
Le type de socket créé est déterminé par le transport spécifié avec le formatage URL suivant : transport://target
.
Pour un 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 un socket Unix, la cible
doit être un fichier de socket du système.
En fonction de votre environnement, les sockets de domaine Unix peuvent être indisponibles. Une liste des transports disponibles est accessible via stream_get_transports(). Voyez Liste des modes de transport de sockets disponibles pour connaître la liste des transports natifs.
error_code
Si les arguments optionnels error_code
et error_message
sont présents, ils seront configurés pour indiquer le niveau d'erreur actuel des fonctions système socket()
, bind()
et listen()
. Si la valeur retournée dans error_code
est 0
, et que la fonction retourne false
, c'est une indication que l'erreur est survenue avant l'appel à bind()
. Ceci est probablement dû à un problème d'initialisation du socket. Notez que les arguments error_code
et error_message
seront toujours passés par référence.
error_message
Voyez la description de error_code
.
flags
Un champ de bits, qui peut être la combinaison de n'importe quelle option de création de socket.
Note:
Pour les sockets UDP, vous devez utiliser la constante
STREAM_SERVER_BIND
comme valeur du paramètreflags
.
context
Retourne le flux créé, ou bien false
en cas d'erreur.
Version | Description |
---|---|
8.0.0 | context est désormais nullable. |
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, '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 (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 un socket sur les ports en dessous de 1024.
Exemple #2 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
.