socket_bind

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

socket_bind — Vincula um nome a um soquete

Descrição

socket_bind(Socket $socket, string $address, int $port = 0): bool

Vincula o nome informado em address ao soquete descrito por socket. Isto deve ser feito antes que uma conexão seja estabelecida usando socket_connect() ou socket_listen().

Parâmetros

socket

Uma instância de Socket criada com socket_create().

address

Se o soquete for da família AF_INET, o parâmetro address será um IP na notação de quatro inteiros separados por pontos (ex.: 127.0.0.1).

Se o soquete for da família AF_UNIX, o parâmetro address será o caminho para um soquete de domínio Unix (ex.: /tmp/my.sock).

port (opcional)

O parâmetro port é usado somente ao vincular um soquete AF_INET, e designa a porta na qual as conexões serão recebidas.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

O código de erro pode ser recuperado com socket_last_error(). Esse código pode ser passado para socket_strerror() para obter uma explicação textual do erro.

Registro de Alterações

Versão	Descrição
8.0.0	O parâmetro `socket` agora espera uma instância de Socket; anteriormente, um resource era esperado.

Exemplos

Exemplo #1 Usando socket_bind() para definir o endereço da origem

<?php
/ Cria um novo soquete
$sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);

/ Uma lista de exemplo de endereços IP de propriedade do computador
$sourceips['kevin']    = '127.0.0.1';
$sourceips['madcoder'] = '127.0.0.2';

/ Vincula o endereço de origem
socket_bind($sock, $sourceips['madcoder']);

/ Conexão ao endereço de destino
socket_connect($sock, '127.0.0.1', 80);

/ Escreve
$request = 'GET / HTTP/1.1' . "\r\n" .
           'Host: example.com' . "\r\n\r\n";
socket_write($sock, $request);

/ Fecha
socket_close($sock);

?>

Notas

Nota:
Esta função precisa ser usada no soquete antes de socket_connect().

Veja Também

socket_connect() - Inicia uma conexão em um soquete
socket_listen() - Escuta uma conexão em um soquete
socket_create() - Cria um soquete (ponto de extremidade para comunição)
socket_last_error() - Retorna o último erro no soquete
socket_strerror() - Retorna uma string descrevendo um erro no soquete

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

Notas Enviadas por Usuários (em inglês) 6 notes

down

keksov[at]gmx.de ¶

22 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:



<?php

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

    echo socket_strerror(socket_last_error($sock));

    exit;

}

?>



This solution was found by 

Christophe Dirac. Thank you Christophe!

down

dresende at thinkdigital dot pt ¶

13 years ago

Regarding previous post:

"0" has address is no different from "0.0.0.0"

127.0.0.1 -> accept only from local host
w.x.y.z (valid local IP) -> accep only from this network
0.0.0.0 -> accept from anywhere

down

php50613160534 dot 3 dot korkman at spamgourmet dot org ¶

19 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_listen($socket);
...

$socket_port contains the assigned port, you might want to send it to a remote client connecting. Tested with php 5.03.

down

ealexs at gmail dot com ¶

3 years ago

I am posting this as I've spent a few hours debugging this.

If you use socket_create / socket_bind with Unix domain sockets, then using socket_close at the end is not sufficient. You will get "address already in use" the second time you run your script. Call unlink on the file that is used for Unix domain sockets, preferably before you start to create the socket.

<?php

$socket_file = "./test.sock";

if (file_exists($socket_file))
        unlink($socket_file);
# optional file lock
$socket = socket_create(AF_UNIX, SOCK_STREAM, 0);
# ... socket_set_option ...
socket_bind($socket, $socket_file);
# ...
socket_close($socket);
# optional : release lock
unlink($socket_file);

?>

down

gasket at cekkent dot net ¶

21 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.

down

-3

gabriel at plenitech dot fr ¶

11 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.

Example:

<?php
$sockpath = '/tmp/my.sock';
socket_bind($socket, $sockpath);
/here: write-only (socket_send) to others, only owner can fetch data.
chmod($sockpath, 0702);
?>

＋adicione uma nota