socket_getpeername
(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 socketDescrizione
bool socket_getpeername ( resource socket, string &indirizzo [, int &porta] )| Avvertimento |
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_UNIX creati 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().