array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.socket-create-listen.php', 1 => 'socket_create_listen', 2 => 'Ouvre un socket sur un port pour accepter les connexions', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Fonctions sur les sockets', ), 'prev' => array ( 0 => 'function.socket-create.php', 1 => 'socket_create', ), 'next' => array ( 0 => 'function.socket-create-pair.php', 1 => 'socket_create_pair', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/sockets/functions/socket-create-listen.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

socket_create_listen

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

socket_create_listen — Ouvre un socket sur un port pour accepter les connexions

Description

socket_create_listen(int $port, int $backlog = SOMAXCONN): Socket|false

socket_create_listen() crée une nouvelle instance de Socket, de type AF_INET, mise en attente sur toutes les interfaces locales, pour le port port.

socket_create_listen() sert à simplifier la création de nouveaux sockets destinés à être mis en attente, et accepter de nouvelles connexions.

Liste de paramètres

port

Le port que l'on doit écouter sur toutes les interfaces.

backlog

Le paramètre backlog définit la taille maximum de la queue de connexions en attente. SOMAXCONN peut être utilisée comme valeur pour le paramètre backlog. Se reporter à socket_listen() pour plus de détails.

Valeurs de retour

socket_create_listen() retourne une nouvelle instance de Socket en cas de succès et false en cas d'erreur. Le code d'erreur généré peut être obtenu en appelant la fonction socket_last_error(). Ce code d'erreur peut être passé à la fonction socket_strerror() pour obtenir un message d'erreur humainement lisible.

Historique

Version Description
8.4.0 La valeur par défaut est désormais SOMAXCONN. Auparavant, elle était 128.
8.0.0 En cas de succès, cette fonction retourne désormais une instance de Socket ; auparavant, une resource était retournée.

Notes

Note:

Pour créer un socket qui n'écoute que certaines interfaces, il faut utiliser socket_create(), socket_bind() et socket_listen().

Voir aussi