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

eduardcapell		Tue Aug 30 00:46:25 2005 EDT

  Added files:                 
    /phpdoc-ca/features	connection-handling.xml 
  Log:
  
  

http://cvs.php.net/co.php/phpdoc-ca/features/connection-handling.xml?r=1.1&p=1
Index: phpdoc-ca/features/connection-handling.xml
+++ phpdoc-ca/features/connection-handling.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.17 Maintainer: eduardcapell Status: ready -->
 <chapter id="features.connection-handling">
  <title>Gestió de les connexions</title>

  <note>
   <para>El següent s'aplica a la versió 3.0.7 i posteriors.</para>
  </note>

  <para>
   Internament, en PHP es mantè un estat de connexió. Hi ha 3 possibles estats:
   <itemizedlist>
    <listitem><simpara>0 - NORMAL</simpara></listitem>
    <listitem><simpara>1 - ABORTED</simpara></listitem>
    <listitem><simpara>2 - TIMEOUT</simpara></listitem>
   </itemizedlist>
  </para>

  <simpara>
   Quan una seqüència PHP s'executa normalment l'estat actiu és NORMAL. Si el
   client remot es desconnecta s'activa l'estat ABORTED. Una desconnexió del
   client sol donar-se quan l'usuari pressiona el seu  botó STOP. Si el límit de
   temps que imposa el PHP (vegeu <function>set_time_limit</function>)
   s'exhaureix, s'activa l'estat TIMEOUT.</simpara>

  <simpara>
   Podeu decidir si voleu que una desconnexió de client causi la cancel·lacó de
   la vostra seqüència. A vegades és útil de fer que les seqüències s'executin
   fins al final fins i tot en els casos en què no hi ha un navegador remot que
   en rebi la sortida. El comportament per defecte, però, és la cancel·lació de
   la seqüència quan el client remot es desconnecta. Aquest comportament es pot
   configurar des de la directiva ignore_user_abort al &php.ini;i també per 
   mitjà de la corresponent directiva de configuració d'Apache 
   "php_value ignore_user_abort" o bé amb la funció 
   <function>ignore_user_abort</function>. Si no li dieu al PHP que ignori una
   cancel·lació per part de l'usuari, i aquest efectivament cancel·la, la
   vostra seqüència s'acabarà. L'excepció és el cas en què heu registrat una
   funció d'apagada, amb <function>register_shutdown_function</function>. Amb
   aquesta funció, quan l'usuari remot fa click al botó STOP, el proper cop que
   la seqüència intenti enviar qualsevol cosa, el PHP detectarà que la connexió
   ha estat avortada i es cridarà la funció d'apagada. Aquesta funció d'apagada
   també es cridarà al final d'una seqüència que finalitza normalment. Per tant,
   en el cas de fer alguna cosa diferent en el cas d'una desconnexió del client,
   podeu fer servir la funció <function>connection_aborted</function>. Aquesta
   funció retornarà &true; si la connexió ha estat avortada.</simpara>

  <simpara>
   Una seqüència també pot ser finalitzada pel temporitzador de seqüències
   inclòs en PHP. El temps d'espera per defecte és de 30 segons. El podeu
   canviar amb la directiva <option>max_execution_time</option> del &php.ini; o
   bé la corresponent directiva de configuració de l'Apache, 
   <literal>php_value max_execution_time</literal>, i també amb la funció 
   <function>set_time_limit</function>. Quan el temps d'espera s'excedeix, la
   seqüència avortarà com si hi hagués hagut una desconnexió de client, i es
   cridarà la funció d'apagada si és que existeix. Dins de la funció d'apagada
   podeu comprovar si ha estat el temps excedit el que ha causat l'apagada,
   mitjançant la crida a la funció <function>connection_status</function>. 
   Aquesta funció retorna el valor 2 si ha estat un temps d'espera excedit el 
   qui ha causat la crida a la funció d'apagada.
  </simpara>

  <simpara>
   És important d'observar que els estats ABORTED i TIMEOUT poden estar actius
   al mateix temps. Això és possible si li dieu al PHP que ignore les
   cancel·lacions d'usuari. El PHP guardarà igualment la informació que
   reflectirà que l'usuari ha cancel·lat la connexió, però la seqüència
   continuarà executant-se. Si llavors s'excedeix el temps d'espera màxim, la
   seqüència s'avortarà i es cridarà la funció d'apagada (si existeix). En
   aquest punt, podreu comprovar que el valor que us retorna la funció 
   <function>connection_status</function> és 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
-->