(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_getpeername — Interroge l'autre extrémité de la communication
Interroge l'autre extrémité de la communication.
socketUne 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.
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é.
| Version | Description |
|---|---|
| 8.0.0 |
socket est désormais une instance de Socket ;
auparavant, c'était une resource.
|
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.