socket_bind

(PHP 4 >= 4.1.0, PHP 5)

socket_bind — Vincula un nombre a un socket

Descripción

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

Vincula el nombre dado en address al socket descrito por socket. Esto tiene que ser hecho antes de establecer una conexión usando socket_connect() o socket_listen().

Parámetros

socket

Un recurso socket válido creado con socket_create().

address

Si el socket es de la familia AF_INET, address es una IP en notación decimal con puntos (p.ej. 127.0.0.1).

Si el socket es de la familia AF_UNIX, address es una ruta de un socket de dominio Unix (p.ej. /tmp/my.sock).

port (Optional)

El parámetro port sólo se usa cuando se vincula un socket AF_INET, y designa el puerto en el que escuchar conexiones.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

El código de error se puede recuperar con socket_last_error(). Este código puede pasarse a socket_strerror() para obtener una explicación textual del error.

Ejemplos

Example #1 Usar socket_bind() para establecer la dirección de origen


<?php
// Crear un nuevo socket
$sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);

// Una lista de ejemplo de direcciones IP pertenecientes al ordenador
$sourceips['kevin']    = '127.0.0.1';
$sourceips['madcoder'] = '127.0.0.2';

// Vincular la dirección de origen
socket_bind($sock, $sourceips['madcoder']);

// Conectar a la dirección de destino
socket_connect($sock, '127.0.0.1', 80);

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

// Cerrar
socket_close($sock);

?>

Notas

Note:
ESta función se debe usar sobre el socket antes de socket_connect().

Note:
Observación de compatibilidad con Windows 9x/ME: socket_last_error() puede devolver un código de error no válido si intenta vincular el socket a una dirección errónea que no pertenece a su máquina.

Ver también

socket_connect() - Inicia una conexión sobre un socket
socket_listen() - Escucha una conexión sobre un socket
socket_create() - Crear un socket (extremo de comunicación)
socket_last_error() - Devuelve el último error sobre un socket
socket_strerror() - Devuelve una cadena que describe un error de socket

socket_clear_error

socket_accept

Last updated: Fri, 20 May 2011

add a note User Contributed Notes socket_bind

ionisis.com 21-May-2011 02:30


In Re: masuod_a at hotmail dot com



That may have worked in the past, but now it must have changed. However, while developing the http://ionisis.com DNS2 prototype, we were able to get it to bind on all interfaces using the '0.0.0.0' convention (go figure). Hopefully this doesn't change in the future, as it's very necessary to have this functionality.

php50613160534 dot 3 dot korkman at spamgourmet dot org 13-Jun-2005 01:16


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.

gasket at cekkent dot net 04-May-2003 01:19


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.

masuod_a at hotmail dot com 13-Feb-2003 11:31


If you want to connect to server by specified port and you don't know your ip address or you have multiple interface for connecting to network, you can bind null instead of valid ip address like this :





<?php


$socket=socket_create(AF_INET,SOCK_STREAM,SOL_TCP);


$local_port=1023;


socket_bind($socket,null,$local_port);


socket_connect($socket,$remote_host,$remote_port);





?>

keksov[at]gmx.de 10-Jun-2002 06:22


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!

add a note