stream_socket_sendto
stream_socket_shutdown
Fonctions sur les flux
PHP Manual

# stream_socket_server

(PHP 5)

stream_socket_server — Crée une socket serveur Unix ou Internet

### Description

resource stream_socket_server ( string `$local_socket` [, int `&$errno` [, string `&$errstr` [, int `$flags` = STREAM_SERVER_BIND | STREAM_SERVER_LISTEN [, resource `$context` ]]]] )

stream_socket_server() crée un flux ou un datagramme sur la socket spécifiée `local_socket`.

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

### Liste de paramètres

`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.

  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.

`errno`

  Si les arguments optionnels `errno` et `errstr` 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 `errno` 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 de la socket. Notez que les arguments `errno` et `errstr` seront toujours passés par référence.

`errstr`

  Voyez la description de `errno`.

`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ètre `flags`.

`context`

### Valeurs de retour

Retourne le flux créé, ou bien `FALSE` en cas d'erreur.

### Exemples

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 une 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);
}
?>`

### Notes

> 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() - Ouvre une connexion socket Internet ou Unix
- stream_set_blocking() - Configure le mode bloquant d'un flux
- stream_set_timeout() - Configure la durée d'expiration d'un flux
- fgets() - Récupère la ligne courante sur laquelle se trouve le pointeur du fichier
- fgetss() - Renvoie la ligne courante du fichier et élimine les balises HTML
- fwrite() - Écrit un fichier en mode binaire
- fclose() - Ferme un fichier
- feof() - Teste la fin du fichier
- Extension Curl

stream_socket_sendto
stream_socket_shutdown
Fonctions sur les flux
PHP Manual