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', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Funções para 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' => 'en', 'path' => 'reference/sockets/functions/socket-bind.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_bind — Binds a name to a socket
Binds the name given in address
to the socket
described by socket
. This has to be done before
a connection is established using socket_connect()
or socket_listen().
socket
A Socket instance created with socket_create().
address
If the socket is of the AF_INET
family, the
address
is an IP in dotted-quad notation
(e.g. 127.0.0.1
).
If the socket is of the AF_UNIX
family, the
address
is the path of a
Unix-domain socket (e.g. /tmp/my.sock).
port
(Optional)
The port
parameter is only used when
binding an AF_INET
socket, and designates
the port on which to listen for connections.
Retorna true
em caso de sucesso ou false
em caso de falha.
The error code can be retrieved with socket_last_error(). This code may be passed to socket_strerror() to get a textual explanation of the error.
Versão | Descrição |
---|---|
8.0.0 |
O parâmetro socket agora espera uma instância de Socket;
anteriormente, um resource era esperado.
|
Exemplo #1 Using socket_bind() to set the source address
<?php
// Create a new socket
$sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
// An example list of IP addresses owned by the computer
$sourceips['kevin'] = '127.0.0.1';
$sourceips['madcoder'] = '127.0.0.2';
// Bind the source address
socket_bind($sock, $sourceips['madcoder']);
// Connect to destination address
socket_connect($sock, '127.0.0.1', 80);
// Write
$request = 'GET / HTTP/1.1' . "\r\n" .
'Host: example.com' . "\r\n\r\n";
socket_write($sock, $request);
// Close
socket_close($sock);
?>
Nota:
This function must be used on the socket before socket_connect().
Nota:
Windows 9x/ME compatibility note: socket_last_error() may return an invalid error code if trying to bind the socket to a wrong address that does not belong to your machine.