Edit Report a Bug

    socket_bind

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

    socket_bind — Vincula un nombre a un socket

    Descripción

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

    Vincula el nombre dado en address al socket descrito por socket. Esto tiene que ser hecho antes de establecer una conexión usando socket_connect() o socket_listen().

    Parámetros

    socket

    Un recurso socket válido creado con socket_create().

    address

    Si el socket es de la familia AF_INET, address es una IP en notación decimal con puntos (p.ej. 127.0.0.1).

    Si el socket es de la familia AF_UNIX, address es una ruta de un socket de dominio Unix (p.ej. /tmp/my.sock).

    port (Optional)

    El parámetro port sólo se usa cuando se vincula un socket AF_INET, y designa el puerto en el que escuchar conexiones.

    Valores devueltos

    Devuelve true en caso de éxito o false en caso de error.

    El código de error se puede recuperar con socket_last_error(). Este código puede pasarse a socket_strerror() para obtener una explicación textual del error.

    Ejemplos

    Ejemplo #1 Usar socket_bind() para establecer la dirección de origen

    <?php
    // Crear un nuevo socket
    $sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);

    // Una lista de ejemplo de direcciones IP pertenecientes al ordenador
    $sourceips['kevin'] = '127.0.0.1';
    $sourceips['madcoder'] = '127.0.0.2';

    // Vincular la dirección de origen
    socket_bind($sock, $sourceips['madcoder']);

    // Conectar a la dirección de destino
    socket_connect($sock, '127.0.0.1', 80);

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

    // Cerrar
    socket_close($sock);

    ?>

    Notas

    Nota:

    ESta función se debe usar sobre el socket antes de socket_connect().

    Nota:

    Observación de compatibilidad con Windows 9x/ME: socket_last_error() puede devolver un código de error no válido si intenta vincular el socket a una dirección errónea que no pertenece a su máquina.

    Ver también

    add a note add a note

    User Contributed Notes 7 notes

    up
    15
    keksov[at]gmx.de
    22 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
    8
    dresende at thinkdigital dot pt
    13 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
    5
    php50613160534 dot 3 dot korkman at spamgourmet dot org
    19 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
    1
    gasket at cekkent dot net
    21 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
    -1
    ealexs at gmail dot com
    2 years ago
    I am posting this as I've spent a few hours debugging this.

    If you use socket_create / socket_bind with Unix domain sockets, then using socket_close at the end is not sufficient. You will get "address already in use" the second time you run your script. Call unlink on the file that is used for Unix domain sockets, preferably before you start to create the socket.

    <?php

    $socket_file     = "./test.sock";

    if (    file_exists($socket_file))
                unlink($socket_file);
    # optional file lock
    $socket = socket_create(AF_UNIX, SOCK_STREAM, 0);
    # ... socket_set_option ...
    socket_bind($socket, $socket_file);
    # ...
    socket_close($socket);
    # optional : release lock
    unlink($socket_file);

    ?>
    up
    -2
    gabriel at plenitech dot fr
    11 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
    13 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