bool socket_getpeername ( resource $socket , string &$address [, int &$port ] )

Name	Beschreibung
socket	Ein gültiger Socket-Deskriptor, der von socket_create() oder socket_accept() erzeugt wurde.
address	Falls der angegebene Socket vom Typ AF_INET oder AF_INET6 ist, gibt socket_getpeername() die IP Addresse des entfernten Peers im Parameter address in der passenden Notation (z.B.127.0.0.1 oder fe80::1) im Parameter address zurück. Falls der optionale Parameter port angegeben ist, wird der zugehörige Port ebenfalls zurückgegeben. Falls der angegebene Socket vom Typ AF_UNIX ist, gibt socket_getpeername() den Pfad des Unix-Dateisystems (z.B. /var/run/daemon.sock) in dem Parameter address zurück.
port	Falls angegeben, wird hier der mit address verknüpfte Port zurückgegeben.

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben. socket_getpeername() kann aber auch FALSE zurückgeben, falls der Socket weder vom Typ AF_INET noch vom Typ AF_INET6 oder AF_UNIX ist. In diesem Fall wird der letzte Fehlercode für den Socket nicht aktualisiert.

Fragt das entfernte Ende eines gegebenen Sockets ab. Das Ergebnis ist vom Typ abhängig und ist entweder das Paar host/port oder ein Pfad des Unix-Dateisystems.

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

socket_getpeername() sollte nicht mit AF_UNIX-Sockets verwendet werden, die mit socket_accept() erzeugt wurden. Nur Sockets, die mit socket_connect() erzeugt wurden oder primäre Server-Sockets, nach einem Aufruf von socket_bind(), geben brauchbare Ergebnisse zurück.

Damit socket_getpeername() einen sinnvollen Wert zurückgibt, muss für den Socket, auf den sie angewendet wird, das Konzept "peer" sinnvoll sein.