Manuale PHP
Indietro |  | Avanti

# socket_bind

(PHP 4 >= 4.1.0, PHP 5)

socket_bind -- Bind di un nome ad un socket

## Descrizione

bool socket_bind ( resource socket, string address [, int port] )

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

Esempio 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:

socket_connect()
socket_listen()
socket_create()
socket_last_error()
socket_strerror()

Indietro | Partenza | Avanti
socket_accept | Risali | socket_clear_error