PHPerKaigi 2021
    Submit a Pull Request Report a Bug

    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 ( Socket $socket , string $address , int $port = 0 ) : bool

    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 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 (ojptional)

    Der Parameter port wird nur benutzt, wenn an einen Socket der AF_INET-Familie gebunden wird und gibt den Port an, an dem auf Verbindungen gelauscht wird.

    Rückgabewerte

    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 is a Socket instance now; previously, it was a 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 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

    add a note add a note

    User Contributed Notes 6 notes

    up
    8
    dresende at thinkdigital dot pt
    9 years ago
    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 anywhere
    up
    12
    keksov[at]gmx.de
    18 years ago
    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!
    up
    3
    php50613160534 dot 3 dot korkman at spamgourmet dot org
    15 years ago
    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.
    up
    2
    gasket at cekkent dot net
    17 years ago
    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.
    up
    -2
    gabriel at plenitech dot fr
    7 years ago
    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);
    ?>
    up
    -11
    Mex
    9 years ago
    It appears for the $address parameter:

    '127.0.0.1'
    accepts clients from localhost (eg. 127.0.0.1)

    '0.0.0.0'
    accepts clients from localhost, and the server's network (eg. 127.0.0.1, 192.168.2.5, 10.20.30.40)

    '0' or 0
    accepts clients from localhost, the server's network, and external networks (eg. 127.0.0.1, 192.168.2.5, 10.20.30.40, 209.85.169.99)
    add a note add a note
    To Top