Manual do PHP
Anterior |  | Próxima

# socket_getpeername

(PHP 4 >= 4.1.0, PHP 5)

socket_getpeername -- Pergunta ao lado remoto do socket dado qual deve ser o resultado em host/port ou no endereço UNIX filesystem, dependendo deste tipo.

## Descrição

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

Atenção
Esta função é EXPERIMENTAL. Isso quer dizer que o comportamento desta função e seu nome, incluindo TUDO o que está documentado aqui pode mudar em futuras versões do PHP, SEM QUALQUER NOTIFICAÇÃO. Esteja avisado, e use esta função por sua própria conta e risco.

Se o socket dado é do tipo `AF_INET` ou `AF_INET6`, socket_getpeername() irá retornar o peers (remote) IP address na notação apropriada (ex. 127.0.0.1 ou fe80::1) no parâmetro address e, se o parâmetro opcional port está presente, também o associa à porta.

Se o socket dado é do tipo `AF_UNIX`, socket_getpeername() irá retornar o endereço UNIX filesystem (ex. /var/run/daemon.sock) no parâmetro address.

> Nota: socket_getpeername() não deve ser usado com sockets `AF_UNIX` criados com socket_accept(). Somente sockets criados com socket_connect() ou um socket de servidor primário seguindo uma chamada para socket_bind() irá retornar valores significativos.

Retorna `TRUE` em caso de sucesso ou `FALSE` em falhas. socket_getpeername() deve também retornar `FALSE` se o tipo de socket não é algum destes `AF_INET`, `AF_INET6`, ou `AF_UNIX`, no caso o último código de erro do socket não é atualizado.

Veja também socket_getsockname(), socket_last_error() e socket_strerror().

Anterior | Principal | Próxima
socket_get_option | Acima | socket_getsockname