socket_get_option
Descrizione
mixed socket_get_option ( resource socket, int level, int optname )| Avvertimento |
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 socket_get_option() restituisce i valori per il parametro indicato in optname per il socket indicato da socket. La funzione restituisce FALSE se non riesce.
Il parametro level specifica a quale livello di protocollo risiede l'opzione cercata. Ad esempio, per recuperare le informzioni su opzioni a livello di socket, il parametro level deve essere impostato a SOL_SOCKET. Altri livelli tipo TCP, possono essere utilizzati specificando il numero del livello. I numeri dei livelli dei protocolli possono essere ottenuti tramite getprotobyname().
Tabella 1. Opzioni per i socket disponibili
| Opzione | Descrizione |
|---|---|
| SO_DEBUG | Riporta informazioni per il debug. |
| SO_ACCEPTCONN | Indica se il socket è abilitato in ascolto. |
| SO_BROADCAST | Indica se sono supportate le trasmissioni dei messaggi di broadcast. |
| SO_REUSEADDR | Riporta se gli indirizzi locali possono essere riutilizzati. |
| SO_KEEPALIVE | Riporta se la connesisone deve essere mantenuta attiva tramite la trasmissione periodica di messaggi. Se il socket connesso non risponde a questi messaggi, la connessione viene interrotta ed i processi che stavano scrivendo in quel socket riceveranno il segnale SIGPIPE. |
| SO_LINGER | Indice se il socket debba ritardare il socket_close() se vi sono dati. |
| SO_OOBINLINE | Indica se il socket gestisce i dati fuori-banda. |
| SO_SNDBUF | Riporta le dimensioni del buffer di trasmissione. |
| SO_RCVBUF | Riporta le dimensioni del buffer di ricezione. |
| SO_ERROR | Restituisce informaizoni sugli stati di errore e li ripulisce. |
| SO_TYPE | Restituisce il tipo disocket. |
| SO_DONTROUTE | Indica se i messaggi in uscita ignorano i parametri standard di routing. |
| SO_RCVLOWAT | Indica il numero minimo di byte da processare da parte del socket per le operazioni di input (default 1). |
| SO_RCVTIMEO | Tempo di timeout per le operazioni di input. |
| SO_SNDLOWAT | Riporta il numero minimo di byte da processare da parte del socket per le operazioni di output. |
| SO_SNDTIMEO | Indica il tempo di timeout specificando il tempo che una funzione di output resti bloccata in attesa di potere inviare i dati. |
Nota: Nelle versioni di PHP antecedenti la 4.3.0, questa funzione era chiamata socket_getopt().