cvs: phpdoc-it /features connection-handling.xml

From: 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 +-->

« previous php.doc.it (#393) next »