array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.socket-bind.php', 1 => 'socket_bind', 2 => 'Asocia un nombre a un socket', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Funciones de Socket', ), 'prev' => array ( 0 => 'function.socket-atmark.php', 1 => 'socket_atmark', ), 'next' => array ( 0 => 'function.socket-clear-error.php', 1 => 'socket_clear_error', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/sockets/functions/socket-bind.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

socket_bind

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

socket_bind — Asocia un nombre a un socket

Descripción

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

Asocia el nombre proporcionado por address a la interfaz de conexión descrita por socket. Esto debe realizarse antes de que se establezca una conexión utilizando socket_connect() o socket_listen().

Parámetros

socket

Una instancia de Socket creada por socket_create().

address

Si el socket pertenece a la familia AF_INET, el parámetro address es una IP numérica (i.e. 127.0.0.1).

Si el socket pertenece a la familia AF_UNIX, el parámetro address representa la ruta de un socket de dominio Unix (i.e. /tmp/my.sock).

port (opcional)

El parámetro port solo se utiliza al asociar un socket AF_INET y designa el puerto en el que escuchar para una conexión.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

El código de error puede ser recuperado con la función socket_last_error(). Este código puede ser pasado a la función socket_strerror() para recuperar el mensaje textual del error.

Historial de cambios

Versión Descripción
8.0.0 socket ahora es una instancia de Socket ; anteriormente, era un resource.

Ejemplos

Ejemplo #1 Uso de socket_bind() para definir la dirección de origen

<?php
// Creación de un nuevo socket
$sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);

// Una lista de direcciones IP, por ejemplo, pertenecen a la computadora
$sourceips['kevin'] = '127.0.0.1';
$sourceips['madcoder'] = '127.0.0.2';

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

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

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

// Cierre
socket_close($sock);

?>

Notas

Nota:

Esta función debe ser utilizada en el socket antes de la función socket_connect().

Ver también