(PHP 4 >= 4.1.0, PHP 5)
socket_getsockname — Pergunta o lado local dado do socket no qual deve retornar resultados no host/port ou no endereço UNIX filesystem, dependendo do tipo.
$socket
, string $&addr
[, int $&port
] )Esta função é EXPERIMENTAL. O comportamento desta função, seu nome, incluindo toda documentação pode ser modificado sem aviso em futuras versões do PHP. Esta função deve ser usada por sua própria conta e risco.
Se o socket dado é do tipo AF_INET
ou AF_INET6
, socket_getsockname()
irá retornar o endereço IP local 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 associa-o à porta.
Se o socket dado é do tipo AF_UNIX
,
socket_getsockname() irá retornar o endereço UNIX filesystem
(ex. /var/run/daemon.sock) no parâmetro
address
.
Nota: socket_getsockname() não deve ser usado com sockets
AF_UNIX
criados com socket_connect(). Somente sockets criados com socket_accept() ou sockets de servidores primários seguidos de uma chamada para socket_bind() irão retornar valores significativos.
Retorna TRUE
em caso de sucesso ou FALSE
em caso de falha. socket_getsockname() 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_getpeername(), socket_last_error() e socket_strerror().