Manuale PHP
Indietro |  | Avanti

# 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 socket

## Descrizione

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

Indietro | Partenza | Avanti
socket_get_option | Risali | socket_getsockname