cvs: phpdoc-fr /reference/session ini.xml reference.xml /reference/session/functions session-cache-expire.xml session-readonly.xml
session-register.xml session-set-save-handler.xml session-write-close.xml
| From: | Damien Seguy | Date: | Fri, 16 May 2003 11:39:02 +0000 |
| Subject: | cvs: phpdoc-fr /reference/session ini.xml reference.xml /reference/session/functions session-cache-expire.xml session-readonly.xml session-register.xml session-set-save-handler.xml session-write-close.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-379@lists.php.net to get a copy of this message | ||
dams Fri May 16 07:39:02 2003 EDT
Removed files:
/phpdoc-fr/reference/session/functions session-readonly.xml
Modified files:
/phpdoc-fr/reference/session ini.xml reference.xml
/phpdoc-fr/reference/session/functions session-cache-expire.xml
session-register.xml
session-set-save-handler.xml
session-write-close.xml
Log:
removing session_readonly
Index: phpdoc-fr/reference/session/ini.xml diff -u phpdoc-fr/reference/session/ini.xml:1.3 phpdoc-fr/reference/session/ini.xml:1.4 --- phpdoc-fr/reference/session/ini.xml:1.3 Mon Apr 28 06:53:26 2003 +++ phpdoc-fr/reference/session/ini.xml Fri May 16 07:39:02 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <section id="session.configuration"> &reftitle.runtime; &extension.runtime; @@ -126,7 +126,8 @@ &ini.table.bottom; </para> <para> - &ini.explain; + Le système de sessions dispose d'un grand nombre de directives + dans le fichier &php.ini;. En voici une présentation. <variablelist> <varlistentry id="ini.session.save-handler"> <term> @@ -374,7 +375,7 @@ <varlistentry id="ini.session.cookie-secure"> <term> <parameter>session.cookie_secure</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <simpara> Index: phpdoc-fr/reference/session/reference.xml diff -u phpdoc-fr/reference/session/reference.xml:1.10 phpdoc-fr/reference/session/reference.xml:1.11 --- phpdoc-fr/reference/session/reference.xml:1.10 Mon Apr 28 06:53:26 2003 +++ phpdoc-fr/reference/session/reference.xml Fri May 16 07:39:02 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <reference id="ref.session"> <title>Sessions</title> <titleabbrev>Sessions</titleabbrev> @@ -57,7 +57,7 @@ Utiliser les sessions ne signifie pas que les données de session ne pourront être vue que par un seul utilisateur. Il est important de garder cela en tête, lorsque vous stockez et affichez des données - importantes. Lors que vous stockez des données dans une session, + importantes. Lorsque vous stockez des données dans une session, il faut se demander quels seront les problèmes posés si quelqu'un d'autre accède à cette information, ou comment votre application est affectée si la session est en fait celle d'un autre. Index: phpdoc-fr/reference/session/functions/session-cache-expire.xml diff -u phpdoc-fr/reference/session/functions/session-cache-expire.xml:1.4 phpdoc-fr/reference/session/functions/session-cache-expire.xml:1.5 --- phpdoc-fr/reference/session/functions/session-cache-expire.xml:1.4 Sat Jan 18 21:41:53 2003 +++ phpdoc-fr/reference/session/functions/session-cache-expire.xml Fri May 16 07:39:02 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.38 --> <refentry id="function.session-cache-expire"> <refnamediv> @@ -18,8 +18,49 @@ actuelle de cache expire sera remplacée par <parameter>new_cache_expire</parameter>. </para> <para> - Voir aussi la directive de configuration - <link linkend="ini.session.cache-expire">session.cache_expire</link>. + Le délai d'expiration du cache est remis à sa valeur par défaut de + 180, stockée dans <literal>session.cache_limiter</literal>, au démarrage + de la requête. Par conséquent, vous devez appeler + <function>session_cache_expire</function> à chaque requête (et avant + que <function>session_start</function> ne soit appelé). + </para> + <example> + <title>Exemple avec <function>session_cache_expire</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +/* Configure le limiteur de cache à 'private' */ + +session_cache_limiter('private'); +$cache_limiter = session_cache_limiter(); + +/* Configure le délai d'expiration à 30 minutes */ +session_cache_expire (30); +$cache_expire = session_cache_expire(); + +/* Démarre la session */ + +session_start(); + +echo "Le limiteur de cache est maintenant à $cache_limiter</ br>"; +echo "La session en cache va exprier après $cache_expire minutes"; +?> +]]> + </programlisting> + </example> + <note> + <simpara> + La directive <parameter>new_cache_expire</parameter> n'a de valeur que si + <literal>session.cache_limiter</literal> a une valeur + <emphasis>différente</emphasis> de <literal>nocache</literal>. + </simpara> + </note> + <para> + Voir aussi + <link linkend="ini.session.cache-expire">session.cache_expire</link>, + <link linkend="ini.session.cache-limiter">session.cache_limiter</link> et + <function>session_cache_limiter</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-register.xml diff -u phpdoc-fr/reference/session/functions/session-register.xml:1.5 phpdoc-fr/reference/session/functions/session-register.xml:1.6 --- phpdoc-fr/reference/session/functions/session-register.xml:1.5 Sat Jan 18 21:41:53 2003 +++ phpdoc-fr/reference/session/functions/session-register.xml Fri May 16 07:39:02 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-register"> <refnamediv> @@ -26,9 +26,25 @@ </para> <caution> <para> + Si vous voulez que votre script fonctionne indépendamment de + la configuration de la directive + <link linkend="ini.register-globals"><literal>register_globals</literal></link>, + vous devez utiliser la variable <varname>$_SESSION</varname>. + Tous les éléments de <varname>$_SESSION</varname> sont automatiquement + enregistrée. Si votre script utilise + <function>session_register</function>, il fonctionnera sur les environnements + où <link linkend="ini.register-globals"><literal>register_globals</literal></link> + est désactivé. + </para> + </caution> + <caution> + <para> Cette fonction enregistre une variable <emphasis>global</emphasis>. Si vous enregistrer une variable globale dans une fonction, vous - devez vous assurer de la rendre globale, avec <literal>global</literal>, + devez vous assurer de la rendre <link + linkend="language.variables.scope"><command>globale</command></link>, + avec <literal>global</literal>, + ou bien le tableau <varname>$GLOBALS[]</varname>, ou bien utiliser un des tableaux de session ci-dessous. </para> </caution> Index: phpdoc-fr/reference/session/functions/session-set-save-handler.xml diff -u phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.4 phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.5 --- phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.4 Sat Jan 18 21:41:53 2003 +++ phpdoc-fr/reference/session/functions/session-set-save-handler.xml Fri May 16 07:39:02 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.23 --> <refentry id="function.session-set-save-handler"> <refnamediv> @@ -26,7 +26,7 @@ <note> <para> Le gestionnaire d'écriture n'est pas exécuté tant que le - flot de sortie est ouvert. Par conséquent, l'affichage + flôt de sortie est ouvert. Par conséquent, l'affichage de messages de debogage durant le gestionnaire d'écriture ne sera donc jamais visible depuis le navigateur. Si vous avez besoin de débogage, nous vous suggérons d'écrire Index: phpdoc-fr/reference/session/functions/session-write-close.xml diff -u phpdoc-fr/reference/session/functions/session-write-close.xml:1.2 phpdoc-fr/reference/session/functions/session-write-close.xml:1.3 --- phpdoc-fr/reference/session/functions/session-write-close.xml:1.2 Sat Jan 18 21:41:53 2003 +++ phpdoc-fr/reference/session/functions/session-write-close.xml Fri May 16 07:39:02 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.38 --> <refentry id="function.session-write-close"> <refnamediv> @@ -28,10 +28,12 @@ la session aussitôt que possible, et ainsi, libérant les données pour les autres scripts. </para> +<!-- commented out until final decision on implementation <para> Voir aussi <function>session_readonly</function>. </para> +--> </refsect1> </refentry>
Index: phpdoc-fr/reference/session/ini.xml diff -u phpdoc-fr/reference/session/ini.xml:1.3 phpdoc-fr/reference/session/ini.xml:1.4 --- phpdoc-fr/reference/session/ini.xml:1.3 Mon Apr 28 06:53:26 2003 +++ phpdoc-fr/reference/session/ini.xml Fri May 16 07:39:02 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <section id="session.configuration"> &reftitle.runtime; &extension.runtime; @@ -126,7 +126,8 @@ &ini.table.bottom; </para> <para> - &ini.explain; + Le système de sessions dispose d'un grand nombre de directives + dans le fichier &php.ini;. En voici une présentation. <variablelist> <varlistentry id="ini.session.save-handler"> <term> @@ -374,7 +375,7 @@ <varlistentry id="ini.session.cookie-secure"> <term> <parameter>session.cookie_secure</parameter> - <type>boolean</type> + <type>bool</type> </term> <listitem> <simpara> Index: phpdoc-fr/reference/session/reference.xml diff -u phpdoc-fr/reference/session/reference.xml:1.10 phpdoc-fr/reference/session/reference.xml:1.11 --- phpdoc-fr/reference/session/reference.xml:1.10 Mon Apr 28 06:53:26 2003 +++ phpdoc-fr/reference/session/reference.xml Fri May 16 07:39:02 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <reference id="ref.session"> <title>Sessions</title> <titleabbrev>Sessions</titleabbrev> @@ -57,7 +57,7 @@ Utiliser les sessions ne signifie pas que les données de session ne pourront être vue que par un seul utilisateur. Il est important de garder cela en tête, lorsque vous stockez et affichez des données - importantes. Lors que vous stockez des données dans une session, + importantes. Lorsque vous stockez des données dans une session, il faut se demander quels seront les problèmes posés si quelqu'un d'autre accède à cette information, ou comment votre application est affectée si la session est en fait celle d'un autre. Index: phpdoc-fr/reference/session/functions/session-cache-expire.xml diff -u phpdoc-fr/reference/session/functions/session-cache-expire.xml:1.4 phpdoc-fr/reference/session/functions/session-cache-expire.xml:1.5 --- phpdoc-fr/reference/session/functions/session-cache-expire.xml:1.4 Sat Jan 18 21:41:53 2003 +++ phpdoc-fr/reference/session/functions/session-cache-expire.xml Fri May 16 07:39:02 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.38 --> <refentry id="function.session-cache-expire"> <refnamediv> @@ -18,8 +18,49 @@ actuelle de cache expire sera remplacée par <parameter>new_cache_expire</parameter>. </para> <para> - Voir aussi la directive de configuration - <link linkend="ini.session.cache-expire">session.cache_expire</link>. + Le délai d'expiration du cache est remis à sa valeur par défaut de + 180, stockée dans <literal>session.cache_limiter</literal>, au démarrage + de la requête. Par conséquent, vous devez appeler + <function>session_cache_expire</function> à chaque requête (et avant + que <function>session_start</function> ne soit appelé). + </para> + <example> + <title>Exemple avec <function>session_cache_expire</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +/* Configure le limiteur de cache à 'private' */ + +session_cache_limiter('private'); +$cache_limiter = session_cache_limiter(); + +/* Configure le délai d'expiration à 30 minutes */ +session_cache_expire (30); +$cache_expire = session_cache_expire(); + +/* Démarre la session */ + +session_start(); + +echo "Le limiteur de cache est maintenant à $cache_limiter</ br>"; +echo "La session en cache va exprier après $cache_expire minutes"; +?> +]]> + </programlisting> + </example> + <note> + <simpara> + La directive <parameter>new_cache_expire</parameter> n'a de valeur que si + <literal>session.cache_limiter</literal> a une valeur + <emphasis>différente</emphasis> de <literal>nocache</literal>. + </simpara> + </note> + <para> + Voir aussi + <link linkend="ini.session.cache-expire">session.cache_expire</link>, + <link linkend="ini.session.cache-limiter">session.cache_limiter</link> et + <function>session_cache_limiter</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-register.xml diff -u phpdoc-fr/reference/session/functions/session-register.xml:1.5 phpdoc-fr/reference/session/functions/session-register.xml:1.6 --- phpdoc-fr/reference/session/functions/session-register.xml:1.5 Sat Jan 18 21:41:53 2003 +++ phpdoc-fr/reference/session/functions/session-register.xml Fri May 16 07:39:02 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-register"> <refnamediv> @@ -26,9 +26,25 @@ </para> <caution> <para> + Si vous voulez que votre script fonctionne indépendamment de + la configuration de la directive + <link linkend="ini.register-globals"><literal>register_globals</literal></link>, + vous devez utiliser la variable <varname>$_SESSION</varname>. + Tous les éléments de <varname>$_SESSION</varname> sont automatiquement + enregistrée. Si votre script utilise + <function>session_register</function>, il fonctionnera sur les environnements + où <link linkend="ini.register-globals"><literal>register_globals</literal></link> + est désactivé. + </para> + </caution> + <caution> + <para> Cette fonction enregistre une variable <emphasis>global</emphasis>. Si vous enregistrer une variable globale dans une fonction, vous - devez vous assurer de la rendre globale, avec <literal>global</literal>, + devez vous assurer de la rendre <link + linkend="language.variables.scope"><command>globale</command></link>, + avec <literal>global</literal>, + ou bien le tableau <varname>$GLOBALS[]</varname>, ou bien utiliser un des tableaux de session ci-dessous. </para> </caution> Index: phpdoc-fr/reference/session/functions/session-set-save-handler.xml diff -u phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.4 phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.5 --- phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.4 Sat Jan 18 21:41:53 2003 +++ phpdoc-fr/reference/session/functions/session-set-save-handler.xml Fri May 16 07:39:02 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.23 --> <refentry id="function.session-set-save-handler"> <refnamediv> @@ -26,7 +26,7 @@ <note> <para> Le gestionnaire d'écriture n'est pas exécuté tant que le - flot de sortie est ouvert. Par conséquent, l'affichage + flôt de sortie est ouvert. Par conséquent, l'affichage de messages de debogage durant le gestionnaire d'écriture ne sera donc jamais visible depuis le navigateur. Si vous avez besoin de débogage, nous vous suggérons d'écrire Index: phpdoc-fr/reference/session/functions/session-write-close.xml diff -u phpdoc-fr/reference/session/functions/session-write-close.xml:1.2 phpdoc-fr/reference/session/functions/session-write-close.xml:1.3 --- phpdoc-fr/reference/session/functions/session-write-close.xml:1.2 Sat Jan 18 21:41:53 2003 +++ phpdoc-fr/reference/session/functions/session-write-close.xml Fri May 16 07:39:02 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.38 --> <refentry id="function.session-write-close"> <refnamediv> @@ -28,10 +28,12 @@ la session aussitôt que possible, et ainsi, libérant les données pour les autres scripts. </para> +<!-- commented out until final decision on implementation <para> Voir aussi <function>session_readonly</function>. </para> +--> </refsect1> </refentry>