dams Fri Nov 2 03:46:52 2001 EDT
Modified files:
/phpdoc/fr/features connection-handling.xml
Log:
max_execution_time new name.
Index: phpdoc/fr/features/connection-handling.xml
diff -u phpdoc/fr/features/connection-handling.xml:1.6
phpdoc/fr/features/connection-handling.xml:1.7
--- phpdoc/fr/features/connection-handling.xml:1.6 Wed Oct 24 18:14:02 2001
+++ phpdoc/fr/features/connection-handling.xml Fri Nov 2 03:46:52 2001
@@ -1,4 +1,5 @@
-<!-- $Revision: 1.6 $ -->
+<?xml encoding="iso-8859-1"?>
+<!-- $Revision: 1.7 $ -->
<chapter id="features.connection-handling">
<title>Gestion des connexions</title>
<note>
@@ -8,8 +9,8 @@
</para>
</note>
<para>
- Le statut des connexions est conservé en interne par PHP. Il y a trois
- états possibles :
+ Le statut des connexions est conservé en interne par PHP. Il y a
+ trois états possibles :
<itemizedlist>
<listitem><simpara>0 - NORMAL (normal)</simpara></listitem>
<listitem><simpara>1 - ABORTED (annulé)</simpara></listitem>
@@ -17,74 +18,76 @@
</itemizedlist>
</para>
<simpara>
- Lorsqu'un script PHP est en cours d'exécution, son
- état est NORMAL. Si le client distant se déconnecte,
- le statut devient ABORTED. En général, une telle
- déconnexion provient d'un arrêt temporaire. Si la
- durée maximale d'exécution de PHP est dépassée,
- (voir <function>set_time_limit</function>), le script prend le
- statut TIMEOUT.
+ Lorsqu'un script PHP est en cours d'exécution, son
+ état est NORMAL. Si le client distant se déconnecte,
+ le statut devient ABORTED. En général, une telle
+ déconnexion provient d'un arrêt temporaire. Si la
+ durée maximale d'exécution de PHP est
+ dépassée,
+ (voir <function>set_time_limit</function>), le script prend le
+ statut TIMEOUT.
</simpara>
<simpara>
- Vous pouvez en outre décider si vous voulez que la
- déconnexion d'un client provoque l'arrêt de votre
- script. Il est parfois pratique de terminer le script, même
- si le client n'est plus là pour recevoir les informations.
- Cependant, par défaut, le script sera interrompu, et terminé
- dès que le client se déconnecte. Ce comportement peut
- être modifié avec la directive ignore_user_abort dans le
- fichier <filename>php.ini</filename> ou bien avec la directive Apache
- <parameter>ignore_user_abort</parameter> du fichier Apache
<filename>httpd.conf</filename>
- ou avec la fonction <function>ignore_user_abort</function>. Si vous
- ne demandez pas à PHP d'ignorer la déconnexion, et que
- l'utilisateur se déconnecte, le script sera terminé. La
- seule exception est si vous avez enregistré une fonction
- de fermeture, avec <function>register_shutdown_function</function>.
- Avec une telle fonction, lorsque l'utilisateur interrompt sa
- requête, à la prochaine exécution du script,
- PHP va s'apercevoir que le dernier script n'a pas été
- terminé, et il va déclencher la fonction de fermeture.
- Cette fonction sera aussi appelée à la fin du script,
- si celui-ci se termine normalement. Pour pouvoir avoir un comportement
- différent suivant l'état du script lors de sa finalisation,
- vous pouvez exécutez des commandes spécifiques à
- la déconnexion grâce à la commande
- <function>connection_aborted</function>. Cette fonction retournera
- &true; si la connexion a été annulée.
- </simpara>
+ Vous pouvez en outre décider si vous voulez que la
+ déconnexion d'un client provoque l'arrêt de votre
+ script. Il est parfois pratique de terminer le script, même
+ si le client n'est plus là pour recevoir les informations.
+ Cependant, par défaut, le script sera interrompu, et terminé
+ dès que le client se déconnecte. Ce comportement peut
+ être modifié avec la directive ignore_user_abort dans le
+ fichier <filename>php.ini</filename> ou bien avec la directive Apache
+ <parameter>ignore_user_abort</parameter> du fichier Apache
+ <filename>httpd.conf</filename>
+ ou avec la fonction <function>ignore_user_abort</function>. Si vous
+ ne demandez pas à PHP d'ignorer la déconnexion, et que
+ l'utilisateur se déconnecte, le script sera terminé. La
+ seule exception est si vous avez enregistré une fonction
+ de fermeture, avec <function>register_shutdown_function</function>.
+ Avec une telle fonction, lorsque l'utilisateur interrompt sa
+ requête, à la prochaine exécution du script,
+ PHP va s'apercevoir que le dernier script n'a pas été
+ terminé, et il va déclencher la fonction de fermeture.
+ Cette fonction sera aussi appelée à la fin du script,
+ si celui-ci se termine normalement. Pour pouvoir avoir un comportement
+ différent suivant l'état du script lors de sa finalisation,
+ vous pouvez exécutez des commandes spécifiques à
+ la déconnexion grâce à la commande
+ <function>connection_aborted</function>. Cette fonction retournera
+ &true; si la connexion a été annulée.
+ </simpara>
<simpara>
- Votre script peut aussi expirer après un laps de temps.
- Par défaut, le délai est de 30 secondes. Cette valeur
- peut être changée en utilisant la directive PHP
- <parameter>max_execution_time</parameter> dans le fichier
- <filename>php.ini</filename> ou avec la directive
- <parameter>php3_max_execution_time</parameter>, dans le fichier
- Apache <filename>.conf</filename> ou encore avec la fonction
- <function>set_time_limit</function>.
- Lorsque le délai expire, le script est terminé,
- et comme pour la déconnexion du client, une fonction de
- finalisation sera appelée. Dans cette fonction, vous
- pouvez savoir si c'est le délai d'expiration qui a
- causé la fin du script, en appelant la fonction
- <function>connection_timeout</function>. Cette fonction
- retournera vrai si le délai d'expiration a
- été dépassé.
+ Votre script peut aussi expirer après un laps de temps.
+ Par défaut, le délai est de 30 secondes. Cette valeur
+ peut être changée en utilisant la directive PHP
+ <parameter>max_execution_time</parameter> dans le fichier
+ <filename>php.ini</filename> ou avec la directive
+ <parameter>max_execution_time</parameter>, dans le fichier
+ Apache <filename>.conf</filename> ou encore avec la fonction
+ <function>set_time_limit</function>.
+ Lorsque le délai expire, le script est terminé,
+ et comme pour la déconnexion du client, une fonction de
+ finalisation sera appelée. Dans cette fonction, vous
+ pouvez savoir si c'est le délai d'expiration qui a
+ causé la fin du script, en appelant la fonction
+ <function>connection_timeout</function>. Cette fonction
+ retournera vrai si le délai d'expiration a
+ été dépassé.
</simpara>
<simpara>
- Une chose à noter est que les deux cas ABORTED et TIMEOUT
- peuvent être appelés en même temps. Ceci est
- possible si vous demandez à PHP d'ignorer les
- déconnexions des utilisateurs. PHP va quand
- même noter le fait que l'utilisateur s'est déconnecté,
- mais le script va continuer. Puis, lorsqu'il atteint la limite de
- temps, le script va expirer. A ce moment-là, les deux
- fonctions <function>connection_timeout</function> et
- <function>connection_aborted</function> vont retourner &true;.
- Vous pouvez aussi vérifier les deux états en un
- seul appel avec la fonction <function>connection_status</function>.
- Cette fonction va retourner un champs de bits, avec les états.
- Si les deux états sont actifs, l'état retourné
- prendra la valeur 3.
+ Une chose à noter est que les deux cas ABORTED et TIMEOUT
+ peuvent être appelés en même temps. Ceci est
+ possible si vous demandez à PHP d'ignorer les
+ déconnexions des utilisateurs. PHP va quand
+ même noter le fait que l'utilisateur s'est déconnecté,
+ mais le script va continuer. Puis, lorsqu'il atteint la limite de
+ temps, le script va expirer. A ce moment-là, les deux
+ fonctions <function>connection_timeout</function> et
+ <function>connection_aborted</function> vont retourner &true;.
+ Vous pouvez aussi vérifier les deux états en un
+ seul appel avec la fonction <function>connection_status</function>.
+ Cette fonction va retourner un champs de bits, avec les états.
+ Si les deux états sont actifs, l'état retourné
+ prendra la valeur 3.
</simpara>
</chapter>
<!-- Keep this comment at the end of the file
