socket_listen
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_listen — Attende una richiesta di connessione su un socket
Descrizione
socket_listen(resource $socket
, int $backlog
= ?): bool
AvvisoQuesta 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.
Una volta creato il socket socket
tramite
la funzione socket_create(), ed eseguito il bind ad un nome
con socket_bind(), lo si può mettere in ascolto di
eventuali richieste di connessione su socket
.
Nota:
Il numero massimo, passato con il parametro backlog
dipende fortemente dalla piattaforma sottostante. Su Linux questo
viene troncato, senza avvisare, a SOMAXCONN
. Su Win32,
se viene passata la costante SOMAXCONN
, il servizio
sottostante responsabile dei socket valorizza backlog
al
massimo valore ragionevole. Non esiste un metodo standard per
determinare il reale valore massimo su questa piattaforma.
La funzione socket_listen() è disponibile solo per i
socket di tipo SOCK_STREAM
o
SOCK_SEQPACKET
.
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 a
socket_strerror() per ottenere una spiegazione
dell'errore.
Vedere anche
socket_accept(),
socket_bind(),
socket_connect(),
socket_create() e
socket_strerror().