cvs: phpdoc-fr /reference/session reference.xml /reference/session/functions session-cache-expire.xml session-cache-limiter.xml session-decode.xml
session-encode.xml session-get-cookie-params.xml session-id.xml session-name.xml session-register.xml session-save-path.xml
session-set-cookie-params.xml session-set-save-handler.xml session-unset.xml session-write-close.xml
| From: | Damien Seguy | Date: | Sun, 19 Jan 2003 02:41:53 +0000 |
| Subject: | cvs: phpdoc-fr /reference/session reference.xml /reference/session/functions session-cache-expire.xml session-cache-limiter.xml session-decode.xml session-encode.xml session-get-cookie-params.xml session-id.xml session-name.xml session-register.xml session-save-path.xml session-set-cookie-params.xml session-set-save-handler.xml session-unset.xml session-write-close.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-164@lists.php.net to get a copy of this message | ||
dams Sat Jan 18 21:41:53 2003 EDT
Modified files:
/phpdoc-fr/reference/session reference.xml
/phpdoc-fr/reference/session/functions session-cache-expire.xml
session-cache-limiter.xml
session-decode.xml
session-encode.xml
session-get-cookie-params.xml
session-id.xml
session-name.xml
session-register.xml
session-save-path.xml
session-set-cookie-params.xml
session-set-save-handler.xml
session-unset.xml
session-write-close.xml
Log:
Major update for sessions
Index: phpdoc-fr/reference/session/reference.xml diff -u phpdoc-fr/reference/session/reference.xml:1.5 phpdoc-fr/reference/session/reference.xml:1.6 --- phpdoc-fr/reference/session/reference.xml:1.5 Fri Aug 16 22:03:28 2002 +++ phpdoc-fr/reference/session/reference.xml Sat Jan 18 21:41:53 2003 @@ -1,10 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <reference id="ref.session"> - <title>Sessions</title> + <title>Sessions</title> <titleabbrev>Sessions</titleabbrev> - + <partintro> + + <section id="session.intro"> + &reftitle.intro; <para> Le support des sessions de PHP est un moyen de préserver des données entre plusieurs accès. Cela vous permet de @@ -38,101 +41,158 @@ comme telles. Lors des accès ultérieurs, elles ne seront pas définies, jusqu'à ce que l'utilisateur le fasse. </para> - <para> - Les options de configuration - <link linkend="ini.track-vars"><literal>track_vars</literal></link> et - <link linkend="ini.register-globals"><literal>register_globals</literal></link> - influencent la manière de stockage et déstockage des variables. - </para> - <note> + <note> + <para> + La gestion des sessions a été ajoutée en PHP 4.0. + </para> + </note> + </section> + + <section id="session.security"> + <title>Sessions et sécurité</title> <para> - Depuis PHP 4.0.3, <link linkend="ini.track-vars"><literal>track_vars</literal></link> - est toujours activé. + Lien externe : <ulink url="&url.session-fixation;">Session fixation</ulink> </para> - </note> - <note> <para> - Depuis PHP 4.1.0, <varname>$_SESSION</varname> est disponible - comme variable tout comme <varname>$_POST</varname>, - <varname>$_GET</varname>, <varname>$_REQUEST</varname>, etc.. - Contrairement à <varname>$HTTP_SESSION_VARS</varname>, - <varname>$_SESSION</varname> est toujours global. Par conséquent, - <literal>global</literal> should not be used for - <varname>$_SESSION</varname>. + Utiliser les sessions ne signifie pas que les données de sessions 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, + 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. </para> - </note> - <para> + <para> + Par exemple, si quelqu'un usurpe une sessoin, il peut alors poster + un message dans un forum sous une fausse identitée. Quelle est la + gravité de ce problème? Ou bien, il peut accèder aux commandes + d'un client, et même, modifier son panier d'achat. A priori, c'est + moins problématique pour un fleuriste que pour un pharmacien. + </para> + <para> + Par conséquent, lorsque vous manipulez des données importantes, + il faut exploiter d'autres méthodes pour décider si une session + est valide ou pas. Les sessions ne fournissent pas une méthode + fiable d'authentification. + </para> + <para> + Les sessions reposent sur un identifiant de session, ce qui signifie + que quelqu'un peut voler cet identifiant, rien qu'en volant l'ID. Ce vol + peut être rendu très difficile, comme par exemple en utilisant les + cookies, mais en aucun cas cela sera impossible. Les sessions dépendent + aussi sur la discipline de l'utilisateur qui referme son navigateur + à la fin de la session pour tour clore proprement. + De plus, même les cookies de session peuvent être surveillé sur un + réseau, ou bien noté par un proxy. + </para> + </section> + + <section id="session.requirements"> + &reftitle.required; + &no.requirement; + </section> + + &reference.session.configure; + + &reference.session.ini; + + <section id="session.resources"> + &reftitle.resources; + &no.resource; + </section> + + &reference.session.constants; + + <section id="session.examples"> + &reftitle.examples; + <note> + <para> + Depuis PHP 4.1.0, <varname>$_SESSION</varname> est disponible comme + variable globale, au même titre que <varname>$_POST</varname>, + <varname>$_GET</varname>, <varname>$_REQUEST</varname>, etc.. + Contrairement à <varname>$HTTP_SESSION_VARS</varname>, + <varname>$_SESSION</varname> est toujours globale. Par conséquent, vous + n'avez pas besoin d'utiliser le mot réservé + <link linkend="language.variables.scope"><command>global</command></link> + avec <varname>$_SESSION</varname>. Notez que cette documentation + a été modifiée pour utiliser <varname>$_SESSION</varname>. + Vous pouvez toujours le remplacer par <varname>$HTTP_SESSION_VARS</varname> + si vous préférez l'ancienne version. + </para> + <para> + Les clés du tableau <varname>$_SESSION</varname> sont sujettes + aux mêmes limitations que les variables PHP habituelles, c'est à dire + qu'elles ne peuvent pas commencer par un nombre, mais commencer par + une lettre ou un souligné '_'. Pour plus de détails, reportez vous à + la section sur les <link linkend="language.variables">variables</link>. + </para> + </note> + <para> Si <link linkend="ini.track-vars"><literal>track_vars</literal></link> est activé et <link linkend="ini.register-globals"><literal>register_globals</literal></link> est désactivé, seuls les éléments du tableau global - <varname>$HTTP_SESSION_VARS</varname> contiendront les variables + <varname>$_SESSION</varname> contiendront les variables enregistrées dans la session. Les variables de sessions relues seront - uniquement disponibles dans <varname>$HTTP_SESSION_VARS</varname>. - <example> - <title> - Enregistrer une variable avec - <link linkend="ini.track-vars"><literal>track_vars</literal></link> - activé - </title> - <programlisting role="php"> + uniquement disponibles dans <varname>$_SESSION</varname>. + </para> + <para> + L'utilisation de <varname>$_SESSION</varname> (ou + <varname>$HTTP_SESSION_VARS</varname> avec PHP 4.0.6 et plus ancien) est + recommandé pour une meilleure sécurité et un code plus facilement + maintenable. Avec <varname>$_SESSION</varname>, il n'y a pas besoin + d'utiliser les fonctions <function>session_register</function>, + <function>session_unregister</function> et + <function>session_is_registered</function>. Les variables de sessions + sont accessibles comme toute autre variable. + <example> + <title> + Enregistrer une variable avec $_SESSION. + </title> + <programlisting role="php"> <![CDATA[ <?php session_start(); -if (isset($HTTP_SESSION_VARS['compteur'])) { - $HTTP_SESSION_VARS['compteur']++; -} -else { - $HTTP_SESSION_VARS['compteur'] = 0; +// Utilisez $HTTP_SESSION_VARS avec PHP 4.0.6 ou plus ancien +if (!isset($_SESSION['count'])) { + $_SESSION['compteur'] = 0; +} else { + $_SESSION['compteur']++; } ?> ]]> - </programlisting> - </example> - </para> - <para> - L'utilisation de la variable <varname>$_SESSION</varname> (ou - <varname>$HTTP_SESSION_VARS</varname> avec PHP 4.0.6 ou plus ancien) - est recommandé pour des raisons de sécurité et de lisibilité du - code. Avec <varname>$_SESSION</varname> et - <varname>$HTTP_SESSION_VARS</varname>, il n'y a pas besoin - d'utiliser les fonctions - <function>session_register</function>, <function>session_unregister</function> - et <function>session_is_registered</function>. Les utilisateurs peuvent - utiliser une variable de session comme toute variable classique. - <example> - <title> - Enregistrer une variable avec $_SESSION. - </title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title> + Retirer une variable de session avec $_SESSION est register_globals inactif. + </title> + <programlisting role="php"> <![CDATA[ <?php session_start(); // Utilisez $HTTP_SESSION_VARS avec PHP 4.0.6 ou plus ancien -if (!isset($_SESSION['count'])) { - $_SESSION['count'] = 0; -} else { - $_SESSION['count']++; -} +unset($_SESSION['compteur']); ?> ]]> - </programlisting> - </example> - <example> - <title> - Annuler l'enregistrement d'une variable avec $_SESSION. - </title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title> + Retirer une variable de session avec $_SESSION est register_globals activé, + après l'avoir enregistré avec $_SESSION. + </title> + <programlisting role="php"> <![CDATA[ <?php session_start(); -// Utilisez $HTTP_SESSION_VARS avec PHP 4.0.6 ou plus ancien -unset($_SESSION['count']); +// Avec PHP 4.3 et plus récent, vous pouvez simplement utiliser l'exemple précédent +session_unregister('compteur'); ?> ]]> - </programlisting> - </example> - </para> - <para> + </programlisting> + </example> + </para> + <para> Si <link linkend="ini.register-globals"><literal>register_globals</literal></link> est activé, alors toutes les variables globales peuvent être enregistrées comme variables de session, et toutes les variables de sessions @@ -142,8 +202,8 @@ <function>session_register</function> tandis que <varname>$HTTP_SESSION_VARS</varname> et <varname>$_SESSION</varname> ne nécessitent pas <function>session_register</function>. - <caution> - <para> + <caution> + <para> Si vous utilisez <varname>$HTTP_SESSION_VARS</varname> et <varname>$_SESSION</varname> et désactivez <link linkend="ini.register-globals"><literal>register_globals</literal></link>, @@ -158,15 +218,15 @@ les données de sessions sont relues. Inactiver <link linkend="ini.register-globals"><literal>register_globals</literal></link> est recommandé pour des raisons de sécurité et de performances. - </para> - </caution> - <example> - <title> - Enregistrer une variable avec + </para> + </caution> + <example> + <title> + Enregistrer une variable avec <link linkend="ini.register-globals"><literal>register_globals</literal></link> activé - </title> - <programlisting role="php"> + </title> + <programlisting role="php"> <![CDATA[ <?php if (!session_is_registered('compteur')) { @@ -178,25 +238,32 @@ } ?> ]]> - </programlisting> - </example> - </para> - <para> - Si les deux options - <link linkend="ini.track-vars"><literal>track_vars</literal></link> et - <link linkend="ini.register-globals"><literal>register_globals</literal></link> - sont activés, alors les variables globales - <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> - représenteront les mêmes valeurs que celles qui sont enregistrées avec les - variables de même nom. - </para> - <para> - Si l'utilisateur utilise <function>session_register</function> pour - enregistrer des variables de sessions, - <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> - ne contiendront pas ces variables jusqu'à ce le tableau soit - de nouveau générés à partir des informations stockées en session. - </para> + </programlisting> + </example> + </para> + <para> + Si <link + linkend="ini.register-globals"><literal>register_globals</literal></link> + est activé, alors les variables globales et les entrées dans le tableau + <varname>$_SESSION</varname> seront des références sur la même valeur pour + les valeurs qui auront été enregistrées avant le démarrage de la session + (donc, dans les page précédentes). + </para> + <para> + De plus, si vous enregistrez une nouvelle variable avec la fonction + <function>session_register</function>, l'entrée dans l'environnement + globale et <varname>$_SESSION</varname> ne fera pas de référence vers la + même valeur jusqu'à la prochaine utilisation de + <function>session_start</function> (ceci s'applique à PHP 4.2 est + avant seulement). C'est à dire qu'une modification dans les variables + globales ne seront pas répercutés dans les entrées de <varname>$_SESSION</varname>. + Il est peu probable que cela ait un impact en pratique, et de plus, + cela a été corrigé en PHP 4.3. + </para> + </section> + + <section id="session.idpassing"> + <title>Passer l'identifiant de session (session ID)</title> <para> Il y a deux méthodes de propagation de l'identifiant de session : <itemizedlist> @@ -212,14 +279,20 @@ </listitem> </itemizedlist> </para> + <para> + The session module supports both methods. Cookies are optimal, but + since they are not reliable (clients are not bound to accept + them), we cannot rely on them. The second method embeds the + session id directly into URLs. + </para> <para> Le module de session supporte les deux méthodes. Les cookies sont - optimaux, mais comme ils ne sont pas sûrs (tous les internautes + optimaux, mais comme ils ne sont pas sûrs (tous les internautes ne les acceptent pas), ils ne sont pas fiables. La seconde méthode place l'identifiant de session directement dans les URL. </para> <para> - PHP est de faire cela de manière transparente, lorsqu'il est compilé + PHP est capable de faire cela de manière transparente, lorsqu'il est compilé avec l'option <link linkend="install.configure.enable-trans-sid"> <literal>--enable-trans-sid</literal></link>. Si vous activez cette option, les URL relatives seront modifiées pour contenir @@ -227,20 +300,20 @@ vous pouvez utiliser la constante <constant>SID</constant>, qui est définie, si le client n'a pas envoyé le cookie approprié. <constant>SID</constant> est soit de la forme - <literal>session_name=session_id</literal> ou une chaîne vide. + <literal>session_name=session_id</literal> ou une chaîne vide. <note> <para> - L'option <link linkend="ini.arg_separator.output">arg_separator.output</link> + L'option <link linkend="misc.configuration">arg_separator.output</link> de &php.ini; vous permet de personnaliser le séparateur d'arguments. </para> </note> </para> <para> - LMexemple suivant vous montre comment enregistrer une variable et comment + L'exemple suivant vous montre comment enregistrer une variable et comment réaliser un lien correct avec une autre page, avec <constant>SID</constant>. - <example> - <title>Compter le nombre de hits d'un utilisateur sur une page</title> - <programlisting role="php"> + <example> + <title>Counting the number of hits of a single user</title> + <programlisting role="php"> <![CDATA[ <?php if (!session_is_registered('compteur')) { @@ -254,212 +327,39 @@ Bonjour visiteur, vous avez vu cette page <?php echo $compteur; ?> fois.<p>; -<?php -// Le <?php echo SID?> (<?=SID?> est aussi possible suivant votre configuration) -// est nécessaire pour préserver l'identifiant de sessions -// si jamais l'utilisateur a désactivé les cookies. -?> - Pour continuer, <A HREF="nextpage.php?<?php echo SID?>">cliquez ici</A>. ]]> - </programlisting> - </example> - </para> - <para> - <literal><?=SID?></literal> n'est pas nécessair, si - <link linkend="install.configure.enable-trans-sid"> - <literal>--enable-trans-sid</literal></link> a été activé à la compilation de PHP. - </para> - <note> + </programlisting> + </example> + </para> <para> + <literal><?php echo SID?></literal> + (ou bien <literal><?=SID?></literal> peut être utilisé si les + <link linkend="ini.short-open-tag">short_open_tag</link> sont actifs) est + nécessaire pour préserver l'identifiant de session dans le cas où + l'utilisateur a désactivé les cookies. + <literal><? echo SID?></literal> n'est pas nécessaire, si + <link linkend="install.configure.enable-trans-sid"> + <literal>--enable-trans-sid</literal></link> a été + activé à la compilation de PHP. + </para> + <note> + <para> Les URLS non relatives sont considérées comme externes au site, et ne recevront pas le SID, car c'est une fuite d'information vers un autre site (envoi d'informations importantes). - </para> - </note> - <para> + </para> + </note> + </section> + + <section id="session.customhandler"> + <title>Gestion personnalisée des sessions</title> + <para> Pour implémenter un stockage en base de données, ou toute autre méthode, vous aurez besoin de la fonction <function>session_set_save_handler</function> pour paramétrer vos propres fonctions de stockage. - </para> - <para> - Le système de session supporte un grand nombre d'options, que vous pouvez - placer dans le fichier &php.ini; file. En voici une présentation. - <itemizedlist> - <listitem> - <simpara> - <literal>session.save_handler</literal> defines the name of the - handler which is used for storing and retrieving data - associated with a session. Defaults to - <literal>files</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.save_path</literal> définit le chemin qui - doit être passé au gestionnaire de sauvegarde. Si vous - décidez de choisir le gestionnaire par défaut (par fichier), - cet argument sera utilisé comme dossier de sauvegarde - des sessions. Par défaut, il vaut <filename>/tmp</filename>. Si - le niveau d'imbrication de <literal>session.save_path</literal> - est supérieur à 2, le nettoyage des sessions obsolètes ne s'opérera - pas. - </simpara> - <warning> - <para> - Si vous laissez cette option configurée avec un dossier - accessible en lecture à tout le monde, comme par exemple - <filename>/tmp</filename> (par défaut), les autres utilisateurs - pourront exploiter ces sessions en obtenant la liste de fichiers - dans ce dossier. - </para> - </warning> - </listitem> - <listitem> - <simpara> - <literal>session.name</literal> spécifie le nom de la session, - qui sera utilisé comme nom de cookie. Il ne doit contenir que - des caractères alphanumérique. Par défaut, c'est - <literal>PHPSESSID</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.auto_start</literal> spécifie si le module - de session doit démarrer automatiquement, au début de - chaque script PHP. Par défaut, c'est <literal>0</literal> (inactivé). - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cookie_lifetime</literal> spécifie la durée de - vie du cookie en secondes. La valeur de <literal>0</literal> - siginifie : "Jusqu'à ce que le navigateur soit éteind". - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.serialize_handler</literal> définit le nom - du gestionnaire qui est utilisé pour linéariser/délinéariser - les données. Actuellement, un format interne à PHP - (nommé <literal>php</literal>) et WDDX (nommé - <literal>wddx</literal>) sont supportés . WDDX est seulement - disponible, si PHP a été compilé avec l'option - <link linkend="ref.wddx">WDDX</link>. Par défaut, c'est <literal>php</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.gc_probability</literal> specifies the - probability that the gc (garbage collection) routine is started - on each request in percent. Defaults to <literal>1</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.gc_maxlifetime</literal> spécifie la durée de - vie des données sur le serveur, en nombre de secondes. Après - cette durée, les données seront considérées comme obsolètes, - et supprimées. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.referer_check</literal> contient une sous-chaîne - que vous souhaitez retrouver dans tous les entêtes HTTP Referer. Si - cet entêtes a été envoyé par le client, et que la sous-chaîne n'a pas - été trouvé, l'identifiant de session sera considéré comme invalide. - Par défaut, cette option est la chaîne vide. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.entropy_file</literal> est un chemin jusqu'à - une source externe (un fichier), qui sera utilisée comme source - additionnelle d'entropie pour la création de l'identifiant - de session. Des exemples valides sont <literal>/dev/random</literal> et - <literal>/dev/urandom</literal>, qui sont disponibles sur - tous les systèmes Unix. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.entropy_length</literal> spécifie le nombre d'octets - qui seront lus dans le fichier défini ci-dessus. Par défaut, il - vaut <literal>0</literal>, c'est à dire inactif. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.use_cookies</literal> spécifie si le module utilisera - les cookies pour stocker les données de session sur le client. - Par défaut, il vaut <literal>1</literal>, c'est à dire actif. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.use_only_cookies</literal> spécifie si le module - doit utiliser <emphasis role="strong">seulement</emphasis> les cookies - pour stocker les identifiants de sessions du coté du navigateur. Par défaut, - cette option vaut <literal>0</literal> (inactif, pour compatibilité ascendante). - En l'activant, vous éviterez les attaques qui utilisent des - identifiants de sessions dans les URL. Cette configuration a été ajoutée - en PHP 4.3.0. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cookie_path</literal> spécifie le chemin utilisé - lors de la création du cookie. Par défaut, il vaut <literal>/</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cookie_domain</literal> spécifie le domaine utilisé - lors de la création du cookie. Par défaut, il ne vaut rien. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cache_limiter</literal> spécifie le type de - contrôle de cache utilisé pour les pages avec sessions. Les - valeurs possibles sont : - none, nocache, private, private_no_expire, public. Par défaut, il vaut - <literal>nocache</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cache_expire</literal> spécifie la durée de - vie des données de sessions, en minute. Cette option n'a aucune - conséquence sur le contrôle de cache. Par défaut, il vaut - <literal>180</literal> (3 heures). - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.use_trans_sid</literal> indique si le - support transparent du SID est activé, grâce à l'option - de compilation <link linkend="install.configure.enable-trans-sid"> - <literal>--enable-trans-sid</literal></link>. - Par défaut, il vaut <literal>1</literal> (activé). - </simpara> - </listitem> - <listitem> - <simpara> - <literal>url_rewriter.tags</literal> spécifie quels sont les balises - HTML qui doivent être réécrites si le support transparent du SID - est activé. Par défaut, il vaut - <literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal> - </simpara> - </listitem> - </itemizedlist> - <note> - <para> - La gestion des sessions a été ajoutée en PHP 4.0. - </para> - </note> - </para> + </para> + </section> </partintro> &reference.session.functions; @@ -486,3 +386,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + Index: phpdoc-fr/reference/session/functions/session-cache-expire.xml diff -u phpdoc-fr/reference/session/functions/session-cache-expire.xml:1.3 phpdoc-fr/reference/session/functions/session-cache-expire.xml:1.4 --- phpdoc-fr/reference/session/functions/session-cache-expire.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-cache-expire.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.38 --> <refentry id="function.session-cache-expire"> <refnamediv> @@ -14,8 +14,12 @@ </methodsynopsis> <para> <function>session_cache_expire</function> retourne la configuration actuelle du cache expire - Si <parameter>new_cache_expire</parameter> est fourni, la configuration + Si <parameter>new_cache_expire</parameter> est fourni dans le fichier &php.ini;, la configuration 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>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-cache-limiter.xml diff -u phpdoc-fr/reference/session/functions/session-cache-limiter.xml:1.3 phpdoc-fr/reference/session/functions/session-cache-limiter.xml:1.4 --- phpdoc-fr/reference/session/functions/session-cache-limiter.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-cache-limiter.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.62 --> <refentry id="function.session-cache-limiter"> <refnamediv> @@ -19,7 +19,7 @@ <parameter>cache_limiter</parameter>. </para> <para> - Le limiteur de cache contrôle les entêtes HTTP envoyés au client. + Le limiteur de cache contrôle les entêtes HTTP envoyés au client. Certains entêtes détermine les règles de mise en cache de la page sur le nivagateur. En configurant ce limiteur à <literal>nocache</literal>, par exemple, le navigateur ne mettra pas la page dans son cache. La valeur @@ -30,7 +30,7 @@ <para> En mode <literal>private</literal>, l'entête Expire envoyé au client peut poser des problèmes à certains navigateurs, comme notamment - Moziall. Vous pouvez éviter ce problème avec le mode + Mozilla. Vous pouvez éviter ce problème avec le mode <literal>private_no_expire</literal>. L'entête Expire n'est jamais envoyé au navigateur pour ce mode. </para> @@ -41,8 +41,9 @@ </note> <para> Le limiteur de cache est remis à la valeur par défaut de - <literal>session.cache_limiter</literal> à chaque démarrage de script HPP. - Donc, vuos devrez appeler <function>session_cache_limiter</function> à + <link linkend="ini.session.cache-limiter">session.cache_limiter</link> à chaque + démarrage de script &php;. + Donc, vous devrez appeler <function>session_cache_limiter</function> à chaque page, et avant <function>session_start</function>. </para> <example> @@ -51,7 +52,7 @@ <![CDATA[ <?php -// configure le limiteur de cache à 'private' +/* configure le limiteur de cache à 'private' */ session_cache_limiter('private'); $cache_limiter = session_cache_limiter(); @@ -61,6 +62,10 @@ ]]> </programlisting> </example> + <para> + Voir aussi la directive de configuration + <link linkend="ini.session.cache-limiter">session.cache_limiter</link>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-decode.xml diff -u phpdoc-fr/reference/session/functions/session-decode.xml:1.3 phpdoc-fr/reference/session/functions/session-decode.xml:1.4 --- phpdoc-fr/reference/session/functions/session-decode.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-decode.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-decode"> <refnamediv> @@ -16,6 +16,10 @@ <function>session_decode</function> décode les données de sessions fournies dans le paramètre <parameter>data</parameter>, et défini les variables ainsi contenues dans la session. + </para> + <para> + Voir aussi + <function>session_encode</function> </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-encode.xml diff -u phpdoc-fr/reference/session/functions/session-encode.xml:1.3 phpdoc-fr/reference/session/functions/session-encode.xml:1.4 --- phpdoc-fr/reference/session/functions/session-encode.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-encode.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-encode"> <refnamediv> @@ -15,9 +15,13 @@ <void/> </methodsynopsis> <para> - <function>session_encode</function> retourne une chaîne + <function>session_encode</function> retourne une chaîne contenant les variables de la session courante encodé, prêt au stockage. + </para> + <para> + Voir aussi + <function>session_decode</function> </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-get-cookie-params.xml diff -u phpdoc-fr/reference/session/functions/session-get-cookie-params.xml:1.3 phpdoc-fr/reference/session/functions/session-get-cookie-params.xml:1.4 --- phpdoc-fr/reference/session/functions/session-get-cookie-params.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-get-cookie-params.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.8 --> <refentry id="function.session-get-cookie-params"> <refnamediv> @@ -41,6 +41,14 @@ </simpara> </listitem> </itemizedlist> + </para> + <para> + Voir aussi les directives de configuration + <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link>, + <link linkend="ini.session.cookie-path">session.cookie_path</link>, + <link linkend="ini.session.cookie-domain">session.cookie_domain</link>, + <link linkend="ini.session.cookie-secure">session.cookie_secure</link> et + <function>session_set_cookie_params</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-id.xml diff -u phpdoc-fr/reference/session/functions/session-id.xml:1.3 phpdoc-fr/reference/session/functions/session-id.xml:1.4 --- phpdoc-fr/reference/session/functions/session-id.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-id.xml Sat Jan 18 21:41:53 2003 @@ -1 +1 @@ -<?xml version="1.0" encoding="iso-8859-1"?><!-- $Revision: 1.3 $ --><!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-id"> <refnamediv> <refname>session_id</refname> <refpurpose>Let et/ou modifie l'identifiant courant de session</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>session_id</methodname> <methodparam choice="opt"><type>string</type><parameter>id</parameter></methodparam> </methodsynopsis> <para> <function>session_id</function> retourne l'identifiant courant de session. </para> <para> Si <parameter>id</parameter> est fourni, il remplacera l'identifiant courant de session. <function>session_id</function> doit alors être appelé avant <function>session_start</function>. Suivant le gestionnaire de session que vous utilisez, tous les caractères ne seront pas acceptés dans cette valeur. Par exemple, le gestionnaire de session par défaut, basé sur les fichiers, n'accepte que les lettres et chiffres! </para> <para> La consante <systemitem>SID</systemitem> peut alors être utilisée pour lire le nom de la session courante, et l'identifiant de session à fournir dans les URL. Notez que <systemitem>SID</systemitem> est uniquement défini si le client n'a pas envoyé le bon cookie. Voyez aussi <link linkend="ref.session">Gestion de session</link>. </para> <para> Voir aussi <function>session_start</function>. </para> </refsect1> </refentry><!-- Keep this comment at the end of the fileLocal variables:mode: sgmlsgml-omittag:tsgml-shorttag:tsgml-minimize-attributes:nilsgml-always-quote-attributes:tsgml-indent-step:1sgml-indent-data:tindent-tabs-mode:nilsgml-parent-document:nilsgml-default-dtd-file:"../../../../manual.ced"sgml-exposed-tags:nilsgml-local-catalogs:nilsgml-local-ecat-files:nilEnd:vim600: syn=xml fen fdm=syntax fdl=2 sivim: et tw=78 syn=sgmlvi: ts=1 sw=1--> \ No newline at end of file +<?xml version="1.0" encoding="iso-8859-1"?><!-- $Revision: 1.4 $ --><!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-id"> <refnamediv> <refname>session_id</refname> <refpurpose>Let et/ou modifie l'identifiant courant de session</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>session_id</methodname> <methodparam choice="opt"><type>string</type><parameter>id</parameter></methodparam> </methodsynopsis> <para> <function>session_id</function> retourne l'identifiant courant de session. </para> <para> Si <parameter>id</parameter> est fourni, il remplacera l'identifiant courant de session. <function>session_id</function> doit alors être appelé avant <function>session_start</function>. Suivant le gestionnaire de session que vous utilisez, tous les caractères ne seront pas acceptés dans cette valeur. Par exemple, le gestionnaire de session par défaut, basé sur les fichiers, n'accepte que les lettres et chiffres! </para> <para> La consante <systemitem>SID</systemitem> peut alors être utilisée pour lire le nom de la session courante, et l'identifiant de session à fournir dans les URL. Notez que <systemitem>SID</systemitem> est uniquement défini si le client n'a pas envoyé le bon cookie. Voyez aussi <link linkend="ref.session">Gestion de session</link>. </para> <para> Voir aussi <function>session_start</function>, <function>session_set_save_handler</function> et <link linkend="ini.session.save-handler">session.save_handler</link>. </para> </refsect1> </refentry><!-- Keep this comment at the end of the fileLocal variables:mode: sgmlsgml-omittag:tsgml-shorttag:tsgml-minimize-attributes:nilsgml-always-quote-attributes:tsgml-indent-step:1sgml-indent-data:tindent-tabs-mode:nilsgml-parent-document:nilsgml-default-dtd-file:"../../../../manual.ced"sgml-exposed-tags:nilsgml-local-catalogs:nilsgml-local-ecat-files:nilEnd:vim600: syn=xml fen fdm=syntax fdl=2 sivim: et tw=78 syn=sgmlvi: ts=1 sw=1--> \ No newline at end of file Index: phpdoc-fr/reference/session/functions/session-name.xml diff -u phpdoc-fr/reference/session/functions/session-name.xml:1.3 phpdoc-fr/reference/session/functions/session-name.xml:1.4 --- phpdoc-fr/reference/session/functions/session-name.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-name.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-name"> <refnamediv> @@ -33,15 +33,19 @@ <![CDATA[ <?php -// choisi le nom de SiteWebSession +/* choisi le nom de session : MaSession */ -$previous_name = session_name("SiteWebSession"); +$previous_name = session_name("MaSession"); echo "L'ancien nom de la session était $previous_name<p>"; ?> ]]> </programlisting> </example> + <para> + Voir aussi la directive de configuration + <link linkend="session.configuration">session.name</link>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-register.xml diff -u phpdoc-fr/reference/session/functions/session-register.xml:1.4 phpdoc-fr/reference/session/functions/session-register.xml:1.5 --- phpdoc-fr/reference/session/functions/session-register.xml:1.4 Wed Oct 9 21:17:11 2002 +++ phpdoc-fr/reference/session/functions/session-register.xml Sat Jan 18 21:41:53 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.2 --> <refentry id="function.session-register"> <refnamediv> @@ -19,7 +19,7 @@ <function>session_register</function> enregistre toutes les variables de nom <parameter>name</parameter> dans la session courante. Le nombre de variables enregistré est libre. Les noms peuvent être - passé comme des chaînes, ou comme des tableaux contenant des chaînes + passé comme des chaînes, ou comme des tableaux contenant des chaînes ou des tableaux. Poru chaque nom, <function>session_register</function> place la variable dans la session courante, pour la sauvegarde de fin de script. @@ -80,7 +80,7 @@ identifiées avec le type <literal>resource</literal> dans leur définitions. Une liste de fonction qui retournent de3s ressources sont disponible dans l'annexe - <link linkend="resources">types de ressources</link>. + <link linkend="resource">types de ressources</link>. </para> <para> Si <varname>$_SESSION</varname> (ou Index: phpdoc-fr/reference/session/functions/session-save-path.xml diff -u phpdoc-fr/reference/session/functions/session-save-path.xml:1.3 phpdoc-fr/reference/session/functions/session-save-path.xml:1.4 --- phpdoc-fr/reference/session/functions/session-save-path.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-save-path.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-save-path"> <refnamediv> @@ -16,7 +16,8 @@ <function>session_save_path</function> retourne le chemin du dossier actuellement utilisé pour sauver les données de sessions. Si <parameter>path</parameter> est spécifié, le chemin du dossier - sera modifié. + sera modifié. <function>session_save_path</function> doit être appelé + avant <function>session_start</function>. <note> <para> Sur certains systèmes d'exploitation, vous aurez à choisir un @@ -26,6 +27,10 @@ </para> </note> </para> + <para> + Voir aussi la directive de configuration + <link linkend="ini.session.save-path">session.save_path</link>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-set-cookie-params.xml diff -u phpdoc-fr/reference/session/functions/session-set-cookie-params.xml:1.3 phpdoc-fr/reference/session/functions/session-set-cookie-params.xml:1.4 --- phpdoc-fr/reference/session/functions/session-set-cookie-params.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-set-cookie-params.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-set-cookie-params"> <refnamediv> @@ -27,6 +27,14 @@ Le paramètre <parameter>secure</parameter> aé ét ajouté en PHP 4.0.4. </para> </note> + <para> + Voir aussi les directives de configuration + <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link>, + <link linkend="ini.session.cookie-path">session.cookie_path</link>, + <link linkend="ini.session.cookie-domain">session.cookie_domain</link>, + <link linkend="ini.session.cookie-secure">session.cookie_secure</link> et + <function>session_get_cookie_params</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-set-save-handler.xml diff -u phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.3 phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.4 --- phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-set-save-handler.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.23 --> <refentry id="function.session-set-save-handler"> <refnamediv> @@ -25,13 +25,6 @@ </para> <note> <para> - Vous devez configurer l'option <parameter>session.save_handler</parameter> - à <parameter>user</parameter> dans votre fichier &php.ini; pour que - <function>session_set_save_handler</function> soit actif. - </para> - </note> - <note> - <para> Le gestionnaire d'écriture n'est pas exécuté tant que le flot de sortie est ouvert. Par conséquent, l'affichage de messages de debogage durant le gestionnaire d'écriture @@ -56,9 +49,9 @@ sauvegardes en bases de données, avec votre serveur préféré. </para> <para> - La fonction de lecture doit toujours retourner une chaîne, + La fonction de lecture doit toujours retourner une chaîne, pour que le gestionnaire fonctionne comme prévu. Vous devez - retourner une chaîne vide s'il n'y a pas de données à lire. + retourner une chaîne vide s'il n'y a pas de données à lire. Les valeurs retournées par les autres gestionnaires sont converties en booléen avant d'être retournées au script. &true; pour la réussite, &false pour l'échec. @@ -132,6 +125,10 @@ ]]> </programlisting> </example> + </para> + <para> + Voir aussi la directive de configuration + <link linkend="ini.session.save-handler">session.save_handler</link>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-unset.xml diff -u phpdoc-fr/reference/session/functions/session-unset.xml:1.3 phpdoc-fr/reference/session/functions/session-unset.xml:1.4 --- phpdoc-fr/reference/session/functions/session-unset.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-unset.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.8 --> <refentry id="function.session-unset"> <refnamediv> @@ -22,7 +22,7 @@ <para> Si vous utilisez <varname>$_SESSION</varname> (ou <varname>$HTTP_SESSION_VARS</varname>), - utilisez plutôt ceci : $_SESSION = array(); + utilisez plutôt ceci : $_SESSION = array(); </para> </note> </refsect1> Index: phpdoc-fr/reference/session/functions/session-write-close.xml diff -u phpdoc-fr/reference/session/functions/session-write-close.xml:1.1 phpdoc-fr/reference/session/functions/session-write-close.xml:1.2 --- phpdoc-fr/reference/session/functions/session-write-close.xml:1.1 Fri Aug 16 22:03:29 2002 +++ phpdoc-fr/reference/session/functions/session-write-close.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.38 --> <refentry id="function.session-write-close"> <refnamediv> @@ -23,9 +23,9 @@ du script, les données de session sont verrouillées en écriture, et un seul script peut opérer sur la session en même temps. Lorsque vous utilisez des frames avec des sessions, vous vous en rendrez - compte en voyant les frames se rafraîchir les uns après les autres. + compte en voyant les frames se rafraîchir les uns après les autres. Vous pouvez réduire le temps de calcul de ces pages en refermant - la session aussitôt que possible, et ainsi, libérant les données + la session aussitôt que possible, et ainsi, libérant les données pour les autres scripts. </para> <para>
Index: phpdoc-fr/reference/session/reference.xml diff -u phpdoc-fr/reference/session/reference.xml:1.5 phpdoc-fr/reference/session/reference.xml:1.6 --- phpdoc-fr/reference/session/reference.xml:1.5 Fri Aug 16 22:03:28 2002 +++ phpdoc-fr/reference/session/reference.xml Sat Jan 18 21:41:53 2003 @@ -1,10 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <reference id="ref.session"> - <title>Sessions</title> + <title>Sessions</title> <titleabbrev>Sessions</titleabbrev> - + <partintro> + + <section id="session.intro"> + &reftitle.intro; <para> Le support des sessions de PHP est un moyen de préserver des données entre plusieurs accès. Cela vous permet de @@ -38,101 +41,158 @@ comme telles. Lors des accès ultérieurs, elles ne seront pas définies, jusqu'à ce que l'utilisateur le fasse. </para> - <para> - Les options de configuration - <link linkend="ini.track-vars"><literal>track_vars</literal></link> et - <link linkend="ini.register-globals"><literal>register_globals</literal></link> - influencent la manière de stockage et déstockage des variables. - </para> - <note> + <note> + <para> + La gestion des sessions a été ajoutée en PHP 4.0. + </para> + </note> + </section> + + <section id="session.security"> + <title>Sessions et sécurité</title> <para> - Depuis PHP 4.0.3, <link linkend="ini.track-vars"><literal>track_vars</literal></link> - est toujours activé. + Lien externe : <ulink url="&url.session-fixation;">Session fixation</ulink> </para> - </note> - <note> <para> - Depuis PHP 4.1.0, <varname>$_SESSION</varname> est disponible - comme variable tout comme <varname>$_POST</varname>, - <varname>$_GET</varname>, <varname>$_REQUEST</varname>, etc.. - Contrairement à <varname>$HTTP_SESSION_VARS</varname>, - <varname>$_SESSION</varname> est toujours global. Par conséquent, - <literal>global</literal> should not be used for - <varname>$_SESSION</varname>. + Utiliser les sessions ne signifie pas que les données de sessions 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, + 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. </para> - </note> - <para> + <para> + Par exemple, si quelqu'un usurpe une sessoin, il peut alors poster + un message dans un forum sous une fausse identitée. Quelle est la + gravité de ce problème? Ou bien, il peut accèder aux commandes + d'un client, et même, modifier son panier d'achat. A priori, c'est + moins problématique pour un fleuriste que pour un pharmacien. + </para> + <para> + Par conséquent, lorsque vous manipulez des données importantes, + il faut exploiter d'autres méthodes pour décider si une session + est valide ou pas. Les sessions ne fournissent pas une méthode + fiable d'authentification. + </para> + <para> + Les sessions reposent sur un identifiant de session, ce qui signifie + que quelqu'un peut voler cet identifiant, rien qu'en volant l'ID. Ce vol + peut être rendu très difficile, comme par exemple en utilisant les + cookies, mais en aucun cas cela sera impossible. Les sessions dépendent + aussi sur la discipline de l'utilisateur qui referme son navigateur + à la fin de la session pour tour clore proprement. + De plus, même les cookies de session peuvent être surveillé sur un + réseau, ou bien noté par un proxy. + </para> + </section> + + <section id="session.requirements"> + &reftitle.required; + &no.requirement; + </section> + + &reference.session.configure; + + &reference.session.ini; + + <section id="session.resources"> + &reftitle.resources; + &no.resource; + </section> + + &reference.session.constants; + + <section id="session.examples"> + &reftitle.examples; + <note> + <para> + Depuis PHP 4.1.0, <varname>$_SESSION</varname> est disponible comme + variable globale, au même titre que <varname>$_POST</varname>, + <varname>$_GET</varname>, <varname>$_REQUEST</varname>, etc.. + Contrairement à <varname>$HTTP_SESSION_VARS</varname>, + <varname>$_SESSION</varname> est toujours globale. Par conséquent, vous + n'avez pas besoin d'utiliser le mot réservé + <link linkend="language.variables.scope"><command>global</command></link> + avec <varname>$_SESSION</varname>. Notez que cette documentation + a été modifiée pour utiliser <varname>$_SESSION</varname>. + Vous pouvez toujours le remplacer par <varname>$HTTP_SESSION_VARS</varname> + si vous préférez l'ancienne version. + </para> + <para> + Les clés du tableau <varname>$_SESSION</varname> sont sujettes + aux mêmes limitations que les variables PHP habituelles, c'est à dire + qu'elles ne peuvent pas commencer par un nombre, mais commencer par + une lettre ou un souligné '_'. Pour plus de détails, reportez vous à + la section sur les <link linkend="language.variables">variables</link>. + </para> + </note> + <para> Si <link linkend="ini.track-vars"><literal>track_vars</literal></link> est activé et <link linkend="ini.register-globals"><literal>register_globals</literal></link> est désactivé, seuls les éléments du tableau global - <varname>$HTTP_SESSION_VARS</varname> contiendront les variables + <varname>$_SESSION</varname> contiendront les variables enregistrées dans la session. Les variables de sessions relues seront - uniquement disponibles dans <varname>$HTTP_SESSION_VARS</varname>. - <example> - <title> - Enregistrer une variable avec - <link linkend="ini.track-vars"><literal>track_vars</literal></link> - activé - </title> - <programlisting role="php"> + uniquement disponibles dans <varname>$_SESSION</varname>. + </para> + <para> + L'utilisation de <varname>$_SESSION</varname> (ou + <varname>$HTTP_SESSION_VARS</varname> avec PHP 4.0.6 et plus ancien) est + recommandé pour une meilleure sécurité et un code plus facilement + maintenable. Avec <varname>$_SESSION</varname>, il n'y a pas besoin + d'utiliser les fonctions <function>session_register</function>, + <function>session_unregister</function> et + <function>session_is_registered</function>. Les variables de sessions + sont accessibles comme toute autre variable. + <example> + <title> + Enregistrer une variable avec $_SESSION. + </title> + <programlisting role="php"> <![CDATA[ <?php session_start(); -if (isset($HTTP_SESSION_VARS['compteur'])) { - $HTTP_SESSION_VARS['compteur']++; -} -else { - $HTTP_SESSION_VARS['compteur'] = 0; +// Utilisez $HTTP_SESSION_VARS avec PHP 4.0.6 ou plus ancien +if (!isset($_SESSION['count'])) { + $_SESSION['compteur'] = 0; +} else { + $_SESSION['compteur']++; } ?> ]]> - </programlisting> - </example> - </para> - <para> - L'utilisation de la variable <varname>$_SESSION</varname> (ou - <varname>$HTTP_SESSION_VARS</varname> avec PHP 4.0.6 ou plus ancien) - est recommandé pour des raisons de sécurité et de lisibilité du - code. Avec <varname>$_SESSION</varname> et - <varname>$HTTP_SESSION_VARS</varname>, il n'y a pas besoin - d'utiliser les fonctions - <function>session_register</function>, <function>session_unregister</function> - et <function>session_is_registered</function>. Les utilisateurs peuvent - utiliser une variable de session comme toute variable classique. - <example> - <title> - Enregistrer une variable avec $_SESSION. - </title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title> + Retirer une variable de session avec $_SESSION est register_globals inactif. + </title> + <programlisting role="php"> <![CDATA[ <?php session_start(); // Utilisez $HTTP_SESSION_VARS avec PHP 4.0.6 ou plus ancien -if (!isset($_SESSION['count'])) { - $_SESSION['count'] = 0; -} else { - $_SESSION['count']++; -} +unset($_SESSION['compteur']); ?> ]]> - </programlisting> - </example> - <example> - <title> - Annuler l'enregistrement d'une variable avec $_SESSION. - </title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title> + Retirer une variable de session avec $_SESSION est register_globals activé, + après l'avoir enregistré avec $_SESSION. + </title> + <programlisting role="php"> <![CDATA[ <?php session_start(); -// Utilisez $HTTP_SESSION_VARS avec PHP 4.0.6 ou plus ancien -unset($_SESSION['count']); +// Avec PHP 4.3 et plus récent, vous pouvez simplement utiliser l'exemple précédent +session_unregister('compteur'); ?> ]]> - </programlisting> - </example> - </para> - <para> + </programlisting> + </example> + </para> + <para> Si <link linkend="ini.register-globals"><literal>register_globals</literal></link> est activé, alors toutes les variables globales peuvent être enregistrées comme variables de session, et toutes les variables de sessions @@ -142,8 +202,8 @@ <function>session_register</function> tandis que <varname>$HTTP_SESSION_VARS</varname> et <varname>$_SESSION</varname> ne nécessitent pas <function>session_register</function>. - <caution> - <para> + <caution> + <para> Si vous utilisez <varname>$HTTP_SESSION_VARS</varname> et <varname>$_SESSION</varname> et désactivez <link linkend="ini.register-globals"><literal>register_globals</literal></link>, @@ -158,15 +218,15 @@ les données de sessions sont relues. Inactiver <link linkend="ini.register-globals"><literal>register_globals</literal></link> est recommandé pour des raisons de sécurité et de performances. - </para> - </caution> - <example> - <title> - Enregistrer une variable avec + </para> + </caution> + <example> + <title> + Enregistrer une variable avec <link linkend="ini.register-globals"><literal>register_globals</literal></link> activé - </title> - <programlisting role="php"> + </title> + <programlisting role="php"> <![CDATA[ <?php if (!session_is_registered('compteur')) { @@ -178,25 +238,32 @@ } ?> ]]> - </programlisting> - </example> - </para> - <para> - Si les deux options - <link linkend="ini.track-vars"><literal>track_vars</literal></link> et - <link linkend="ini.register-globals"><literal>register_globals</literal></link> - sont activés, alors les variables globales - <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> - représenteront les mêmes valeurs que celles qui sont enregistrées avec les - variables de même nom. - </para> - <para> - Si l'utilisateur utilise <function>session_register</function> pour - enregistrer des variables de sessions, - <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> - ne contiendront pas ces variables jusqu'à ce le tableau soit - de nouveau générés à partir des informations stockées en session. - </para> + </programlisting> + </example> + </para> + <para> + Si <link + linkend="ini.register-globals"><literal>register_globals</literal></link> + est activé, alors les variables globales et les entrées dans le tableau + <varname>$_SESSION</varname> seront des références sur la même valeur pour + les valeurs qui auront été enregistrées avant le démarrage de la session + (donc, dans les page précédentes). + </para> + <para> + De plus, si vous enregistrez une nouvelle variable avec la fonction + <function>session_register</function>, l'entrée dans l'environnement + globale et <varname>$_SESSION</varname> ne fera pas de référence vers la + même valeur jusqu'à la prochaine utilisation de + <function>session_start</function> (ceci s'applique à PHP 4.2 est + avant seulement). C'est à dire qu'une modification dans les variables + globales ne seront pas répercutés dans les entrées de <varname>$_SESSION</varname>. + Il est peu probable que cela ait un impact en pratique, et de plus, + cela a été corrigé en PHP 4.3. + </para> + </section> + + <section id="session.idpassing"> + <title>Passer l'identifiant de session (session ID)</title> <para> Il y a deux méthodes de propagation de l'identifiant de session : <itemizedlist> @@ -212,14 +279,20 @@ </listitem> </itemizedlist> </para> + <para> + The session module supports both methods. Cookies are optimal, but + since they are not reliable (clients are not bound to accept + them), we cannot rely on them. The second method embeds the + session id directly into URLs. + </para> <para> Le module de session supporte les deux méthodes. Les cookies sont - optimaux, mais comme ils ne sont pas sûrs (tous les internautes + optimaux, mais comme ils ne sont pas sûrs (tous les internautes ne les acceptent pas), ils ne sont pas fiables. La seconde méthode place l'identifiant de session directement dans les URL. </para> <para> - PHP est de faire cela de manière transparente, lorsqu'il est compilé + PHP est capable de faire cela de manière transparente, lorsqu'il est compilé avec l'option <link linkend="install.configure.enable-trans-sid"> <literal>--enable-trans-sid</literal></link>. Si vous activez cette option, les URL relatives seront modifiées pour contenir @@ -227,20 +300,20 @@ vous pouvez utiliser la constante <constant>SID</constant>, qui est définie, si le client n'a pas envoyé le cookie approprié. <constant>SID</constant> est soit de la forme - <literal>session_name=session_id</literal> ou une chaîne vide. + <literal>session_name=session_id</literal> ou une chaîne vide. <note> <para> - L'option <link linkend="ini.arg_separator.output">arg_separator.output</link> + L'option <link linkend="misc.configuration">arg_separator.output</link> de &php.ini; vous permet de personnaliser le séparateur d'arguments. </para> </note> </para> <para> - LMexemple suivant vous montre comment enregistrer une variable et comment + L'exemple suivant vous montre comment enregistrer une variable et comment réaliser un lien correct avec une autre page, avec <constant>SID</constant>. - <example> - <title>Compter le nombre de hits d'un utilisateur sur une page</title> - <programlisting role="php"> + <example> + <title>Counting the number of hits of a single user</title> + <programlisting role="php"> <![CDATA[ <?php if (!session_is_registered('compteur')) { @@ -254,212 +327,39 @@ Bonjour visiteur, vous avez vu cette page <?php echo $compteur; ?> fois.<p>; -<?php -// Le <?php echo SID?> (<?=SID?> est aussi possible suivant votre configuration) -// est nécessaire pour préserver l'identifiant de sessions -// si jamais l'utilisateur a désactivé les cookies. -?> - Pour continuer, <A HREF="nextpage.php?<?php echo SID?>">cliquez ici</A>. ]]> - </programlisting> - </example> - </para> - <para> - <literal><?=SID?></literal> n'est pas nécessair, si - <link linkend="install.configure.enable-trans-sid"> - <literal>--enable-trans-sid</literal></link> a été activé à la compilation de PHP. - </para> - <note> + </programlisting> + </example> + </para> <para> + <literal><?php echo SID?></literal> + (ou bien <literal><?=SID?></literal> peut être utilisé si les + <link linkend="ini.short-open-tag">short_open_tag</link> sont actifs) est + nécessaire pour préserver l'identifiant de session dans le cas où + l'utilisateur a désactivé les cookies. + <literal><? echo SID?></literal> n'est pas nécessaire, si + <link linkend="install.configure.enable-trans-sid"> + <literal>--enable-trans-sid</literal></link> a été + activé à la compilation de PHP. + </para> + <note> + <para> Les URLS non relatives sont considérées comme externes au site, et ne recevront pas le SID, car c'est une fuite d'information vers un autre site (envoi d'informations importantes). - </para> - </note> - <para> + </para> + </note> + </section> + + <section id="session.customhandler"> + <title>Gestion personnalisée des sessions</title> + <para> Pour implémenter un stockage en base de données, ou toute autre méthode, vous aurez besoin de la fonction <function>session_set_save_handler</function> pour paramétrer vos propres fonctions de stockage. - </para> - <para> - Le système de session supporte un grand nombre d'options, que vous pouvez - placer dans le fichier &php.ini; file. En voici une présentation. - <itemizedlist> - <listitem> - <simpara> - <literal>session.save_handler</literal> defines the name of the - handler which is used for storing and retrieving data - associated with a session. Defaults to - <literal>files</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.save_path</literal> définit le chemin qui - doit être passé au gestionnaire de sauvegarde. Si vous - décidez de choisir le gestionnaire par défaut (par fichier), - cet argument sera utilisé comme dossier de sauvegarde - des sessions. Par défaut, il vaut <filename>/tmp</filename>. Si - le niveau d'imbrication de <literal>session.save_path</literal> - est supérieur à 2, le nettoyage des sessions obsolètes ne s'opérera - pas. - </simpara> - <warning> - <para> - Si vous laissez cette option configurée avec un dossier - accessible en lecture à tout le monde, comme par exemple - <filename>/tmp</filename> (par défaut), les autres utilisateurs - pourront exploiter ces sessions en obtenant la liste de fichiers - dans ce dossier. - </para> - </warning> - </listitem> - <listitem> - <simpara> - <literal>session.name</literal> spécifie le nom de la session, - qui sera utilisé comme nom de cookie. Il ne doit contenir que - des caractères alphanumérique. Par défaut, c'est - <literal>PHPSESSID</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.auto_start</literal> spécifie si le module - de session doit démarrer automatiquement, au début de - chaque script PHP. Par défaut, c'est <literal>0</literal> (inactivé). - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cookie_lifetime</literal> spécifie la durée de - vie du cookie en secondes. La valeur de <literal>0</literal> - siginifie : "Jusqu'à ce que le navigateur soit éteind". - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.serialize_handler</literal> définit le nom - du gestionnaire qui est utilisé pour linéariser/délinéariser - les données. Actuellement, un format interne à PHP - (nommé <literal>php</literal>) et WDDX (nommé - <literal>wddx</literal>) sont supportés . WDDX est seulement - disponible, si PHP a été compilé avec l'option - <link linkend="ref.wddx">WDDX</link>. Par défaut, c'est <literal>php</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.gc_probability</literal> specifies the - probability that the gc (garbage collection) routine is started - on each request in percent. Defaults to <literal>1</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.gc_maxlifetime</literal> spécifie la durée de - vie des données sur le serveur, en nombre de secondes. Après - cette durée, les données seront considérées comme obsolètes, - et supprimées. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.referer_check</literal> contient une sous-chaîne - que vous souhaitez retrouver dans tous les entêtes HTTP Referer. Si - cet entêtes a été envoyé par le client, et que la sous-chaîne n'a pas - été trouvé, l'identifiant de session sera considéré comme invalide. - Par défaut, cette option est la chaîne vide. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.entropy_file</literal> est un chemin jusqu'à - une source externe (un fichier), qui sera utilisée comme source - additionnelle d'entropie pour la création de l'identifiant - de session. Des exemples valides sont <literal>/dev/random</literal> et - <literal>/dev/urandom</literal>, qui sont disponibles sur - tous les systèmes Unix. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.entropy_length</literal> spécifie le nombre d'octets - qui seront lus dans le fichier défini ci-dessus. Par défaut, il - vaut <literal>0</literal>, c'est à dire inactif. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.use_cookies</literal> spécifie si le module utilisera - les cookies pour stocker les données de session sur le client. - Par défaut, il vaut <literal>1</literal>, c'est à dire actif. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.use_only_cookies</literal> spécifie si le module - doit utiliser <emphasis role="strong">seulement</emphasis> les cookies - pour stocker les identifiants de sessions du coté du navigateur. Par défaut, - cette option vaut <literal>0</literal> (inactif, pour compatibilité ascendante). - En l'activant, vous éviterez les attaques qui utilisent des - identifiants de sessions dans les URL. Cette configuration a été ajoutée - en PHP 4.3.0. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cookie_path</literal> spécifie le chemin utilisé - lors de la création du cookie. Par défaut, il vaut <literal>/</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cookie_domain</literal> spécifie le domaine utilisé - lors de la création du cookie. Par défaut, il ne vaut rien. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cache_limiter</literal> spécifie le type de - contrôle de cache utilisé pour les pages avec sessions. Les - valeurs possibles sont : - none, nocache, private, private_no_expire, public. Par défaut, il vaut - <literal>nocache</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cache_expire</literal> spécifie la durée de - vie des données de sessions, en minute. Cette option n'a aucune - conséquence sur le contrôle de cache. Par défaut, il vaut - <literal>180</literal> (3 heures). - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.use_trans_sid</literal> indique si le - support transparent du SID est activé, grâce à l'option - de compilation <link linkend="install.configure.enable-trans-sid"> - <literal>--enable-trans-sid</literal></link>. - Par défaut, il vaut <literal>1</literal> (activé). - </simpara> - </listitem> - <listitem> - <simpara> - <literal>url_rewriter.tags</literal> spécifie quels sont les balises - HTML qui doivent être réécrites si le support transparent du SID - est activé. Par défaut, il vaut - <literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal> - </simpara> - </listitem> - </itemizedlist> - <note> - <para> - La gestion des sessions a été ajoutée en PHP 4.0. - </para> - </note> - </para> + </para> + </section> </partintro> &reference.session.functions; @@ -486,3 +386,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + Index: phpdoc-fr/reference/session/functions/session-cache-expire.xml diff -u phpdoc-fr/reference/session/functions/session-cache-expire.xml:1.3 phpdoc-fr/reference/session/functions/session-cache-expire.xml:1.4 --- phpdoc-fr/reference/session/functions/session-cache-expire.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-cache-expire.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.38 --> <refentry id="function.session-cache-expire"> <refnamediv> @@ -14,8 +14,12 @@ </methodsynopsis> <para> <function>session_cache_expire</function> retourne la configuration actuelle du cache expire - Si <parameter>new_cache_expire</parameter> est fourni, la configuration + Si <parameter>new_cache_expire</parameter> est fourni dans le fichier &php.ini;, la configuration 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>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-cache-limiter.xml diff -u phpdoc-fr/reference/session/functions/session-cache-limiter.xml:1.3 phpdoc-fr/reference/session/functions/session-cache-limiter.xml:1.4 --- phpdoc-fr/reference/session/functions/session-cache-limiter.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-cache-limiter.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.62 --> <refentry id="function.session-cache-limiter"> <refnamediv> @@ -19,7 +19,7 @@ <parameter>cache_limiter</parameter>. </para> <para> - Le limiteur de cache contrôle les entêtes HTTP envoyés au client. + Le limiteur de cache contrôle les entêtes HTTP envoyés au client. Certains entêtes détermine les règles de mise en cache de la page sur le nivagateur. En configurant ce limiteur à <literal>nocache</literal>, par exemple, le navigateur ne mettra pas la page dans son cache. La valeur @@ -30,7 +30,7 @@ <para> En mode <literal>private</literal>, l'entête Expire envoyé au client peut poser des problèmes à certains navigateurs, comme notamment - Moziall. Vous pouvez éviter ce problème avec le mode + Mozilla. Vous pouvez éviter ce problème avec le mode <literal>private_no_expire</literal>. L'entête Expire n'est jamais envoyé au navigateur pour ce mode. </para> @@ -41,8 +41,9 @@ </note> <para> Le limiteur de cache est remis à la valeur par défaut de - <literal>session.cache_limiter</literal> à chaque démarrage de script HPP. - Donc, vuos devrez appeler <function>session_cache_limiter</function> à + <link linkend="ini.session.cache-limiter">session.cache_limiter</link> à chaque + démarrage de script &php;. + Donc, vous devrez appeler <function>session_cache_limiter</function> à chaque page, et avant <function>session_start</function>. </para> <example> @@ -51,7 +52,7 @@ <![CDATA[ <?php -// configure le limiteur de cache à 'private' +/* configure le limiteur de cache à 'private' */ session_cache_limiter('private'); $cache_limiter = session_cache_limiter(); @@ -61,6 +62,10 @@ ]]> </programlisting> </example> + <para> + Voir aussi la directive de configuration + <link linkend="ini.session.cache-limiter">session.cache_limiter</link>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-decode.xml diff -u phpdoc-fr/reference/session/functions/session-decode.xml:1.3 phpdoc-fr/reference/session/functions/session-decode.xml:1.4 --- phpdoc-fr/reference/session/functions/session-decode.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-decode.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-decode"> <refnamediv> @@ -16,6 +16,10 @@ <function>session_decode</function> décode les données de sessions fournies dans le paramètre <parameter>data</parameter>, et défini les variables ainsi contenues dans la session. + </para> + <para> + Voir aussi + <function>session_encode</function> </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-encode.xml diff -u phpdoc-fr/reference/session/functions/session-encode.xml:1.3 phpdoc-fr/reference/session/functions/session-encode.xml:1.4 --- phpdoc-fr/reference/session/functions/session-encode.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-encode.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-encode"> <refnamediv> @@ -15,9 +15,13 @@ <void/> </methodsynopsis> <para> - <function>session_encode</function> retourne une chaîne + <function>session_encode</function> retourne une chaîne contenant les variables de la session courante encodé, prêt au stockage. + </para> + <para> + Voir aussi + <function>session_decode</function> </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-get-cookie-params.xml diff -u phpdoc-fr/reference/session/functions/session-get-cookie-params.xml:1.3 phpdoc-fr/reference/session/functions/session-get-cookie-params.xml:1.4 --- phpdoc-fr/reference/session/functions/session-get-cookie-params.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-get-cookie-params.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.8 --> <refentry id="function.session-get-cookie-params"> <refnamediv> @@ -41,6 +41,14 @@ </simpara> </listitem> </itemizedlist> + </para> + <para> + Voir aussi les directives de configuration + <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link>, + <link linkend="ini.session.cookie-path">session.cookie_path</link>, + <link linkend="ini.session.cookie-domain">session.cookie_domain</link>, + <link linkend="ini.session.cookie-secure">session.cookie_secure</link> et + <function>session_set_cookie_params</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-id.xml diff -u phpdoc-fr/reference/session/functions/session-id.xml:1.3 phpdoc-fr/reference/session/functions/session-id.xml:1.4 --- phpdoc-fr/reference/session/functions/session-id.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-id.xml Sat Jan 18 21:41:53 2003 @@ -1 +1 @@ -<?xml version="1.0" encoding="iso-8859-1"?><!-- $Revision: 1.3 $ --><!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-id"> <refnamediv> <refname>session_id</refname> <refpurpose>Let et/ou modifie l'identifiant courant de session</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>session_id</methodname> <methodparam choice="opt"><type>string</type><parameter>id</parameter></methodparam> </methodsynopsis> <para> <function>session_id</function> retourne l'identifiant courant de session. </para> <para> Si <parameter>id</parameter> est fourni, il remplacera l'identifiant courant de session. <function>session_id</function> doit alors être appelé avant <function>session_start</function>. Suivant le gestionnaire de session que vous utilisez, tous les caractères ne seront pas acceptés dans cette valeur. Par exemple, le gestionnaire de session par défaut, basé sur les fichiers, n'accepte que les lettres et chiffres! </para> <para> La consante <systemitem>SID</systemitem> peut alors être utilisée pour lire le nom de la session courante, et l'identifiant de session à fournir dans les URL. Notez que <systemitem>SID</systemitem> est uniquement défini si le client n'a pas envoyé le bon cookie. Voyez aussi <link linkend="ref.session">Gestion de session</link>. </para> <para> Voir aussi <function>session_start</function>. </para> </refsect1> </refentry><!-- Keep this comment at the end of the fileLocal variables:mode: sgmlsgml-omittag:tsgml-shorttag:tsgml-minimize-attributes:nilsgml-always-quote-attributes:tsgml-indent-step:1sgml-indent-data:tindent-tabs-mode:nilsgml-parent-document:nilsgml-default-dtd-file:"../../../../manual.ced"sgml-exposed-tags:nilsgml-local-catalogs:nilsgml-local-ecat-files:nilEnd:vim600: syn=xml fen fdm=syntax fdl=2 sivim: et tw=78 syn=sgmlvi: ts=1 sw=1--> \ No newline at end of file +<?xml version="1.0" encoding="iso-8859-1"?><!-- $Revision: 1.4 $ --><!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-id"> <refnamediv> <refname>session_id</refname> <refpurpose>Let et/ou modifie l'identifiant courant de session</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>session_id</methodname> <methodparam choice="opt"><type>string</type><parameter>id</parameter></methodparam> </methodsynopsis> <para> <function>session_id</function> retourne l'identifiant courant de session. </para> <para> Si <parameter>id</parameter> est fourni, il remplacera l'identifiant courant de session. <function>session_id</function> doit alors être appelé avant <function>session_start</function>. Suivant le gestionnaire de session que vous utilisez, tous les caractères ne seront pas acceptés dans cette valeur. Par exemple, le gestionnaire de session par défaut, basé sur les fichiers, n'accepte que les lettres et chiffres! </para> <para> La consante <systemitem>SID</systemitem> peut alors être utilisée pour lire le nom de la session courante, et l'identifiant de session à fournir dans les URL. Notez que <systemitem>SID</systemitem> est uniquement défini si le client n'a pas envoyé le bon cookie. Voyez aussi <link linkend="ref.session">Gestion de session</link>. </para> <para> Voir aussi <function>session_start</function>, <function>session_set_save_handler</function> et <link linkend="ini.session.save-handler">session.save_handler</link>. </para> </refsect1> </refentry><!-- Keep this comment at the end of the fileLocal variables:mode: sgmlsgml-omittag:tsgml-shorttag:tsgml-minimize-attributes:nilsgml-always-quote-attributes:tsgml-indent-step:1sgml-indent-data:tindent-tabs-mode:nilsgml-parent-document:nilsgml-default-dtd-file:"../../../../manual.ced"sgml-exposed-tags:nilsgml-local-catalogs:nilsgml-local-ecat-files:nilEnd:vim600: syn=xml fen fdm=syntax fdl=2 sivim: et tw=78 syn=sgmlvi: ts=1 sw=1--> \ No newline at end of file Index: phpdoc-fr/reference/session/functions/session-name.xml diff -u phpdoc-fr/reference/session/functions/session-name.xml:1.3 phpdoc-fr/reference/session/functions/session-name.xml:1.4 --- phpdoc-fr/reference/session/functions/session-name.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-name.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-name"> <refnamediv> @@ -33,15 +33,19 @@ <![CDATA[ <?php -// choisi le nom de SiteWebSession +/* choisi le nom de session : MaSession */ -$previous_name = session_name("SiteWebSession"); +$previous_name = session_name("MaSession"); echo "L'ancien nom de la session était $previous_name<p>"; ?> ]]> </programlisting> </example> + <para> + Voir aussi la directive de configuration + <link linkend="session.configuration">session.name</link>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-register.xml diff -u phpdoc-fr/reference/session/functions/session-register.xml:1.4 phpdoc-fr/reference/session/functions/session-register.xml:1.5 --- phpdoc-fr/reference/session/functions/session-register.xml:1.4 Wed Oct 9 21:17:11 2002 +++ phpdoc-fr/reference/session/functions/session-register.xml Sat Jan 18 21:41:53 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.2 --> <refentry id="function.session-register"> <refnamediv> @@ -19,7 +19,7 @@ <function>session_register</function> enregistre toutes les variables de nom <parameter>name</parameter> dans la session courante. Le nombre de variables enregistré est libre. Les noms peuvent être - passé comme des chaînes, ou comme des tableaux contenant des chaînes + passé comme des chaînes, ou comme des tableaux contenant des chaînes ou des tableaux. Poru chaque nom, <function>session_register</function> place la variable dans la session courante, pour la sauvegarde de fin de script. @@ -80,7 +80,7 @@ identifiées avec le type <literal>resource</literal> dans leur définitions. Une liste de fonction qui retournent de3s ressources sont disponible dans l'annexe - <link linkend="resources">types de ressources</link>. + <link linkend="resource">types de ressources</link>. </para> <para> Si <varname>$_SESSION</varname> (ou Index: phpdoc-fr/reference/session/functions/session-save-path.xml diff -u phpdoc-fr/reference/session/functions/session-save-path.xml:1.3 phpdoc-fr/reference/session/functions/session-save-path.xml:1.4 --- phpdoc-fr/reference/session/functions/session-save-path.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-save-path.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-save-path"> <refnamediv> @@ -16,7 +16,8 @@ <function>session_save_path</function> retourne le chemin du dossier actuellement utilisé pour sauver les données de sessions. Si <parameter>path</parameter> est spécifié, le chemin du dossier - sera modifié. + sera modifié. <function>session_save_path</function> doit être appelé + avant <function>session_start</function>. <note> <para> Sur certains systèmes d'exploitation, vous aurez à choisir un @@ -26,6 +27,10 @@ </para> </note> </para> + <para> + Voir aussi la directive de configuration + <link linkend="ini.session.save-path">session.save_path</link>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-set-cookie-params.xml diff -u phpdoc-fr/reference/session/functions/session-set-cookie-params.xml:1.3 phpdoc-fr/reference/session/functions/session-set-cookie-params.xml:1.4 --- phpdoc-fr/reference/session/functions/session-set-cookie-params.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-set-cookie-params.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-set-cookie-params"> <refnamediv> @@ -27,6 +27,14 @@ Le paramètre <parameter>secure</parameter> aé ét ajouté en PHP 4.0.4. </para> </note> + <para> + Voir aussi les directives de configuration + <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link>, + <link linkend="ini.session.cookie-path">session.cookie_path</link>, + <link linkend="ini.session.cookie-domain">session.cookie_domain</link>, + <link linkend="ini.session.cookie-secure">session.cookie_secure</link> et + <function>session_get_cookie_params</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-set-save-handler.xml diff -u phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.3 phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.4 --- phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-set-save-handler.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.23 --> <refentry id="function.session-set-save-handler"> <refnamediv> @@ -25,13 +25,6 @@ </para> <note> <para> - Vous devez configurer l'option <parameter>session.save_handler</parameter> - à <parameter>user</parameter> dans votre fichier &php.ini; pour que - <function>session_set_save_handler</function> soit actif. - </para> - </note> - <note> - <para> Le gestionnaire d'écriture n'est pas exécuté tant que le flot de sortie est ouvert. Par conséquent, l'affichage de messages de debogage durant le gestionnaire d'écriture @@ -56,9 +49,9 @@ sauvegardes en bases de données, avec votre serveur préféré. </para> <para> - La fonction de lecture doit toujours retourner une chaîne, + La fonction de lecture doit toujours retourner une chaîne, pour que le gestionnaire fonctionne comme prévu. Vous devez - retourner une chaîne vide s'il n'y a pas de données à lire. + retourner une chaîne vide s'il n'y a pas de données à lire. Les valeurs retournées par les autres gestionnaires sont converties en booléen avant d'être retournées au script. &true; pour la réussite, &false pour l'échec. @@ -132,6 +125,10 @@ ]]> </programlisting> </example> + </para> + <para> + Voir aussi la directive de configuration + <link linkend="ini.session.save-handler">session.save_handler</link>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/session/functions/session-unset.xml diff -u phpdoc-fr/reference/session/functions/session-unset.xml:1.3 phpdoc-fr/reference/session/functions/session-unset.xml:1.4 --- phpdoc-fr/reference/session/functions/session-unset.xml:1.3 Mon Aug 12 22:59:46 2002 +++ phpdoc-fr/reference/session/functions/session-unset.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.8 --> <refentry id="function.session-unset"> <refnamediv> @@ -22,7 +22,7 @@ <para> Si vous utilisez <varname>$_SESSION</varname> (ou <varname>$HTTP_SESSION_VARS</varname>), - utilisez plutôt ceci : $_SESSION = array(); + utilisez plutôt ceci : $_SESSION = array(); </para> </note> </refsect1> Index: phpdoc-fr/reference/session/functions/session-write-close.xml diff -u phpdoc-fr/reference/session/functions/session-write-close.xml:1.1 phpdoc-fr/reference/session/functions/session-write-close.xml:1.2 --- phpdoc-fr/reference/session/functions/session-write-close.xml:1.1 Fri Aug 16 22:03:29 2002 +++ phpdoc-fr/reference/session/functions/session-write-close.xml Sat Jan 18 21:41:53 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.38 --> <refentry id="function.session-write-close"> <refnamediv> @@ -23,9 +23,9 @@ du script, les données de session sont verrouillées en écriture, et un seul script peut opérer sur la session en même temps. Lorsque vous utilisez des frames avec des sessions, vous vous en rendrez - compte en voyant les frames se rafraîchir les uns après les autres. + compte en voyant les frames se rafraîchir les uns après les autres. Vous pouvez réduire le temps de calcul de ces pages en refermant - la session aussitôt que possible, et ainsi, libérant les données + la session aussitôt que possible, et ainsi, libérant les données pour les autres scripts. </para> <para>