1
0
mirror of https://github.com/php/doc-fr.git synced 2026-04-28 01:03:22 +02:00
Files
archived-doc-fr/reference/session/functions/session-id.xml
T
George Peter Banyard 8352d7257a Apply SVN revision 351750
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@351765 c90b9560-bf6c-de11-be94-00142212c4b1
2020-11-30 02:08:48 +00:00

126 lines
4.0 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 151e61773c016edcae8fd4989ad9a86ffd03c283 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.session-id" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>session_id</refname>
<refpurpose>Lit et/ou modifie l'identifiant courant de session</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>string</type><type>false</type></type><methodname>session_id</methodname>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>id</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>session_id</function> est utilisé pour récupérer ou définir
l'identifiant de session pour la session courante.
</para>
<para>
La constante <constant>SID</constant> peut également être utilisée pour
lire le nom de la session courante et l'identifiant de session à fournir
dans les URL. Voyez aussi <link linkend="ref.session">Gestion de session</link>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>id</parameter></term>
<listitem>
<para>
Si <parameter>id</parameter> est fourni et non &null;, il remplacera l'identifiant
courant de session. <function>session_id</function> doit alors être
appelé avant <function>session_start</function>. Suivant le gestionnaire
de sessions que vous utilisez, tous les caractères ne seront pas acceptés
dans cette valeur. Par exemple, le gestionnaire de sessions par défaut,
basé sur les fichiers, n'accepte que les caractères compris
dans l'intervalle <literal>a-z, A-Z et 0-9 , (virgule) et - (moins)</literal>!
</para>
<note>
<simpara>
Lorsque vous utilisez les sessions avec les cookies, le fait de spécifier un
<parameter>id</parameter> pour <function>session_id</function>
fera qu'un nouveau cookie sera toujours envoyé lors de l'appel à
<function>session_start</function>, sans se soucier si l'identifiant de session
courant est identique à celui qui vient d'être défini.
</simpara>
</note>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<function>session_id</function> retourne l'identifiant de session pour la session
courante ou une chaîne vide (<literal>""</literal>) s'il n'y a pas de session
courante (aucun identifiant de session n'existe).
En cas d'échec, &false; est retourné.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>id</parameter> est désormais nullable.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>session_regenerate_id</function></member>
<member><function>session_start</function></member>
<member><function>session_set_save_handler</function></member>
<member>
<link linkend="ini.session.save-handler">session.save_handler</link>
</member>
</simplelist>
</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:"~/.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
-->