PHP 7.2.7 Released


(PHP 4 >= 4.1.0, PHP 5, PHP 7)

socket_bindPassa um nome para o socket


bool socket_bind ( resource $socket , string $address [, int $port ] )

Esta função é EXPERIMENTAL. O comportamento, seu nome e documentação podem mudar sem aviso em futuras versões do PHP. Utilize por sua própria 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., 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().

add a note add a note

User Contributed Notes 6 notes

16 years ago
If you want to reuse address and port, and get rid of error: unable to bind, address already in use, you have to use socket_setopt (check actual spelling for this function in you PHP verison) before calling bind:

if (!socket_set_option($sock, SOL_SOCKET, SO_REUSEADDR, 1)) {

This solution was found by
Christophe Dirac. Thank you Christophe!
dresende at thinkdigital dot pt
6 years ago
Regarding previous post:

"0" has address is no different from "" -> accept only from local host
w.x.y.z (valid local IP) -> accep only from this network -> accept from anywhere
gabriel at plenitech dot fr
4 years ago
When doing Unix sockets, it might be necessary to chmod the socket file so as to give Write permission to Group and/or Others. Otherwise, only the owner is allowed to write data into the stream.


= '/tmp/my.sock';
socket_bind($socket, $sockpath);
//here: write-only (socket_send) to others, only owner can fetch data.
chmod($sockpath, 0702);
php50613160534 dot 3 dot korkman at spamgourmet dot org
13 years ago
Use 0 for port to bind a random (free) port for incoming connections:

socket_bind ($socket, $bind_address, 0);
socket_getsockname($socket, $socket_address, $socket_port);

$socket_port contains the assigned port, you might want to send it to a remote client connecting. Tested with php 5.03.
gasket at cekkent dot net
15 years ago
The aforementioned tidbit about using NULL to bind to all addresses did not work for me, as I would receive an error about unknown address. Using a 0 worked for me:

socket_bind ($socket, 0, $port)

This also allows you to receive UDP broadcasts, which is what I had been trying to figure out.
6 years ago
It appears for the $address parameter:

accepts clients from localhost (eg.

accepts clients from localhost, and the server's network (eg.,,

'0' or 0
accepts clients from localhost, the server's network, and external networks (eg.,,,
To Top