cvs: phpdoc-pl /reference/session/functions session-start.xml
| From: | Leszek Krupinski | Date: | Thu, 10 Feb 2005 15:09:48 +0000 |
| Subject: | cvs: phpdoc-pl /reference/session/functions session-start.xml | ||
| Groups: | php.doc.pl | ||
| Request: | Send a blank email to doc-pl+get-418@lists.php.net to get a copy of this message | ||
leszek Thu Feb 10 10:09:48 2005 EDT
Modified files:
/phpdoc-pl/reference/session/functions session-start.xml
Log:
[leszek] - updated to 1.5
http://cvs.php.net/diff.php/phpdoc-pl/reference/session/functions/session-start.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc-pl/reference/session/functions/session-start.xml
diff -u phpdoc-pl/reference/session/functions/session-start.xml:1.3
phpdoc-pl/reference/session/functions/session-start.xml:1.4
--- phpdoc-pl/reference/session/functions/session-start.xml:1.3 Mon May 13 17:09:59 2002
+++ phpdoc-pl/reference/session/functions/session-start.xml Thu Feb 10 10:09:48 2005
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.2 Maintainer: leszek Status: ready -->
-<!-- $Revision: 1.3 $ -->
+<!-- EN-Revision: 1.5 Maintainer: leszek Status: ready -->
+<!-- $Revision: 1.4 $ -->
<refentry id="function.session-start">
<refnamediv>
<refname>session_start</refname>
@@ -13,9 +13,9 @@
<void/>
</methodsynopsis>
<simpara>
- <function>session_start</function> tworzy sesjê (lub odtwarza bie¿±c±
- w oparciu o identyfikator sesji przekazywany przez zmienne GET lub
- ciasteczko).
+ <function>session_start</function> tworzy sesjê lub wznawia bie¿±c± na
+ podstawie aktualnego identyfikatora sesji przekazanego przy wywo³aniu,
+ poprzez metodê GET, POST lub ciasteczko.
</simpara>
<simpara>
Je¶li chcesz, aby sesja by³a nazwana, przed wywo³aniem
@@ -23,7 +23,7 @@
<function>session_name</function>.
</simpara>
<simpara>
- Ta funkcja zawsze zwraca warot¶æ &true;.
+ Ta funkcja zawsze zwraca warto¶æ &true;.
</simpara>
<note>
<para>
@@ -32,6 +32,68 @@
jakichkolwiek danych do przegl±darki.
</para>
</note>
+ <para>
+ <example>
+ <title>Przyk³ad sesji: <filename>page1.php</filename></title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// page1.php
+
+session_start();
+
+echo 'Witaj na stronie #1';
+
+$_SESSION['kolor'] = 'zielony';
+$_SESSION['zwierze'] = 'kot';
+$_SESSION['czas'] = time();
+
+// Dzia³a je¶li ciasteczko sesyjne zosta³o zaakceptowane
+echo '<br /><a href="page2.php">strona 2</a>';
+
+// Lub mo¿e przeka¿ ciasteczko sesyjne, je¶li to konieczne
+echo '<br /><a href="page2.php?' . SID . '">strona
2</a>';
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Po odwiedzeniu strony <filename>page1.php</filename>, druga strona,
+ <filename>page2.php</filename> bêdzie magicznie zawiera³a dane sesji. W
+ rozdziale <link linkend="ref.session">Sesje</link> znajduje siê wiêcej
+ informacji na temat <link linkend="session.idpassing">propagowania
+ identyfikatora sesji</link>, gdzie mo¿na znale¼æ na przyk³ad
+ wyt³umaczenie co zawiera sta³a <constant>SID</constant>.
+ </para>
+ <para>
+ <example>
+ <title>Przyk³ad sesji: <filename>page2.php</filename></title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// page2.php
+
+session_start();
+
+echo 'Witaj na stronie #2<br />';
+
+echo $_SESSION['kolor']; // zielony
+echo $_SESSION['zwierze']; // not
+echo date('Y m d H:i:s', $_SESSION['time']);
+
+// Tu mo¿na wstawiæ SID, podobnie jak to by³ na page1.php
+echo '<br /><a href="page1.php">page 1</a>';
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <simpara>
+ W celu stworzenia nazwanej sesji, niezbêdne jest wywo³anie funkcji
+ <function>session_name</function> przed wywo³aniem
+ <function>session_start</function>.
+ </simpara>
<simpara>
<function>session_start</function> zarejestruje wewnêtrzny uchwyt obs³ugi
wyj¶cia dla przepisywania URLi je¶li w³±czona jest opcja
@@ -43,10 +105,25 @@
</simpara>
<note>
<simpara>
- Wskazane jest u¿ycie <literal>zlib.output_compression</literal> zamiast
- <literal>ob_gzhandler</literal>
+ Wskazane jest u¿ycie
+ <link
linkend="ini.zlib.output-compression">zlib.output_compression</link>
+ zamiast <literal>ob_gzhandler</literal>
</simpara>
</note>
+ <note>
+ <para>
+ Od PHP 4.3.3, wywo³anie <function>session_start</function> podczas gdy
+ sesja ju¿ zosta³a rozpoczêta, spowoduje b³±d poziomu
+ <constant>E_NOTICE</constant>. Drugie rozpoczêcie sesji zostanie
+ zignorowane.
+ </para>
+ </note>
+ <para>
+ Patrz tak¿e:
+ <link linkend="reserved.variables.session">$_SESSION</link>,
+ <link linkend="ini.session.auto-start">session.auto_start</link> i
+ <function>session_id</function>.
+ </para>
</refsect1>
</refentry>