array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.socket-getpeername.php', 1 => 'socket_getpeername', 2 => 'Interroge l\'autre extrémité de la communication', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Fonctions sur les sockets', ), 'prev' => array ( 0 => 'function.socket-getopt.php', 1 => 'socket_getopt', ), 'next' => array ( 0 => 'function.socket-getsockname.php', 1 => 'socket_getsockname', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/sockets/functions/socket-getpeername.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

socket_getpeername

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

socket_getpeername — Interroge l'autre extrémité de la communication

Description

socket_getpeername(Socket $socket, string &$address, int &$port = null): bool

Interroge l'autre extrémité de la communication.

Liste de paramètres

socket

Une instance de Socket créée par socket_create() ou socket_accept().

address

Si le socket socket est de type AF_INET, ou AF_INET6 socket_getpeername() retournera l'adresse IP de l'hôte, en notation numérique (e.g. 127.0.0.1 ou fe80::1) dans le paramètre address, et si le paramètre optionnel port est présent, elle retournera aussi le port de la communication établie.

Si le socket socket est de type AF_UNIX, socket_getpeername() retournera le chemin sur le système de fichiers (e.g. /var/run/daemon.sock) dans le paramètre address.

port

Si fourni, ce devra être le port associé à l'adresse du paramètre address.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient. socket_getpeername() peut aussi retourner false si le type du socket n'est ni AF_INET AF_INET6, ni AF_UNIX, auquel cas le dernier code d'erreur socket n'est pas modifié.

Historique

Version Description
8.0.0 socket est désormais une instance de Socket ; auparavant, c'était une resource.

Notes

Note:

socket_getsockname() ne doit pas être utilisée avec les sockets AF_UNIX créés avec socket_accept(). Seules les sockets créées avec socket_connect() ou une socket serveur primaire suivant un appel à socket_bind() retournent des valeurs logiques.

Note:

Pour faire en sorte que la fonction socket_getpeername() retourne une valeur cohérente, le socket sur lequel la fonction est appelée doit évidemment être un pour qui le concept de "peer" a un sens.

Voir aussi