Documentación offline PHP master

socket_bind

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

socket_bind

Asocia un nombre a un socket

Descripción#

socket_bind(Socket $socket, string $address, [int $port]): bool
```php

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.5.0 | Ahora lanza un ValueError cuando `port` es menor que 0 o mayor que 65535. |
| 8.0.0 | `socket` ahora es una instancia de `Socket` ; anteriormente, era un `resource`. |

## Ejemplos

Uso de `socket_bind` para definir la dirección de origen

```php

Notas#

[!NOTE] Esta función debe ser utilizada en el socket antes de la función socket_connect.

Véase también#

socket_connect, socket_listen, socket_create, socket_last_error, socket_strerror