cvs: phpdoc-fr /reference/session configure.xml constants.xml ini.xml

From: Date: Sun, 19 Jan 2003 02:42:15 +0000
Subject: cvs: phpdoc-fr /reference/session configure.xml constants.xml ini.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-165@lists.php.net to get a copy of this message
dams Sat Jan 18 21:42:15 2003 EDT Added files: /phpdoc-fr/reference/session configure.xml constants.xml ini.xml Log: Major update for sessions

Index: phpdoc-fr/reference/session/configure.xml +++ phpdoc-fr/reference/session/configure.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="session.installation"> &reftitle.install; <para> Le suport des sessions est activ&eacute; par d&eacute;faut. Si vous souhaitez exclure le support des sessions de &php;, vous devez utiliser l'option <option role="configure">--disable-session</option> lors de l'ex&eacute;cution du script de configuration. Pour utiliser la m&eacute;moire vive pour le stockage des sessions, compilez &php; avec l'option <option role="configure">--with-mm[=DIR] </option>. </para> &windows.builtin; </section> <!-- 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/constants.xml +++ phpdoc-fr/reference/session/constants.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="session.constants"> &reftitle.constants; &extension.constants; <variablelist> <varlistentry> <term> <constant>SID</constant> (<link linkend="language.types.string">cha&icirc;ne de caract&egrave;res</link>) </term> <listitem> <simpara> Constante contenant le nom de la session et l'identifiant en cours, sous la forme <literal>"name=ID"</literal>. </simpara> </listitem> </varlistentry> </variablelist> </section> <!-- 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/ini.xml +++ phpdoc-fr/reference/session/ini.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="session.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> &ini.table.title; <tgroup cols="3"> <thead> &ini.table.top; </thead> <tbody> <row> <entry>session.save_path</entry> <entry>"/tmp"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.name</entry> <entry>"PHPSESSID"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.save_handler</entry> <entry>"files"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.auto_start</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.gc_probability</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.gc_maxlifetime</entry> <entry>"1440"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.serialize_handler</entry> <entry>"php"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_lifetime</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_path</entry> <entry>"/"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_domain</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_secure</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.use_cookies</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.use_only_cookies</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.referer_check</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.entropy_file</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.entropy_length</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cache_limiter</entry> <entry>"nocache"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cache_expire</entry> <entry>"180"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.use_trans_sid</entry> <entry>"0"</entry> <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> </row> <row> <entry>url_rewriter.tags</entry> <entry>"a=href,area=href,frame=src,input=src,form=fakeentry"</entry> <entry>PHP_INI_ALL</entry> </row> <!-- Not yet <row> <entry>session.encode_sources</entry> <entry>"globals</entry> <entry>track"</entry> </row> --> </tbody> </tgroup> </table> &ini.table.bottom; </para> <para> &ini.explain; <variablelist> <varlistentry id="ini.session.save-handler"> <term> <parameter>session.save_handler</parameter> <type>&string;</type> </term> <listitem> <para> D&eacute;finit le nom du gestionnaire de session, qui est utilis&eacute; pour stocker et relire les donn&eacute;es de session. Par d&eacute;faut, c'est le syst&egrave;me int&eacute;gr&eacute; par fichier : <literal>files</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.session.save-path"> <term> <parameter>session.save_path</parameter> <type>&string;</type> </term> <listitem> <para> D&eacute;finit le chemin qui doit &ecirc;tre pass&eacute; au gestionnaire de sauvegarde. Si vous d&eacute;cidez de choisir le gestionnaire par d&eacute;faut (par fichier), cet argument sera utilis&eacute; comme dossier de sauvegarde des sessions. Par d&eacute;faut, il vaut <filename>/tmp</filename>. Si le niveau d'imbrication de <literal>session.save_path</literal> est sup&eacute;rieur &agrave; 2, le nettoyage des sessions obsol&egrave;tes ne s'op&eacute;rera pas. </para> <warning> <para> Si vous laissez cette option configur&eacute;e avec un dossier accessible en lecture &agrave; tout le monde, comme par exemple <filename>/tmp</filename> (par d&eacute;faut), les autres utilisateurs pourront exploiter ces sessions en obtenant la liste de fichiers dans ce dossier. </para> </warning> <note> <simpara> Les utilisateurs de Windows doivent changer cette valeur de variable pour que les fonctions de sessions de PHP fonctionnent. Indiquez un chemin de dossier valide, comme par exemple : <filename>c:/temp</filename>. </simpara> </note> </listitem> </varlistentry> <varlistentry id="ini.session.name"> <term> <parameter>session.name</parameter> <type>&string;</type> </term> <listitem> <para> Sp&eacute;cifie le nom de la session, qui sera utilis&eacute; comme nom de cookie. Il ne doit contenir que des caract&egrave;res alphanum&eacute;rique. Par d&eacute;faut, c'est <literal>PHPSESSID</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.session.auto-start"> <term> <parameter>session.auto_start</parameter> <type>&integer;</type> </term> <listitem> <para> Sp&eacute;cifie si le module de session doit d&eacute;marrer automatiquement, au d&eacute;but de chaque script PHP. Par d&eacute;faut, c'est <literal>0</literal> (inactiv&eacute;). </para> </listitem> </varlistentry> <varlistentry id="ini.session.cookie-lifetime"> <term> <parameter>session.cookie_lifetime</parameter> <type>&integer;</type> </term> <listitem> <para> Sp&eacute;cifie la dur&eacute;e de vie du cookie en secondes. La valeur de <literal>0</literal> siginifie : "Jusqu'&agrave; ce que le navigateur soit &eacute;teind". La valeur par d&eacute;faut est : 0. </para> </listitem> </varlistentry> <varlistentry id="ini.session.serialize-handler"> <term> <parameter>session.serialize_handler</parameter> <type>&string;</type> </term> <listitem> <para> D&eacute;finit le nom du gestionnaire qui est utilis&eacute; pour lin&eacute;ariser/d&eacute;lin&eacute;ariser les donn&eacute;es. Actuellement, un format interne &agrave; PHP (nomm&eacute; <literal>php</literal>) et WDDX (nomm&eacute; <literal>wddx</literal>) sont support&eacute;s . WDDX est seulement disponible, si PHP a &eacute;t&eacute; compil&eacute; avec l'option <link linkend="ref.wddx">WDDX</link>. Par d&eacute;faut, c'est <literal>php</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.session.gc-probability"> <term> <parameter>session.gc_probability</parameter> <type>&integer;</type> </term> <listitem> <para> Specifies the probability that the gc (garbage collection) routine is started on each request in percent. Defaults to <literal>1</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.session.gc-maxlifetime"> <term> <parameter>session.gc_maxlifetime</parameter> <type>&integer;</type> </term> <listitem> <para> Sp&eacute;cifie la dur&eacute;e de vie des donn&eacute;es sur le serveur, en nombre de secondes. Apr&egrave;s cette dur&eacute;e, les donn&eacute;es seront consid&eacute;r&eacute;es comme obsol&egrave;tes, et supprim&eacute;es. </para> <note> <simpara> Si vous utilisez le gestionnaire de session par fichier, qui est fourni par d&eacute;faut votre syst&egrave;me doit garder la trace des date de dernier acc&egrave;s aux fichier (atime). La FAT de Windows ne le fait pas, alors vous faudra trouver un autre syst&egrave;me pour g&eacute;rer les sessions qui ont expir&eacute;es. </simpara> </note> </listitem> </varlistentry> <varlistentry id="ini.session.referer-check"> <term> <parameter>session.referer_check</parameter> <type>&integer;</type> </term> <listitem> <para> Contient une sous-cha&icirc;ne que vous souhaitez retrouver dans tous les ent&ecirc;tes HTTP Referer. Si cet ent&ecirc;tes a &eacute;t&eacute; envoy&eacute; par le client, et que la sous-cha&icirc;ne n'a pas &eacute;t&eacute; trouv&eacute;, l'identifiant de session sera consid&eacute;r&eacute; comme invalide. Par d&eacute;faut, cette option est la cha&Icirc;ne vide. </para> </listitem> </varlistentry> <varlistentry id="ini.session.entropy-file"> <term> <parameter>session.entropy_file</parameter> <type>&string;</type> </term> <listitem> <para> Est un chemin jusqu'&agrave; une source externe (un fichier), qui sera utilis&eacute;e comme source additionnelle d'entropie pour la cr&eacute;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&egrave;mes Unix. </para> </listitem> </varlistentry> <varlistentry id="ini.session.entropy-length"> <term> <parameter>session.entropy_length</parameter> <type>&integer;</type> </term> <listitem> <para> Sp&eacute;cifie le nombre d'octets qui seront lus dans le fichier d&eacute;fini ci-dessus. Par d&eacute;faut, il vaut <literal>0</literal>, c'est &agrave; dire inactif. </para> </listitem> </varlistentry> <varlistentry id="ini.session.use-cookies"> <term> <parameter>session.use_cookies</parameter> <type>&integer;</type> </term> <listitem> <para> Sp&eacute;cifie si le module utilisera les cookies pour stocker les donn&eacute;es de session sur le client. Par d&eacute;faut, il vaut <literal>1</literal>, c'est &agrave; dire actif. </para> </listitem> </varlistentry> <varlistentry id="ini.session.use-only-cookies"> <term> <parameter>session.use_only_cookies</parameter> <type>&integer;</type> </term> <listitem> <para> Sp&eacute;cifie si le module doit utiliser <emphasis role="strong">seulement</emphasis> les cookies pour stocker les identifiants de sessions du cot&eacute; du navigateur. Par d&eacute;faut, cette option vaut <literal>0</literal> (inactif, pour compatibilit&eacute; ascendante). En l'activant, vous &eacute;viterez les attaques qui utilisent des identifiants de sessions dans les URL. Cette configuration a &eacute;t&eacute; ajout&eacute;e en PHP 4.3.0. </para> </listitem> </varlistentry> <varlistentry id="ini.session.cookie-path"> <term> <parameter>session.cookie_path</parameter> <type>&string;</type> </term> <listitem> <para> Sp&eacute;cifie le chemin utilis&eacute; lors de la cr&eacute;ation du cookie. Par d&eacute;faut, il vaut <literal>/</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.session.cookie-domain"> <term> <parameter>session.cookie_domain</parameter> <type>&string;</type> </term> <listitem> <para> Sp&eacute;cifie le domaine utilis&eacute; lors de la cr&eacute;ation du cookie. Par d&eacute;faut, il ne vaut rien. </para> </listitem> </varlistentry> <varlistentry id="ini.session.cookie-secure"> <term> <parameter>session.cookie_secure</parameter> <type>&boolean;</type> </term> <listitem> <simpara> Sp&eacute;cifie que les cookies ne doivent &ecirc;tre &eacute;mis que sur des connexion s&eacute;curis&eacute;e. Par d&eacute;faut, cette option est &agrave; <literal>off</literal>. Cette option a &eacute;t&eacute; ajout&eacute;e en &php; 4.0.4. Voir aussi <function>session_get_cookie_params</function> et <function>session_set_cookie_params</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.cache-limiter"> <term> <parameter>session.cache_limiter</parameter> <type>&string;</type> </term> <listitem> <para> Sp&eacute;cifie le type de contr&ocirc;le de cache utilis&eacute; pour les pages avec sessions. Les valeurs possibles sont : none, nocache, private, private_no_expire, public. Par d&eacute;faut, il vaut <literal>nocache</literal>. </para> </listitem> </varlistentry> <varlistentry id="ini.session.cache-expire"> <term> <parameter>session.cache_expire</parameter> <type>&integer;</type> </term> <listitem> <para> Sp&eacute;cifie la dur&eacute;e de vie des donn&eacute;es de sessions, en minute. Cette option n'a aucune cons&eacute;quence sur le contr&ocirc;le de cache. Par d&eacute;faut, il vaut <literal>180</literal> (3 heures). </para> </listitem> </varlistentry> <varlistentry id="ini.session.use-trans-sid"> <term> <parameter>session.use_trans_sid</parameter> <type>&integer;</type> </term> <listitem> <note> <simpara> En PHP 4.1.2 ou plus ancient, cette option est activ&eacute;e en utilisant l'option de compilation <link linkend="install.configure.enable-trans-sid"> <literal>--enable-trans-sid</literal></link>. Depuis PHP 4.2.0, trans-sid est toujours compil&eacute;e. </simpara> <simpara> Le syst&egrave;me de gestion des sessions par URL pose un risque suppl&eacute;mentaire de s&eacute;curit&eacute; : un utilisateur peut envoyer son URL avec l'identifiant de session par email &agrave; un ami, ou bien le mettre dans ses signets. Cela diffusera alors l'identifiant de session. </simpara> </note> </listitem> </varlistentry> <varlistentry id="ini.url-rewriter.tags"> <term> <parameter>session.url_rewriter.tags</parameter> <type>&string;</type> </term> <listitem> <simpara> Sp&eacute;cifie quels sont les balises HTML qui doivent &ecirc;tre r&eacute;&eacute;crites si le support transparent du SID est activ&eacute;. Par d&eacute;faut, il vaut <literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal>. </simpara> </listitem> </varlistentry> </variablelist> </para> <para> Les options <link linkend="ini.track-vars"><literal>track_vars</literal></link> et <link linkend="ini.register-globals"><literal>register_globals</literal></link> influencent le comportement des sessions, leur stockage et leur restauration. </para> <note> <para> Depuis PHP 4.0.3, <link linkend="ini.track-vars"><literal>track_vars</literal></link> est toujours activ&eacute;. </para> </note> </section> <!-- 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 -->
« previous php.doc.fr (#165) next »