(PHP 4 >= 4.1.0, PHP 5, PHP 7)
socket_bind — Verknüpft einen Socket mit einem Namen
$socket
, string $address
[, int $port
= 0
] ) : bool
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.
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
an Socket der AF_INET
-Familie
gebunden wird und gibt den Port an, an dem auf Verbindungen gelauscht
wird.
Gibt bei Erfolg TRUE
zurück. Im Fehlerfall wird FALSE
zurückgegeben.
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.
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);
?>
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.