socket_bind

(PHP 4 >= 4.1.0, PHP 5)

socket_bind — Verknüpft einen Socket mit einem Namen

Beschreibung

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

socket_bind() verknüpft den Namen, der in address angegeben ist, mit dem Socket socket . Dies muss ein gültiger Socket-Deskriptor sein, der entweder mit socket_create() oder mit socket_listen() erzeugt wurde.

Parameter-Liste

socket

Ein gültiger Socket-Deskriptor, der mit socket_create() erzeugt wurde.

address

Falls der Socket zur AF_INET-Familie gehört, ist der Parameter address eine IP in Punktnotation (z.B. 127.0.0.1)

Falls der Socket zur AF_UNIX-Familie gehört, ist der Parameter address der Pfad eines Unix-Domain Sockets (z.B. /tmp/my.sock).

port (Optional)

Der Parameter port wird nur benutzt, wenn zu einem Socket der AF_INET-Familie verbunden wird und gibt an, zu welchem Port des entfernten Hosts eine Verbindung hergestellt werden soll.

Rückgabewerte

Gibt bei Erfolg TRUE zurück, im Fehlerfall FALSE.

Der Fehlercode kann mit der Funktion socket_last_error() abgefragt werden. Dieser Fehlercode kann an die Funktion socket_strerror() übergeben werden, um eine textuelle Beschreibung des Fehlers zu erhalten.

Beispiele

Beispiel #1 Beispiel: Quell-Adresse setzen mit socket_bind():


<?php
// Einen neuen Socket erzeugen
$sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);

// Eine (Beispiel-) Liste von IP-Adressen dieses Computers
$sourceips['kevin']    = '127.0.0.1';
$sourceips['madcoder'] = '127.0.0.2';

// Eine Quell-Adresse an den Socket binden
socket_bind($sock, $sourceips['madcoder']);

// Zur Zieladresse verbinden
socket_connect($sock, '127.0.0.1', 80);

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

// Die Socketverbindung schlieen
socket_close($sock);

?>

Anmerkungen

Hinweis: Diese Funktion muss vor socket_connect() aufgerufen werden.

Hinweis: Kompatibilität mit Windows 9x/ME: socket_last_error() kann einen falschen Fehlercode zurückgeben, wenn versucht wird, den Socket an eine Adresse zu binden, die nicht dem aktuellen Rechner gehört.

Siehe auch

socket_connect() - Baut eine Verbindung über einen Socket auf
socket_listen() - Hört einen Socket nach Verbindungsanforderungen ab
socket_create() - Erzeugt einen Socket (Endpunkt für die Kommunikation)
socket_last_error() - Gibt den letzten Fehler zurück, der an einem Socket aufgetreten ist
socket_strerror() - Gibt einen String zurück, der einen socket-Fehler beschreibt

socket_clear_error

socket_accept

Last updated: Fri, 30 Oct 2009

add a note User Contributed Notes
socket_bind

php50613160534 dot 3 dot korkman at spamgourmet dot org
13-Jun-2005 03: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 03: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
14-Feb-2003 12: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 08: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

socket_clear_error

socket_accept

Last updated: Fri, 30 Oct 2009