mirror of
https://github.com/php/doc-fr.git
synced 2026-03-24 07:02:06 +01:00
116 lines
4.3 KiB
XML
116 lines
4.3 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: ba6a83ca3558574695be5ef0a0e008e4e5f78ddb Maintainer: yannick Status: ready -->
|
|
<!-- Reviewed: yes -->
|
|
|
|
<book xml:id="book.session" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
|
<?phpdoc extension-membership="bundled" ?>
|
|
<title>Gestion des sessions</title>
|
|
<titleabbrev>Sessions</titleabbrev>
|
|
|
|
<!-- {{{ preface -->
|
|
<preface xml:id="intro.session">
|
|
&reftitle.intro;
|
|
<para>
|
|
Le support des sessions de PHP est un moyen de préserver
|
|
des données entre plusieurs accès.
|
|
</para>
|
|
<para>
|
|
Chaque visiteur accédant à la page web se voit assigner 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 permet de stocker des données
|
|
entre les requêtes dans le tableau superglobal <varname>$_SESSION</varname>.
|
|
Lorsqu'un visiteur accède au site, PHP va vérifier automatiquement (si
|
|
<link linkend="ini.session.auto-start"><option>session.auto_start
|
|
</option></link> est activé) ou sur demande (explicitement avec
|
|
<function>session_start</function>) s'il existe une
|
|
session du même nom. Si c'est le cas, l'environnement
|
|
précédemment sauvé sera recréé.
|
|
</para>
|
|
<caution>
|
|
<para>
|
|
Si l'on active <link linkend="ini.session.auto-start">
|
|
session.auto_start</link> alors le seul moyen de mettre des objets
|
|
en session est de charger les définitions de classe avec
|
|
<link linkend="ini.auto-prepend-file">auto_prepend_file</link>
|
|
dans lequel on charge les définitions dont on a besoin,
|
|
ou bien il faudra utiliser <function>serialize</function>
|
|
sur l'objet, et <function>unserialize</function>
|
|
pour le récupérer.
|
|
</para>
|
|
</caution>
|
|
<para>
|
|
La variable <varname>$_SESSION</varname> (et toutes les variables
|
|
enregistrées) sont sérialisées en interne par PHP en utilisant le
|
|
gestionnaire de sérialisation spécifié par l'option de configuration
|
|
<link linkend="ini.session.serialize-handler">session.serialize_handler</link>,
|
|
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>
|
|
<warning>
|
|
<para>
|
|
En raison du fait que les données de session sont sérialisées,
|
|
les variables de type <type>resource</type> ne peuvent être stockées
|
|
dans une session.
|
|
</para>
|
|
<para>
|
|
Les gestionnaires de sérialisation (<literal>php</literal>
|
|
et <literal>php_binary</literal>) héritent des limitations de
|
|
register_globals. Aussi, les index numériques ou les index
|
|
sous forme de chaînes de caractères contenant des caractères
|
|
spéciaux (<literal>|</literal> et <literal>!</literal>) ne
|
|
peuvent pas être utilisés. Le fait de les utiliser génèrera des
|
|
erreurs en fin de script. <literal>php_serialize</literal>
|
|
n'a pas ce genre de limitations.
|
|
</para>
|
|
</warning>
|
|
<note>
|
|
<para>
|
|
Il est à noter que lorsque l'on travaille avec les sessions, un enregistrement
|
|
dans la session ne sera pas créé tant que la variable ne sera pas
|
|
enregistrée en ajoutant une clé à la variable super-globale
|
|
<varname>$_SESSION</varname>. Cela n'est vrai que si l'on a débuté une
|
|
session en appelant la fonction <function>session_start</function>.
|
|
</para>
|
|
</note>
|
|
</preface>
|
|
<!-- }}} -->
|
|
|
|
&reference.session.setup;
|
|
&reference.session.constants;
|
|
&reference.session.examples;
|
|
&reference.session.upload-progress;
|
|
&reference.session.security;
|
|
&reference.session.reference;
|
|
&reference.session.sessionhandler;
|
|
&reference.session.sessionhandlerinterface;
|
|
&reference.session.sessionidinterface;
|
|
&reference.session.sessionupdatetimestamphandlerinterface;
|
|
|
|
</book>
|
|
|
|
<!-- 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:"~/.phpdoc/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
|
|
-->
|