cvs: phpdoc-fr /reference/session reference.xml /reference/session/functions session-write-close.xml
| From: | Damien Seguy | Date: | Sat, 17 Aug 2002 02:03:29 +0000 |
| Subject: | cvs: phpdoc-fr /reference/session reference.xml /reference/session/functions session-write-close.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-27@lists.php.net to get a copy of this message | ||
dams Fri Aug 16 22:03:29 2002 EDT
Added files:
/phpdoc-fr/reference/session/functions session-write-close.xml
Modified files:
/phpdoc-fr/reference/session reference.xml
Log:
Correcting special chars
Index: phpdoc-fr/reference/session/reference.xml diff -u phpdoc-fr/reference/session/reference.xml:1.4 phpdoc-fr/reference/session/reference.xml:1.5 --- phpdoc-fr/reference/session/reference.xml:1.4 Tue Aug 13 16:56:04 2002 +++ phpdoc-fr/reference/session/reference.xml Fri Aug 16 22:03:28 2002 @@ -1,53 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <reference id="ref.session"> <title>Sessions</title> <titleabbrev>Sessions</titleabbrev> <partintro> <para> - Le support des sessions de PHP est un moyen de prserver - des donnes entre plusieurs accs. Cela vous permet de - crer des applications personnalises, et d'augmenter - l'attractivit de votre site. + Le support des sessions de PHP est un moyen de préserver + des données entre plusieurs accès. Cela vous permet de + créer des applications personnalisées, et d'augmenter + l'attractivité de votre site. </para> <para> - SI vous tes familier avec la gestion de session de la + SI vous êtes familier avec la gestion de session de la librairie PHPLIB, vous remarquerez que certains concepts sont similaires. </para> <para> - Chaque visiteur accdant votre page web se voit assign un - identifiant unique, appel 'identifiant de session'. Il peut - tre stock soit dans un cookie, soit propag dans l'URL. + Chaque visiteur accédant à votre page web se voit assigné un + identifiant unique, appelé 'identifiant de session'. Il peut + être stocké soit dans un cookie, soit propagé dans l'URL. </para> <para> Le support des sessions vous permet d'enregistrer un - nombre illimit de variables qui doivent tre prserves - entre les requtes. Lorsqu'un visiteur accde votre site, - PHP va vrifier automatiquement (si session.auto_start est - activ1) ou sur demande (explicitement avec + nombre illimité de variables qui doivent être préservées + entre les requêtes. Lorsqu'un visiteur accède à votre site, + PHP va vérifier automatiquement (si session.auto_start est + activé1) ou sur demande (explicitement avec <function>session_start</function> ou implicitement avec <function>session_register</function>) si il existe une - session du mme nom. Si c'est le cas, l'environnement - prcdemment sauv sera recr. + session du même nom. Si c'est le cas, l'environnement + précédemment sauvé sera recréé. </para> <para> - Toutes les variables sont srialises aprs l'excution du - script PHP. Les variables qui sont indfinies sont marques - comme telles. Lors des accs ultrieurs, elles ne seront pas - dfinies, jusqu' ce que l'utilisateur le fasse. + Toutes les variables sont sérialisées après l'exécution du + script PHP. Les variables qui sont indéfinies sont marquées + 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 manire de stockage et dstockage des variables. + influencent la manière de stockage et déstockage des variables. </para> <note> <para> Depuis PHP 4.0.3, <link linkend="ini.track-vars"><literal>track_vars</literal></link> - est toujours activ. + est toujours activé. </para> </note> <note> @@ -55,24 +55,24 @@ 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 consquent, + 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>. </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 dsactiv, seuls les lments du tableau global + 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 - enregistres dans la session. Les variables de sessions relues seront + 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 + activé </title> <programlisting role="php"> <![CDATA[ @@ -92,7 +92,7 @@ <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 scurit et de lisibilit du + 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 @@ -134,37 +134,37 @@ </para> <para> Si <link linkend="ini.register-globals"><literal>register_globals</literal></link> - est activ, alors toutes les variables globales peuvent tre - enregistres comme variables de session, et toutes les variables de sessions - seront reconstitues comme variables globales. Comme PHP doit - savoir quels variables globales sont enregistres comme variables + est activé, alors toutes les variables globales peuvent être + enregistrées comme variables de session, et toutes les variables de sessions + seront reconstituées comme variables globales. Comme PHP doit + savoir quels variables globales sont enregistrées comme variables de sessions, l'utilisateur doit enregistrer les variables avec <function>session_register</function> tandis que <varname>$HTTP_SESSION_VARS</varname> et <varname>$_SESSION</varname> - ne ncessitent pas <function>session_register</function>. + ne nécessitent pas <function>session_register</function>. <caution> <para> Si vous utilisez <varname>$HTTP_SESSION_VARS</varname> et <varname>$_SESSION</varname> - et dsactivez <link linkend="ini.register-globals"><literal>register_globals</literal></link>, + et désactivez <link linkend="ini.register-globals"><literal>register_globals</literal></link>, n'utilisez pas <function>session_register</function>, <function>session_is_registered</function> et <function>session_unregister</function>. </para> <para> Si vous activez <link linkend="ini.register-globals"><literal>register_globals</literal></link>, - <function>session_unregister</function> doit tre utilis, car les - variables de session sont enregistrs comme variables globales lorsque - les donnes de sessions sont relues. Inactiver + <function>session_unregister</function> doit être utilisé, car les + variables de session sont enregistrés comme variables globales lorsque + les données de sessions sont relues. Inactiver <link linkend="ini.register-globals"><literal>register_globals</literal></link> - est recommand pour des raisons de scurit et de performances. + est recommandé pour des raisons de sécurité et de performances. </para> </caution> <example> <title> Enregistrer une variable avec <link linkend="ini.register-globals"><literal>register_globals</literal></link> - activ + activé </title> <programlisting role="php"> <![CDATA[ @@ -185,20 +185,20 @@ 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 activs, alors les variables globales + sont activés, alors les variables globales <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> - reprsenteront les mmes valeurs que celles qui sont enregistres avec les - variables de mme nom. + 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 gnrs partir des informations stockes en session. + ne contiendront pas ces variables jusqu'à ce le tableau soit + de nouveau générés à partir des informations stockées en session. </para> <para> - Il y a deux mthodes de propagation de l'identifiant de session : + Il y a deux méthodes de propagation de l'identifiant de session : <itemizedlist> <listitem> <simpara> @@ -207,37 +207,37 @@ </listitem> <listitem> <simpara> - Paramter URL + Paramèter URL </simpara> </listitem> </itemizedlist> </para> <para> - Le module de session supporte les deux mthodes. Les cookies sont + Le module de session supporte les deux méthodes. Les cookies sont optimaux, mais comme ils ne sont pas sûrs (tous les internautes ne les acceptent pas), ils ne sont pas fiables. La seconde - mthode place l'identifiant de session directement dans les URL. + méthode place l'identifiant de session directement dans les URL. </para> <para> - PHP est de faire cela de manire transparente, lorsqu'il est compil + PHP est 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 modifies pour contenir + cette option, les URL relatives seront modifiées pour contenir l'identifiant de session automatiquement. Alternativement, vous pouvez utiliser la constante <constant>SID</constant>, qui est - dfinie, si le client n'a pas envoy le cookie appropri. + 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. <note> <para> L'option <link linkend="ini.arg_separator.output">arg_separator.output</link> - de &php.ini; vous permet de personnaliser le sparateur d'arguments. + 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 - raliser un lien correct avec une autre page, avec <constant>SID</constant>. + 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"> @@ -256,8 +256,8 @@ <?php // Le <?php echo SID?> (<?=SID?> est aussi possible suivant votre configuration) -// est ncessaire pour prserver l'identifiant de sessions -// si jamais l'utilisateur a dsactiv les cookies. +// 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>. @@ -266,25 +266,25 @@ </example> </para> <para> - <literal><?=SID?></literal> n'est pas ncessair, si + <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. + <literal>--enable-trans-sid</literal></link> a été activé à la compilation de PHP. </para> <note> <para> - Les URLS non relatives sont considres comme externes au site, et ne + 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> - Pour implmenter un stockage en base de donnes, ou toute autre mthode, + 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 - paramtrer vos propres fonctions de stockage. + paramétrer vos propres fonctions de stockage. </para> <para> - Le systme de session supporte un grand nombre d'options, que vous pouvez - placer dans le fichier &php.ini; file. En voici une prsentation. + 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> @@ -296,20 +296,20 @@ </listitem> <listitem> <simpara> - <literal>session.save_path</literal> dfinit le chemin qui - doit tre pass au gestionnaire de sauvegarde. Si vous - dcidez de choisir le gestionnaire par dfaut (par fichier), - cet argument sera utilis comme dossier de sauvegarde - des sessions. Par dfaut, il vaut <filename>/tmp</filename>. Si + <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 suprieur 2, le nettoyage des sessions obsoltes ne s'oprera + est supérieur à 2, le nettoyage des sessions obsolètes ne s'opérera pas. </simpara> <warning> <para> - Si vous laissez cette option configure avec un dossier - accessible en lecture tout le monde, comme par exemple - <filename>/tmp</filename> (par dfaut), les autres utilisateurs + 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> @@ -317,35 +317,35 @@ </listitem> <listitem> <simpara> - <literal>session.name</literal> spcifie le nom de la session, - qui sera utilis comme nom de cookie. Il ne doit contenir que - des caractres alphanumrique. Par dfaut, c'est + <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> spcifie si le module - de session doit dmarrer automatiquement, au dbut de - chaque script PHP. Par dfaut, c'est <literal>0</literal> (inactiv). + <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> spcifie la dure de + <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". + siginifie : "Jusqu'à ce que le navigateur soit éteind". </simpara> </listitem> <listitem> <simpara> - <literal>session.serialize_handler</literal> dfinit le nom - du gestionnaire qui est utilis pour linariser/dlinariser - les donnes. Actuellement, un format interne PHP - (nomm <literal>php</literal>) et WDDX (nomm - <literal>wddx</literal>) sont supports . WDDX est seulement - disponible, si PHP a t compil avec l'option - <link linkend="ref.wddx">WDDX</link>. Par dfaut, c'est <literal>php</literal>. + <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> @@ -357,106 +357,106 @@ </listitem> <listitem> <simpara> - <literal>session.gc_maxlifetime</literal> spcifie la dure de - vie des donnes sur le serveur, en nombre de secondes. Aprs - cette dure, les donnes seront considres comme obsoltes, - et supprimes. + <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 enttes HTTP Referer. Si - cet enttes a t envoy par le client, et que la sous-chaîne n'a pas - t trouv, l'identifiant de session sera considr comme invalide. - Par dfaut, cette option est la chaîne vide. + 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 utilise comme source - additionnelle d'entropie pour la cration de l'identifiant + <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 systmes Unix. + tous les systèmes Unix. </simpara> </listitem> <listitem> <simpara> - <literal>session.entropy_length</literal> spcifie le nombre d'octets - qui seront lus dans le fichier dfini ci-dessus. Par dfaut, il - vaut <literal>0</literal>, c'est dire inactif. + <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> spcifie si le module utilisera - les cookies pour stocker les donnes de session sur le client. - Par dfaut, il vaut <literal>1</literal>, c'est dire actif. + <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> spcifie si le module + <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 dfaut, - 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 ajoute + 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> spcifie le chemin utilis - lors de la cration du cookie. Par dfaut, il vaut <literal>/</literal>. + <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> spcifie le domaine utilis - lors de la cration du cookie. Par dfaut, il ne vaut rien. + <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> spcifie le type de - contrôle de cache utilis pour les pages avec sessions. Les + <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 dfaut, il vaut + none, nocache, private, private_no_expire, public. Par défaut, il vaut <literal>nocache</literal>. </simpara> </listitem> <listitem> <simpara> - <literal>session.cache_expire</literal> spcifie la dure de - vie des donnes de sessions, en minute. Cette option n'a aucune - consquence sur le contrôle de cache. Par dfaut, il vaut + <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, grce l'option + 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 dfaut, il vaut <literal>1</literal> (activ). + Par défaut, il vaut <literal>1</literal> (activé). </simpara> </listitem> <listitem> <simpara> - <literal>url_rewriter.tags</literal> spcifie quels sont les balises - HTML qui doivent tre rcrites si le support transparent du SID - est activ. Par dfaut, il vaut + <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 ajoute en PHP 4.0. + La gestion des sessions a été ajoutée en PHP 4.0. </para> </note> </para> Index: phpdoc-fr/reference/session/functions/session-write-close.xml +++ phpdoc-fr/reference/session/functions/session-write-close.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.38 --> <refentry id="function.session-write-close"> <refnamediv> <refname>session_write_close</refname> <refpurpose>Ecrit les données de session et ferme la session</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>void</type><methodname>session_write_close</methodname> <void/> </methodsynopsis> <para> <methodname>session_write_close</methodname> termine la session courante, après avoir stocker les données. </para> <para> Les données de session sont généralement stockés après la fin de votre script, automatiquement, sans besoin d'appeler explicitement <function>session_write_close</function>. Mais durant toute l'exécution 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. 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 pour les autres scripts. </para> <para> Voir aussi <function>session_readonly</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
Index: phpdoc-fr/reference/session/reference.xml diff -u phpdoc-fr/reference/session/reference.xml:1.4 phpdoc-fr/reference/session/reference.xml:1.5 --- phpdoc-fr/reference/session/reference.xml:1.4 Tue Aug 13 16:56:04 2002 +++ phpdoc-fr/reference/session/reference.xml Fri Aug 16 22:03:28 2002 @@ -1,53 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <reference id="ref.session"> <title>Sessions</title> <titleabbrev>Sessions</titleabbrev> <partintro> <para> - Le support des sessions de PHP est un moyen de prserver - des donnes entre plusieurs accs. Cela vous permet de - crer des applications personnalises, et d'augmenter - l'attractivit de votre site. + Le support des sessions de PHP est un moyen de préserver + des données entre plusieurs accès. Cela vous permet de + créer des applications personnalisées, et d'augmenter + l'attractivité de votre site. </para> <para> - SI vous tes familier avec la gestion de session de la + SI vous êtes familier avec la gestion de session de la librairie PHPLIB, vous remarquerez que certains concepts sont similaires. </para> <para> - Chaque visiteur accdant votre page web se voit assign un - identifiant unique, appel 'identifiant de session'. Il peut - tre stock soit dans un cookie, soit propag dans l'URL. + Chaque visiteur accédant à votre page web se voit assigné un + identifiant unique, appelé 'identifiant de session'. Il peut + être stocké soit dans un cookie, soit propagé dans l'URL. </para> <para> Le support des sessions vous permet d'enregistrer un - nombre illimit de variables qui doivent tre prserves - entre les requtes. Lorsqu'un visiteur accde votre site, - PHP va vrifier automatiquement (si session.auto_start est - activ1) ou sur demande (explicitement avec + nombre illimité de variables qui doivent être préservées + entre les requêtes. Lorsqu'un visiteur accède à votre site, + PHP va vérifier automatiquement (si session.auto_start est + activé1) ou sur demande (explicitement avec <function>session_start</function> ou implicitement avec <function>session_register</function>) si il existe une - session du mme nom. Si c'est le cas, l'environnement - prcdemment sauv sera recr. + session du même nom. Si c'est le cas, l'environnement + précédemment sauvé sera recréé. </para> <para> - Toutes les variables sont srialises aprs l'excution du - script PHP. Les variables qui sont indfinies sont marques - comme telles. Lors des accs ultrieurs, elles ne seront pas - dfinies, jusqu' ce que l'utilisateur le fasse. + Toutes les variables sont sérialisées après l'exécution du + script PHP. Les variables qui sont indéfinies sont marquées + 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 manire de stockage et dstockage des variables. + influencent la manière de stockage et déstockage des variables. </para> <note> <para> Depuis PHP 4.0.3, <link linkend="ini.track-vars"><literal>track_vars</literal></link> - est toujours activ. + est toujours activé. </para> </note> <note> @@ -55,24 +55,24 @@ 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 consquent, + 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>. </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 dsactiv, seuls les lments du tableau global + 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 - enregistres dans la session. Les variables de sessions relues seront + 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 + activé </title> <programlisting role="php"> <![CDATA[ @@ -92,7 +92,7 @@ <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 scurit et de lisibilit du + 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 @@ -134,37 +134,37 @@ </para> <para> Si <link linkend="ini.register-globals"><literal>register_globals</literal></link> - est activ, alors toutes les variables globales peuvent tre - enregistres comme variables de session, et toutes les variables de sessions - seront reconstitues comme variables globales. Comme PHP doit - savoir quels variables globales sont enregistres comme variables + est activé, alors toutes les variables globales peuvent être + enregistrées comme variables de session, et toutes les variables de sessions + seront reconstituées comme variables globales. Comme PHP doit + savoir quels variables globales sont enregistrées comme variables de sessions, l'utilisateur doit enregistrer les variables avec <function>session_register</function> tandis que <varname>$HTTP_SESSION_VARS</varname> et <varname>$_SESSION</varname> - ne ncessitent pas <function>session_register</function>. + ne nécessitent pas <function>session_register</function>. <caution> <para> Si vous utilisez <varname>$HTTP_SESSION_VARS</varname> et <varname>$_SESSION</varname> - et dsactivez <link linkend="ini.register-globals"><literal>register_globals</literal></link>, + et désactivez <link linkend="ini.register-globals"><literal>register_globals</literal></link>, n'utilisez pas <function>session_register</function>, <function>session_is_registered</function> et <function>session_unregister</function>. </para> <para> Si vous activez <link linkend="ini.register-globals"><literal>register_globals</literal></link>, - <function>session_unregister</function> doit tre utilis, car les - variables de session sont enregistrs comme variables globales lorsque - les donnes de sessions sont relues. Inactiver + <function>session_unregister</function> doit être utilisé, car les + variables de session sont enregistrés comme variables globales lorsque + les données de sessions sont relues. Inactiver <link linkend="ini.register-globals"><literal>register_globals</literal></link> - est recommand pour des raisons de scurit et de performances. + est recommandé pour des raisons de sécurité et de performances. </para> </caution> <example> <title> Enregistrer une variable avec <link linkend="ini.register-globals"><literal>register_globals</literal></link> - activ + activé </title> <programlisting role="php"> <![CDATA[ @@ -185,20 +185,20 @@ 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 activs, alors les variables globales + sont activés, alors les variables globales <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> - reprsenteront les mmes valeurs que celles qui sont enregistres avec les - variables de mme nom. + 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 gnrs partir des informations stockes en session. + ne contiendront pas ces variables jusqu'à ce le tableau soit + de nouveau générés à partir des informations stockées en session. </para> <para> - Il y a deux mthodes de propagation de l'identifiant de session : + Il y a deux méthodes de propagation de l'identifiant de session : <itemizedlist> <listitem> <simpara> @@ -207,37 +207,37 @@ </listitem> <listitem> <simpara> - Paramter URL + Paramèter URL </simpara> </listitem> </itemizedlist> </para> <para> - Le module de session supporte les deux mthodes. Les cookies sont + Le module de session supporte les deux méthodes. Les cookies sont optimaux, mais comme ils ne sont pas sûrs (tous les internautes ne les acceptent pas), ils ne sont pas fiables. La seconde - mthode place l'identifiant de session directement dans les URL. + méthode place l'identifiant de session directement dans les URL. </para> <para> - PHP est de faire cela de manire transparente, lorsqu'il est compil + PHP est 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 modifies pour contenir + cette option, les URL relatives seront modifiées pour contenir l'identifiant de session automatiquement. Alternativement, vous pouvez utiliser la constante <constant>SID</constant>, qui est - dfinie, si le client n'a pas envoy le cookie appropri. + 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. <note> <para> L'option <link linkend="ini.arg_separator.output">arg_separator.output</link> - de &php.ini; vous permet de personnaliser le sparateur d'arguments. + 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 - raliser un lien correct avec une autre page, avec <constant>SID</constant>. + 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"> @@ -256,8 +256,8 @@ <?php // Le <?php echo SID?> (<?=SID?> est aussi possible suivant votre configuration) -// est ncessaire pour prserver l'identifiant de sessions -// si jamais l'utilisateur a dsactiv les cookies. +// 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>. @@ -266,25 +266,25 @@ </example> </para> <para> - <literal><?=SID?></literal> n'est pas ncessair, si + <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. + <literal>--enable-trans-sid</literal></link> a été activé à la compilation de PHP. </para> <note> <para> - Les URLS non relatives sont considres comme externes au site, et ne + 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> - Pour implmenter un stockage en base de donnes, ou toute autre mthode, + 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 - paramtrer vos propres fonctions de stockage. + paramétrer vos propres fonctions de stockage. </para> <para> - Le systme de session supporte un grand nombre d'options, que vous pouvez - placer dans le fichier &php.ini; file. En voici une prsentation. + 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> @@ -296,20 +296,20 @@ </listitem> <listitem> <simpara> - <literal>session.save_path</literal> dfinit le chemin qui - doit tre pass au gestionnaire de sauvegarde. Si vous - dcidez de choisir le gestionnaire par dfaut (par fichier), - cet argument sera utilis comme dossier de sauvegarde - des sessions. Par dfaut, il vaut <filename>/tmp</filename>. Si + <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 suprieur 2, le nettoyage des sessions obsoltes ne s'oprera + est supérieur à 2, le nettoyage des sessions obsolètes ne s'opérera pas. </simpara> <warning> <para> - Si vous laissez cette option configure avec un dossier - accessible en lecture tout le monde, comme par exemple - <filename>/tmp</filename> (par dfaut), les autres utilisateurs + 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> @@ -317,35 +317,35 @@ </listitem> <listitem> <simpara> - <literal>session.name</literal> spcifie le nom de la session, - qui sera utilis comme nom de cookie. Il ne doit contenir que - des caractres alphanumrique. Par dfaut, c'est + <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> spcifie si le module - de session doit dmarrer automatiquement, au dbut de - chaque script PHP. Par dfaut, c'est <literal>0</literal> (inactiv). + <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> spcifie la dure de + <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". + siginifie : "Jusqu'à ce que le navigateur soit éteind". </simpara> </listitem> <listitem> <simpara> - <literal>session.serialize_handler</literal> dfinit le nom - du gestionnaire qui est utilis pour linariser/dlinariser - les donnes. Actuellement, un format interne PHP - (nomm <literal>php</literal>) et WDDX (nomm - <literal>wddx</literal>) sont supports . WDDX est seulement - disponible, si PHP a t compil avec l'option - <link linkend="ref.wddx">WDDX</link>. Par dfaut, c'est <literal>php</literal>. + <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> @@ -357,106 +357,106 @@ </listitem> <listitem> <simpara> - <literal>session.gc_maxlifetime</literal> spcifie la dure de - vie des donnes sur le serveur, en nombre de secondes. Aprs - cette dure, les donnes seront considres comme obsoltes, - et supprimes. + <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 enttes HTTP Referer. Si - cet enttes a t envoy par le client, et que la sous-chaîne n'a pas - t trouv, l'identifiant de session sera considr comme invalide. - Par dfaut, cette option est la chaîne vide. + 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 utilise comme source - additionnelle d'entropie pour la cration de l'identifiant + <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 systmes Unix. + tous les systèmes Unix. </simpara> </listitem> <listitem> <simpara> - <literal>session.entropy_length</literal> spcifie le nombre d'octets - qui seront lus dans le fichier dfini ci-dessus. Par dfaut, il - vaut <literal>0</literal>, c'est dire inactif. + <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> spcifie si le module utilisera - les cookies pour stocker les donnes de session sur le client. - Par dfaut, il vaut <literal>1</literal>, c'est dire actif. + <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> spcifie si le module + <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 dfaut, - 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 ajoute + 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> spcifie le chemin utilis - lors de la cration du cookie. Par dfaut, il vaut <literal>/</literal>. + <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> spcifie le domaine utilis - lors de la cration du cookie. Par dfaut, il ne vaut rien. + <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> spcifie le type de - contrôle de cache utilis pour les pages avec sessions. Les + <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 dfaut, il vaut + none, nocache, private, private_no_expire, public. Par défaut, il vaut <literal>nocache</literal>. </simpara> </listitem> <listitem> <simpara> - <literal>session.cache_expire</literal> spcifie la dure de - vie des donnes de sessions, en minute. Cette option n'a aucune - consquence sur le contrôle de cache. Par dfaut, il vaut + <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, grce l'option + 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 dfaut, il vaut <literal>1</literal> (activ). + Par défaut, il vaut <literal>1</literal> (activé). </simpara> </listitem> <listitem> <simpara> - <literal>url_rewriter.tags</literal> spcifie quels sont les balises - HTML qui doivent tre rcrites si le support transparent du SID - est activ. Par dfaut, il vaut + <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 ajoute en PHP 4.0. + La gestion des sessions a été ajoutée en PHP 4.0. </para> </note> </para> Index: phpdoc-fr/reference/session/functions/session-write-close.xml +++ phpdoc-fr/reference/session/functions/session-write-close.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.38 --> <refentry id="function.session-write-close"> <refnamediv> <refname>session_write_close</refname> <refpurpose>Ecrit les données de session et ferme la session</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>void</type><methodname>session_write_close</methodname> <void/> </methodsynopsis> <para> <methodname>session_write_close</methodname> termine la session courante, après avoir stocker les données. </para> <para> Les données de session sont généralement stockés après la fin de votre script, automatiquement, sans besoin d'appeler explicitement <function>session_write_close</function>. Mais durant toute l'exécution 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. 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 pour les autres scripts. </para> <para> Voir aussi <function>session_readonly</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->