socket_bind
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_bind — Passa um nome para o socket
Descrição
socket_bind(resource $socket
, string $address
, 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.
socket_bind() passa o nome dado em
address
para o socket descrito por
socket
, que deve ser um resource socket válido
criado com socket_create().
O parâmetro address
é qualquer endereço IP
na notação "dotted-quad" (ex. 127.0.0.1
), se o socket é da família AF_INET
; ou o pathname de um
Unix-domain socket, se o socket é da família
AF_UNIX
.
O parâmetro port
é somente usado quando
estiver conectando com um socket AF_INET
, e
determina a porta no host remoto para o qual a conexão deve ser feita.
Retorna true
em caso de sucesso ou false
em caso de falha. O código de erro pode ser retornado com
socket_last_error(). Esse código deve ser passado para
socket_strerror() para pegar uma explicação textual do
erro. Note que socket_last_error() é reportado para
retornar um código de erro inválido no caso de você estar tentando passar um socket
para um endereço errado que não pertence à sua máquina Windows 9x/ME.
Veja também
socket_connect(),
socket_listen(),
socket_create(),
socket_last_error() e
socket_strerror().