socket_bind
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_bind — Verknüpft einen Socket mit einem Namen
Beschreibung
socket_bind() verknüpft den Namen, der in
address angegeben ist, mit dem Socket
socket. Dies muss geschehen, bevor eine Verbindung
mittels socket_connect() oder
socket_listen() aufgebaut wird.
Parameter-Liste
-
socket -
Eine Socket-Instanz, die mit socket_create() erzeugt wurde.
-
address -
Falls der Socket zur
AF_INET-Familie gehört, ist der Parameteraddresseine IP in Punktnotation (z. B.127.0.0.1)Falls der Socket zur
AF_UNIX-Familie gehört, ist der Parameteraddressder Pfad eines Unix-Domain Sockets (z. B. /tmp/my.sock). -
port(optional) -
Der Parameter
portwird nur verwendet, wenn an einen Socket derAF_INET-Familie gebunden wird, und gibt den Port an, an dem auf Verbindungen gelauscht wird.
Rückgabewerte
Gibt bei Erfolg true zurück. Bei einem Fehler 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.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 |
socket ist nun eine
Socket-Instanz; vorher war es eine
resource.
|
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 schließen
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
