array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.socket-bind.php', 1 => 'socket_bind', 2 => 'Vincula um nome a um soquete', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Funções de Socket', ), 'prev' => array ( 0 => 'function.socket-atmark.php', 1 => 'socket_atmark', ), 'next' => array ( 0 => 'function.socket-clear-error.php', 1 => 'socket_clear_error', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/sockets/functions/socket-bind.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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