socket_getsockname
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
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.
Descrição
socket_getsockname(resource $socket
, string $&addr
, int $&port
= ?): bool
AvisoEsta função é
EXPERIMENTAL. O comportamento desta função, seu nome e
documentação poderão mudar sem aviso prévio em futuras versões do PHP.
Use por sua 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().