(PHP 4 >= 4.1.0, PHP 5)
socket_getpeername — Interroga il lato remoto di un dato socket per ottenere o la combinazione host/porta od un percorso Unix, in base al tipo di socket
$socket
, string $&indirizzo
[, int $&porta
] )Questa funzione è SPERIMENTALE. Ovvero, il comportamento di questa funzione, il nome di questa funzione, in definitiva tutto ciò che è documentato qui può cambiare nei futuri rilasci del PHP senza preavviso. Siete avvisati, l'uso di questa funzione è a vostro rischio.
Se il socket dato è di tipo AF_INET oppure AF_INET6,
socket_getpeername() restituisce l'indirizzo IP
remoto nella notazione appropriata (ad esempio
127.0.0.1 oppure fe80::1) nel parametro indirizzo
e, se presente il parametro opzionale porta,
anche la porta associata.
Se il socket dato è di tipo AF_UNIX,
socket_getpeername() restituirà un percorso Unix
(ad esempio /var/run/daemon.sock) nel
parametro indirizzo.
Nota: La funzione socket_getpeername() non dovrebbe essere usata con socket
AF_UNIXcreati da socket_accept(). Soltanto i socket creati con socket_connect() o un socket server primario conseguente alla chiamata di socket_bind() restituirà dei valori significativi.
Restituisce TRUE in caso di successo, FALSE in caso di fallimento. socket_getpeername() può anche restituire
FALSE se il tipo di socket non è AF_INET, AF_INET6 o
AF_UNIX, in questo caso l'ultimo codice di errore del socket
non viene aggiornato.
Vedere anche socket_getsockname(), socket_last_error() e socket_strerror().