socket_getpeername
(PHP 4 >= 4.1.0, PHP 5)
socket_getpeername — Interroge l'autre extrémité de la communication
Description
$socket
, string &$address
[, int &$port
] )Interroge l'autre extrémité de la communication.
Liste de paramètres
-
socket -
Une ressource de socket valide, créée par la fonction socket_create() ou la fonction socket_accept().
-
address -
Si le socket
socketest de typeAF_INET, ouAF_INET6socket_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ètreaddress, et si le paramètre optionnelportest présent, elle retournera aussi le port de la communication établie.Si le socket
socketest de typeAF_UNIX, socket_getpeername() retournera le chemin sur le système de fichiers (e.g. /var/run/daemon.sock) dans le paramètreaddress. -
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 de le socket n'est ni AF_INET
AF_INET6, ni AF_UNIX, auquel cas le
dernier code d'erreur socket n'est pas modifié.
Notes
Note:
socket_getsockname() ne doit pas être utilisée avec les sockets
AF_UNIXcréés avec socket_accept(). Seules les sockets créées avec socket_connect() ou une socket serveur primaire suivant un appel à socket_bind() retourneront 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 conscepte de "peer" a du sens.
Voir aussi
- socket_getsockname() - Interroge le socket local
- socket_last_error() - Lit la dernière erreur générée par un socket
- socket_strerror() - Retourne une chaîne décrivant un message d'erreur
