1
0
mirror of https://github.com/php/doc-pl.git synced 2026-04-24 23:38:13 +02:00
Files
2024-10-25 01:43:38 +01:00

122 lines
3.9 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f5c124befdf7c2791877694a86ead123b179d935 Maintainer: leszek Status: ready -->
<refentry xml:id="function.session-id" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>session_id</refname>
<refpurpose>Pobiera i/lub ustawia identyfikator bieżącej sesji</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> jest używana aby pobrać identyfikatora
dla bieżącej sesji.
</para>
<para>
Do pobrania nazwy i identyfikatora bieżącej sesji może być użyta także
stała <systemitem>SID</systemitem>, która zawiera string odpowiedni do
dodawania go do URLi. Przeczytaj także rozdział <link
linkend="ref.session">Obsługa sesji</link>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>id</parameter></term>
<listitem>
<para>
Jeśli podany został parametr <parameter>id</parameter>, zostanie
on użyty do zmiany identyfikatora bieżącej sesji. Przy takim użyciu
<function>session_id</function> musi być wywołane przed
<function>session_start</function>. Zależnie od funkcji obsługi sesji,
nie wszystkie znaki są dozwolone wewnątrz identyfikatora sesji. Na
przykład, funkcje obsługi sesji oparte na plikach pozwalają tylko na
znaki z przedziału <literal>[a-zA-Z0-9,-]</literal>!
</para>
<note>
<simpara>
Używając ciasteczek sesyjnych, podanie parametru <parameter>id</parameter>
funkcji <function>session_id</function> spowoduje wysłanie nowego ciasteczka przy wywołaniu
funkcji <function>session_start</function>, niezależnie od tego,
czy bieżący identyfikator sesji jest identyczny z tym, który ma być ustawiony.
</simpara>
</note>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<function>session_id</function> zwraca identyfikator bieżącej
sesji lub pusty ciąg znaków (<literal>""</literal>), jeśli nie ma bieżącej
sesji (nie istnieje bieżący identyfikator sesji).
W wypadku niepowodzenia zwracany jest &false;.
</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>
Parametr <parameter>id</parameter> dopuszcza teraz &null;.
</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
-->