socket_create

(PHP 4 >= 4.1.0)

socket_create -- Crea un socket (punto terminale di una comunicazione).

Descrizione

resource socket_create ( int dominio, int tipo, int protocollo)

Attenzione

Questa funzione è SPERIMENTALE. Ovvero, il comportamento di questa funzione, il nome di questa funzione, in definitiva tutto ciò che è documentato qui può cambiare nei futuri rilasci del PHP senza preavviso. Siete avvisati, l'uso di questa funzione è a vostro rischio.

La funzione crea un punto terminale di una comunicazione (un socket) e restituisce una risorsa di tipo socket.

Il parametro dominio indica il dominio (famiglia di protocolli da usarsi per la comunicazione). Attualmente i valori ammessi sono AF_INET e AF_UNIX. Normalmente AF_INET viene utilizzato per le comunicazione basate su internet. Mentre AF_UNIX utilizza dei percorsi per identificare i socket e quindi può essere usato solo per connessioni locali (che d'altra parte è più veloce).

Il parametro tipo indica il tipo di socket. I tipi ammessi sono SOCK_STREAM, SOCK_DGRAM, SOCK_SEQPACKET, SOCK_RAW, SOCK_RDM oppure SOCK_PACKET. I due tipi più comuni sono SOCK_DGRAM per comunicazioni UDP e SOCK_STREAM per comunicazioni TCP.

Il parametro protocollo indica il protocollo e può essere SOL_UDP oppure SOL_TCP.

La funzione restituisce una risorsa di tipo socket se ha successo, oppure FALSE in caso di errore. In quest'ultimo caso si può ottenere il codice di errore tramite socket_last_error(). Tale codice può essere passato alla funzione socket_strerror() per ottenere una descrizione dell'errore.

Per maggiori dettagli sull'utilizzo di socket_create(), e sul significato dei vari parametri si può consultare il man di Unix alle pagine socket (2).

Nota: Se si forniscono valori non validi per dominio o tipo, la funzione socket_create() imposta i parametri rispettivamente a AF_INET e SOCK_STREAM ed emette un messaggio di tipo E_WARNING.

Vedere anche socket_accept(), socket_bind(), socket_connect(), socket_listen(), socket_last_error() e socket_strerror().