(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_bind — Asocia un nombre a un socket
Asocia el nombre proporcionado por address a la
interfaz de conexión descrita por socket. Esto debe
realizarse antes de que se establezca una conexión utilizando
socket_connect() o socket_listen().
socketUna instancia de Socket creada por socket_create().
address
Si el socket pertenece a la familia AF_INET, el parámetro
address es una IP numérica
(i.e. 127.0.0.1).
Si el socket pertenece a la familia AF_UNIX, el parámetro
address representa la ruta de un socket de dominio Unix
(i.e. /tmp/my.sock).
port (opcional)
El parámetro port solo se utiliza al
asociar un socket AF_INET y designa el puerto
en el que escuchar para una conexión.
Devuelve true en caso de éxito o false en caso de error.
El código de error puede ser recuperado con la función socket_last_error(). Este código puede ser pasado a la función socket_strerror() para recuperar el mensaje textual del error.
| Versión | Descripción |
|---|---|
| 8.0.0 |
socket is a Socket instance now;
previously, it was a resource.
|
Ejemplo #1 Uso de socket_bind() para definir la dirección de origen
<?php
// Creación de un nuevo socket
$sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
// Una lista de direcciones IP, por ejemplo, pertenecen a la computadora
$sourceips['kevin'] = '127.0.0.1';
$sourceips['madcoder'] = '127.0.0.2';
// Asocia la dirección de origen
socket_bind($sock, $sourceips['madcoder']);
// Conexión a la dirección de destino
socket_connect($sock, '127.0.0.1', 80);
// Escritura
$request = 'GET / HTTP/1.1' . "\r\n" .
'Host: example.com' . "\r\n\r\n";
socket_write($sock, $request);
// Cierre
socket_close($sock);
?>Nota:
Esta función debe ser utilizada en el socket antes de la función socket_connect().
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!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 anywhereUse 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.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);
?>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.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);
?>