# 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 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é.

### 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() 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