1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.10 $ -->
<chapter id="features.connection-handling">
<title>Gestion des connexions</title>
<note>
<para>
Les informations suivantes ne sont valables qu'à
partir de la version 3.0.7.
</para>
</note>
<para>
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>
<listitem><simpara>2 - TIMEOUT (périmé)</simpara></listitem>
</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.
</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>
<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é.
</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.
</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:
-->
|
