XCVI. Funzioni relative ai Socket
Attenzione |
Questo modulo è
SPERIMENTALE. Ovvero, il comportamento di queste
funzioni, i nomi di queste funzioni, in definitiva tutto ciò
che è documentato qui può cambiare nei futuri rilasci
del PHP senza preavviso. Siete avvisati, l'uso di questo modulo
è a vostro rischio. |
Questa estensione implementa una interfaccia a basso livello
verso i socket, fornendo la possibilità di agire sia come
server sia come client.
Le funzioni relative ai socket qui descritte, sono parte di una estensione
di PHP che deve essere abilitata durante la fase di compila tramite
l'opzione --enable-sockets di
configure.
Per un esempio di una interfaccia generica lato client,
vedere fsockopen() e
pfsockopen().
Per l'utilizzo di queste funzioni, è importante ricordare che
molte di esse hanno il medesimo nome della loro controparte in C,
ma spesso hanno dichiarazioni differenti. Ricordarsi di leggere
la descrizione per evitare confusione.
L'estensione dei socket è stata scritta per fornire una pratica intefaccia
ai potenti socket BSD. Si noti che le funzioni girano correttamente
sia su sistemi Unix che sistemi Win32. Quasi tutte le funzioni dei socket
possono fallire in certe situazioni e quindi generare un messaggio di tipo
E_WARNING per descrivere l'errore. Qualche volta
ciò non accada secondo le aspettative dello sviluppatore. Ad esempio la funzione
socket_read() improvvisamente può generare un messaggio di
E_WARNING a causa di una interruzione inaspettata della
connessione. E' prassi comune sopprimere i messaggi di warning con l'operatore
@ ed intercettare il codice dell'errore utilizzando
la funzione socket_last_error(). Si può anche richiamare
la funzione socket_strerror() con questo codice di errore
per avere un testo descrittivo del problema. Per maggiori dettagli vedere la descrizione
delle funzioni.
Nota:
I messaggi E_WARNING generati dal modulo dei
socket sono in inglese, mentre i messaggi di errore recuperati dipenderanno
dalle impostazioni locali correnti (LC_MESSAGES):
Warning - socket_bind() unable to bind address [98]: Die Adresse wird bereits verwendet |
Per chi non ha familiarità con la programmazione dei socket, può
trovare utili informazioni nelle pagine del manuale di Unix, ed inoltre
sul web si può trovare diversi tutorial sulla programmazione
dei socket in C, molti dei quali possono essere utilizzati, con
lievi modifiche, nella programmazione dei socket in PHP. Il link UNIX Socket
FAQ può essere un buon punto di partenza.
Esempio 1. Esempio di programma con i socket: semplice server TCP/IP
Questo esempio mostra un semplice server. Occorre modificare
le variabili address e port
per adeguarle ai parametri della macchina su cui sarà eseguito. Ci si può
connettere al server con un comando simile a telnet 192.168.1.53
10000 (dove l'indirizzo e la porta devono essere uguali a quanto
indicato nel setup). Qualsiasi lettara sarà digitata, verrà visualizzata sul server
e sul client. Per disconnettersi digitare 'quit'.
#!/usr/local/bin/php -q
<?php
error_reporting (E_ALL);
/* Si indica allo script di non uscire mentre attende una connessione */
set_time_limit (0);
/* Abilita lo scarico dell'output così si è in grado di vedere cosa passa
* non appena arrivano i dati al server. */
ob_implicit_flush ();
$address = '192.168.1.53';
$port = 10000;
if (($sock = socket_create (AF_INET, SOCK_STREAM, 0)) < 0) {
echo "socket_create() fallito: motivo: " . socket_strerror ($sock) . "\n";
}
if (($ret = socket_bind ($sock, $address, $port)) < 0) {
echo "socket_bind() fallito: motivo: " . socket_strerror ($ret) . "\n";
}
if (($ret = socket_listen ($sock, 5)) < 0) {
echo "socket_listen() fallito: motivo: " . socket_strerror ($ret) . "\n";
}
do {
if (($msgsock = socket_accept($sock)) < 0) {
echo "socket_accept() fallito: motivo: " . socket_strerror ($msgsock) . "\n";
break;
}
/* Invio delle istruzioni */
$msg = "\nBenvenuti al server di test in PHP. \n" .
"Per uscire, digitare 'quit'. Per chiudere il server digitare 'shutdown'.\n";
socket_write($msgsock, $msg, strlen($msg));
do {
if (FALSE === ($buf = socket_read ($msgsock, 2048))) {
echo "socket_read() fallito: motivo: " . socket_strerror ($ret) . "\n";
break 2;
}
if (!$buf = trim ($buf)) {
continue;
}
if ($buf == 'quit') {
break;
}
if ($buf == 'shutdown') {
socket_close ($msgsock);
break 2;
}
$talkback = "PHP: Testo scritto '$buf'.\n";
socket_write ($msgsock, $talkback, strlen ($talkback));
echo "$buf\n";
} while (true);
socket_close ($msgsock);
} while (true);
socket_close ($sock);
?> |
|
Esempio 2. Esempio di programma con i socket: semplice client TCP/IP
In questo esempio sarà illustrato un semplice client HTTP. Questo,
molto semplicemente, si collega ad un server, invia una richiesta HEAD,
visualizza la risposta ed esce.
<?php
error_reporting (E_ALL);
echo "<h2>Connessione TCP/IP </h2>\n";
/* Ottiene la porta per il servizio WWW. */
$service_port = getservbyname ('www', 'tcp');
/* Ottiene l'indirizzo IP per il server cercato. */
$address = gethostbyname ('www.php.net');
/* Crea un socket TCP/IP. */
$socket = socket_create (AF_INET, SOCK_STREAM, 0);
if ($socket < 0) {
echo "socket_create() fallito: motivo: " . socket_strerror ($socket) . "\n";
} else {
echo "OK.\n";
}
echo "Tentativo di connessione a '$address' sulla porta '$service_port'...";
$result = socket_connect ($socket, $address, $service_port);
if ($result < 0) {
echo "socket_connect() fallito.\nMotivo: ($result) " . socket_strerror($result) . "\n";
} else {
echo "OK.\n";
}
$in = "HEAD / HTTP/1.0\r\n\r\n";
$out = '';
echo "Invio HTTP HEAD...";
socket_write ($socket, $in, strlen ($in));
echo "OK.\n";
echo "Lettura della risposta:\n\n";
while ($out = socket_read ($socket, 2048)) {
echo $out;
}
echo "Chiusura del socket...";
socket_close ($socket);
echo "OK.\n\n";
?> |
|
- Sommario
- socket_accept -- Accetta una connessione su un socket
- socket_bind -- Bind di un nome ad un socket
- socket_clear_error -- Azzera gli erorri di un socket, oppure l'ultimo codice d'errore
- socket_close -- Chiude una risorsa di tipo socket
- socket_connect -- Inizia una connessione su un socket
- socket_create_listen -- Apre un socket per accettare connessioni su una porta
- socket_create_pair -- Crea una coppia di socket non distinguibili e li memorizza in fd.
- socket_create -- Crea un socket (punto terminale di una comunicazione).
- socket_get_option -- Ottiene le opzioni per un socket
- socket_getpeername --
Interroga il lato remoto di un dato socket per ottenere o la combinazione host/porta
od un percorso Unix, in base al tipo di socket
- socket_getsockname --
Interroga il lato locale di un dato socket e restituisce o la combinazione host/porta
oppure un percorso Unix in base al tipo di socket
- socket_iovec_add -- Aggiunge un nuovo vettore all'array ricevuti o inviati
- socket_iovec_alloc -- ...]) Costruice una struttura 'struct iovec' da utilizzare con sendmsg, recvmsg, writev, e readv
- socket_iovec_delete -- Cancella un vettore da un array di vettori
- socket_iovec_fetch -- Restituisce i dati contenuti nella struttura iovec specificata da iovec_id[iovec_position]
- socket_iovec_free -- Libera la strutture iovec indicata da iovec_id
- socket_iovec_set -- Valorizza i dati contenuti in iovec_id[iovec_position] con new_val
- socket_last_error -- Restituisce l'ultimo errore su un socket.
- socket_listen -- Attende una richiesta di connessione su un socket
- socket_read -- Legge fino ad un massimo di byte predefiniti da un socket
- socket_readv -- Legge da un fd, utilizzando un array invia/ricevi definito da iovec_id
- socket_recv -- Riceve i dati da un socket collegato
- socket_recvfrom -- Riceve i dati da un socket, che sia connesso o meno
- socket_recvmsg -- Funzione usata per ricevere messaggi da un socket, a prescindere che sia orientato alla connessione o meno
- socket_select -- Esegue la system call select() su un set con timeout indicato da tv_sec ed tv_usec
- socket_send -- Invia i dati ad un socket collegato
- socket_sendmsg -- Invia un messaggio ad un socket, a prescindere che sia orientato alla connessione o meno
- socket_sendto -- Invia un messaggio ad un socket, a prescindere che sia connesso o meno
- socket_set_nonblock -- Attiva la modalità "nonblocking" per il descrittore di file fd
- socket_set_option -- Valorizza le opzioni per un socket
- socket_shutdown -- Chiude un socket in ricezione, in invio o in entrambi i sensi.
- socket_strerror -- Restituisce una stringa con la descrizione dell'errore.
- socket_write -- Scrive su un socket.
- socket_writev -- Scrive su un descrittore di file, fd, usando un array invia/ricevi definito da iovec_id