Submit a Pull Request Report a Bug

    socket_bind

    (PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

    socket_bind — Bind di un nome ad un socket

    Descrizione

    socket_bind(resource $socket, string $address, int $port = ?): bool

    La funzione socket_bind() esegue il bind del nome passato in indirizzo sul socket indicato da socket,

    Elenco dei parametri

    socket

    Una valida risorsa di tipo socket creata da socket_create().

    address

    Se il socket appartiene alla famiglia AF_INET, il parametro address è un classico indirizzo IP (ad esempio 127.0.0.1)

    Se il socket appartiene alla famiglia AF_UNIX, il parametro address indica il percorso di un socket nel dominio Unix (ad esempio /tmp/my.sock).

    port (Optional)

    Il parametro port, si utilizza soltanto con le connessioni tramite un socket di tipo AF_INET, ed indica quale porta sul server remoto si debba utilizzare per eseguire la connessione.

    Valori restituiti

    Restituisce true in caso di successo, false in caso di fallimento.

    Il codice di errore può essere recuperato con socket_last_error(). Questo codice può essere passato alla funzione socket_strerror() per ottenere una descrizione dell'errore.

    Esempi

    Example #1 Utilizzo di socket_bind() per impostare un indirizzo sorgente

    <?php
    // Crea il nuovo socket
    $sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);

    // Un esempio di elenco di IP del proprio computer
    $sourceips['kevin'] = '127.0.0.1';
    $sourceips['madcoder'] = '127.0.0.2';

    // Bind degli indirizzi
    socket_bind($sock, $sourceips['madcoder']);

    // Connessione all'indirisso di destinazione
    socket_connect($sock, '127.0.0.1', 80);

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

    // Chiusura
    socket_close($sock);

    ?>

    Note

    Nota:

    Questa funzione deve essere utilizzata sui socket prima di socket_connect().

    Nota:

    Windows 9x/ME nota di compatibilità: socket_last_error() può restituire un codice di errore non valido se si tenta il bind del socket ad un indirizzo errato che non appartiene alla propria macchina.

    Vedere anche:

    add a note add a note

    User Contributed Notes 6 notes

    up
    8
    dresende at thinkdigital dot pt
    12 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
    21 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
    18 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
    20 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
    10 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
    12 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