cvs: phpdoc-it /features connection-handling.xml
| From: | Andrioli Darvin | Date: | Fri, 06 Jun 2003 20:12:45 +0000 |
| Subject: | cvs: phpdoc-it /features connection-handling.xml | ||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-393@lists.php.net to get a copy of this message | ||
darvina Fri Jun 6 16:12:45 2003 EDT
Modified files:
/phpdoc-it/features connection-handling.xml
Log:
Initial translation
Index: phpdoc-it/features/connection-handling.xml
diff -u /dev/null phpdoc-it/features/connection-handling.xml:1.3
--- /dev/null Fri Jun 6 16:12:45 2003
+++ phpdoc-it/features/connection-handling.xml Fri Jun 6 16:12:45 2003
@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.14 Maintainer: darvina Status: ready -->
+ <chapter id="features.connection-handling">
+ <title>Gestione della connessione</title>
+
+ <note>
+ <para>Le seguenti note si applicano a partire dalla versione 3.0.7.</para>
+ </note>
+
+ <para>
+ Internamente il PHP mantiene lo stato della connessione. Si hanno
+ 3 possibili stati:
+ <itemizedlist>
+ <listitem><simpara>0 - NORMAL</simpara></listitem>
+ <listitem><simpara>1 - ABORTED</simpara></listitem>
+ <listitem><simpara>2 - TIMEOUT</simpara></listitem>
+ </itemizedlist>
+ </para>
+
+ <simpara>
+ Quendo uno script PHP viene eseguito normalmente si trova nello stato NORMAL.
+ Se il client remoto si disconnette viene attivato il flag ABORTED.
+ La disconnessione di un client remoro è generalmente causata dalla pressione
+ del tasto STOP da parte dell'utente. Se invece si raggiunge il limite di tempo
+ imposto dal PHP (vedere <function>set_time_limit</function>) si attiva lo stato
+ TIMEOUT.</simpara>
+
+ <simpara>
+ Si può decidere se la disconnessione del client debba fare abortire lo script
+ o meno. In certi casi è più pratico lasciare finire lo script anche se
+ non c'è più il browser remoto a ricevere i dati.
+ Tuttavia il comportamento di default è di fare abortire lo script
+ quando il client remoto si disconnette. Questo comportamento può essere impostato
+ tramite la direttiva di &php.ini; ignore_user_abort oppure tramite
+ la corrispondente direttiva "php_value ignore_user_abort" del file .conf di Apache
+ oppure con la funzione <function>ignore_user_abort</function>.
+ Se non si segnala al PHP di ignorare la disconssessione dell'utente lo
+ script sarà interrotto. Unica eccezione si ha con la registrazione di una funzione
+ di chiusura utilizzando <function>register_shutdown_function</function>.
+ Con una funzione di shutdown, quando l'utente remoto preme il bottone di STOP,
+ alla prima occasione in cui lo script tenterà di produrre un output, il PHP intercetterà
+ che la connessione è interrotta e richiamerà la funzione di shutdown.
+ Questa funzione sarà richiamata anche al normale termine dello
+ script, pertanto per eseguire passi differenti in caso di disconnessione
+ del client occorre utilizzare la funzione <function>connection_aborted</function>.
+ Questa funzione restituisce &true; se la connessione è stata interrotta.</simpara>
+
+ <simpara>
+ Uno script può essere fermato dal timer incorporato nel PHP.
+ Per default il timeout è impostato a 30 secondi. Tale limite può essere variato
+ agendo sulla direttiva max_execution_time nel &php.ini; o nel corrispondente
+ parametro "php_value max_execution_time" nella configurazione di Apache, oppure con la
+ funzione <function>set_time_limit</function>. Quando termina il tempo impostato
+ lo script viene interrotto, se è stata prevista una funzione di shutdown, questa
+ verrà eseguita. All'interno di questa funzione si può discriminare se è
+ stata attivata per lo scadere del timeout utilizzando la
+ funzione <function>connection_timeout</function>. Questa restituisce
+ &true; se la funzione di shutdown è stata chiamata per lo scadere del tempo a
disposizione.</simpara>
+
+ <simpara>
+ Un aspetto che occorre notare sui stati ABORTED e TIMEOUT è
+ che possono essere attivi contemporaneamente. Questo può accadere
+ se si è impostato il PHP affinchè ignori le interruzioni da parte dell'utente. Infatti il
PHP
+ continua a tenere traccia della disconnessione dell'utente, ma, semplicemente, non viene
+ interrotto lo script. Quindi, quando termina il tempo, lo script sarà interrotto e verrà
+ richiamata la funzione di shutdown, se presente. In questa situazione
+ sia <function>connection_timeout</function> sia
+ <function>connection_aborted</function> restituiranno &true;.
+ Si può anche verificare entrambi gli stati tramite una chiamata singola
+ utilizzando la funzione <function>connection_status</function>. Questa restituisce
+ un campo di bit con l'indicazione degli stati attivi. Quindi, ad esempio, se entrambi gli
+ stati sono attivi, la funzione restituirà 3.</simpara>
+
+ </chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->