leszek Sat Dec 22 12:19:30 2001 EDT
Modified files:
/phpdoc/pl Translators
/phpdoc/pl/chapters install.xml
/phpdoc/pl/functions session.xml
Log:
Updated session.xml to 1.70 and install.xml to 1.96
Index: phpdoc/pl/Translators
diff -u phpdoc/pl/Translators:1.23 phpdoc/pl/Translators:1.24
--- phpdoc/pl/Translators:1.23 Thu Dec 20 07:37:10 2001
+++ phpdoc/pl/Translators Sat Dec 22 12:19:29 2001
@@ -30,7 +30,7 @@
resources.xml
------- chapters ----------------------------------------------------------
config.xml Leon done 1.31
-install.xml Leon done 1.94
+install.xml Leon done 1.96
intro.xml Leon done 1.24
security.xml
------- faq ---------------------------------------------------------------
@@ -137,7 +137,7 @@
satellite.xml
sem.xml
sesam.xml
-session.xml leon done 1.55
+session.xml leon done 1.70
shmop.xml
snmp.xml
sockets.xml
Index: phpdoc/pl/chapters/install.xml
diff -u phpdoc/pl/chapters/install.xml:1.9 phpdoc/pl/chapters/install.xml:1.10
--- phpdoc/pl/chapters/install.xml:1.9 Thu Dec 20 07:38:39 2001
+++ phpdoc/pl/chapters/install.xml Sat Dec 22 12:19:29 2001
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.94 Maintainer: leon Status: ready -->
-<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.96 Maintainer: leon Status: ready -->
+<!-- $Revision: 1.10 $ -->
<chapter id="installation">
<title>Instalacja</title>
<sect1 id="install.general">
@@ -169,7 +169,7 @@
<title>
Instrukcja szubkiej instalacji PHP 4 (jako modu� Apache'a)
</title>
- <programlisting>
+ <programlisting role="shell">
<![CDATA[
1. gunzip apache_1.3.x.tar.gz
2. tar xvf apache_1.3.x.tar
@@ -3259,7 +3259,7 @@
<listitem>
<para>
Zdekompresuj plik dystrybucyjny do dowolnego katalogu, np.
- <filename>C:\php\</filename>.
+ <filename>c:\php\</filename>.
</para>
</listitem>
<listitem>
@@ -5181,6 +5181,7 @@
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
Index: phpdoc/pl/functions/session.xml
diff -u phpdoc/pl/functions/session.xml:1.7 phpdoc/pl/functions/session.xml:1.8
--- phpdoc/pl/functions/session.xml:1.7 Fri Dec 21 18:08:47 2001
+++ phpdoc/pl/functions/session.xml Sat Dec 22 12:19:30 2001
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.55 Maintainer: leon Status: ready -->
-<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.70 Maintainer: leon Status: ready -->
+<!-- $Revision: 1.8 $ -->
<reference id="ref.session">
<title>Funkje obs�ugi sesji</title>
<titleabbrev>Sesje</titleabbrev>
@@ -149,7 +149,7 @@
$count++;
?>
-Witaj go�ciu. Ogl�dasz t� stron� <?php echo $count; ?> raz.<p>
+Witaj go�ciu. Ogl�dasz t� stron� <?php echo $count; ?> raz.<p>
<?php
# <?=SID?> jest konieczne do zachowania identyfikatora sesji je�li
@@ -356,13 +356,21 @@
<simpara>
<function>session_start</function> tworzy sesj� (lub odtwarza bie��c�
w oparciu o identyfikator sesji przekazywany przez zmienne GET lub
- ciasteczko).</simpara>
+ ciasteczko).
+ </simpara>
+ <simpara>
+ Je�li chcesz, aby sesja by�a nazwana, przed wywo�aniem
+ <function>session_start</function> musisz wywo�a�
+ <function>session_name</function>.
+ </simpara>
<simpara>
Ta funkcja zawsze zwraca warot�� &true;.
</simpara>
<note>
<para>
- Ta funkcja zosta�a dodana w PHP 4.0.
+ Je�li u�ywasz sesji opartych o ciasteczka, to
+ <function>session_start</function> musi by� wywo�ane przed wys�aniem
+ jakichkolwiek danych do przegl�darki.
</para>
</note>
</refsect1>
@@ -383,12 +391,33 @@
</funcsynopsis>
<simpara>
<function>session_destroy</function> niszczy wszystkie dane skojarzone z
- bie��c� sesj�.
+ bie��c� sesj�. Nie usuwa �adnych globalnych zmiennych zwi�zanych z sesj�.
+ Nie usuwa te� ciasteczka sesyjnego.
</simpara>
<simpara>
Funkcja ta zawraca &true; w przypadku sukcesu w niszczeniu danych sesji.
W przeciwnym przypadku zwracana jest warto�� &false;.
</simpara>
+ <para>
+ <example>
+ <title>Niszczenie sesji</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+# Inicjalizuj sesj�
+# Je�li u�ywasz sesion_name("co�tam"), nie zapomnij o tym teraz!
+session_start();
+# Usu� wszystkie zmienne sesyjne
+session_unset();
+# Na koniec, zniszcz sesj�
+session_destroy();
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
</refsect1>
</refentry>
@@ -437,11 +466,6 @@
]]>
</programlisting>
</example>
- <note>
- <para>
- Funkcja ta zosta�a dodana w PHP 4.0.
- </para>
- </note>
</refsect1>
</refentry>
@@ -464,11 +488,6 @@
<function>session_module_name</function> zwraca nazw� bie��cego modu�u
sesji. Je�li podany zosta� parametr <parameter>modu�</parameter>, u�yty
zostanie nowo podany modu�.
- <note>
- <para>
- Ta funkcja zosta�a dodana w PHP 4.0.
- </para>
- </note>
</para>
</refsect1>
</refentry>
@@ -501,11 +520,6 @@
ni� ext2fs.
</para>
</note>
- <note>
- <para>
- Ta funkcja zosta�a dodana w PHP 4.0.
- </para>
- </note>
</para>
</refsect1>
</refentry>
@@ -560,9 +574,39 @@
ka�dej napotkanej nazwy zmiennej, <function>session_register</function>
rejestruje w bie��cej sesji globaln� zmienn� o danej nazwie.
</para>
+ <caution>
+ <para>
+ Funkcja ta rejestruje <emphasis>globaln�</emphasis> zmienn�. Je�li
+ chcesz zarejestrowa� zmienn� w sesji z wn�trza funkcji, musisz si�
+ upewni� �e jest ona globalna prez u�ycie <function>global</function> lub
+ u�ywaj�c tablic sesyjnych, tak jak to opisano poni�ej.
+ </para>
+ </caution>
<para>
- Funkcja ta zwraca warto�� &true; je�li zmienna zosta�a pomy�lnie
- zarejestrowana w sesji.
+ Funkcja ta zwraca warto�� &true; je�li wszystkie zmienne zosta�y
+ pomy�lnie zarejestrowane w sesji.
+ </para>
+ <para>
+ Je�li przed wywo�aniem tej funkcji nie wywo�ano
+ <function>session_start</function>, dokonane zostanie niejawne wywo�anie
+ <function>session_start</function> bez �adnych parametr�w.
+ </para>
+ <para>
+ Mo�esz tworzy� zmienne sesyjne poprostu przez dopisywanie odpowiednicz
+ wpis�w do tablic $HTTP_SESSION_VARS lub $_SESSION (PHP >= 4.1.0).
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+$barney = "Du�y fioletowy dinozaur.";
+session_register("barney");
+
+$HTTP_SESSION_VARS["zim"] = "Naje�d�ca z innej planety.";
+
+# tablica $_SESSION typu auto-global zosta�a wprowadzona w PHP 4.1.0
+#_SESSION["spongebob"] = "Ma kwadratowe spodnie.";
+]]>
+ </programlisting>
+ </informalexample>
</para>
<note>
<para>
@@ -576,11 +620,10 @@
<link linkend="resource">typy zasob�w</link>.
</para>
</note>
- <note>
- <para>
- Funkcja ta zosta�a dodana w PHP 4.0.
- </para>
- </note>
+ <para>
+ Patrz tak�e <function>session_is_registered</function> i
+ <function>session_unregister</function>.
+ </para>
</refsect1>
</refentry>
@@ -606,12 +649,15 @@
<para>
Funkcja ta zwraca warto�� &true; je�li zmienna zosta�a pomy�lnie
wyrejestrowana z sesji.
- <note>
- <para>
- Funkcja ta zosta�a dodana w PHP 4.0.
- </para>
- </note>
</para>
+ <caution>
+ <para>
+ Ta funkcja nie usuwa zmiennej globalnej o nazwie
+ <parameter>nazwa</parameter>, a jedynie zapobiega zapisaniu tej zmiennej
+ jako cz�ci sesji. Je�li chcesz usun�� odpowiedni� zmienn� globaln�,
+ musisz u�y� funkcji <function>unset</function>.
+ </para>
+ </caution>
</refsect1>
</refentry>
@@ -656,11 +702,6 @@
<function>session_is_registered</function> zwraca warto�� &true; je�li w
bie��cej sesji zarejestrowana jest zmienna o nazwie
<parameter>nazwa</parameter>.
- <note>
- <para>
- Funkcja ta zosta�a dodana w PHP 4.0.
- </para>
- </note>
</para>
</refsect1>
</refentry>
@@ -702,6 +743,12 @@
"domain" - Domena ciasteczka.
</simpara>
</listitem>
+ <listitem>
+ <simpara>
+ "secure" - Ciasteczko powinno by� przes�ane tylko przez bezpieczne
+ po��czenie. (Ten element zosta� dodany w PHP 4.0.4.)
+ </simpara>
+ </listitem>
</itemizedlist>
</para>
</refsect1>
@@ -754,11 +801,6 @@
<function>session_decode</function> dekofuje dane sesji zawarte w
parametrze <parameter>dane</parameter>, ustawiaj�c zmienne zachowane w
sesji.
- <note>
- <para>
- Ta funkcja zosta�a dodana w PHP 4.0.
- </para>
- </note>
</para>
</refsect1>
</refentry>
@@ -781,11 +823,6 @@
<para>
<function>session_encode</function> zwraca string zawieraj�cy zakodowane
dane bie��cej sesji.
- <note>
- <para>
- Ta funkcja zosta�a dodana w PHP 4.0.
- </para>
- </note>
</para>
</refsect1>
</refentry>
@@ -987,11 +1024,29 @@
]]>
</programlisting>
</example>
- <note>
- <para>
- Funkcja ta zosta�a dodana w PHP 4.0.3.
- </para>
- </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id='function.session-cache-expire'>
+ <refnamediv>
+ <refname>session_cache_expire</refname>
+ <refpurpose>Zwr�� bie��cy czas przedawnienia pami�ci podr�cznej</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Opis</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>session_cache_expire</function></funcdef>
+ <paramdef>int
+ <parameter><optional>nowy_czas</optional></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>session_cache_expire</function> zwraca aktualny czas
+ przedawnienia pami�ci podr�cznej. Je�li podany zostanie
+ <parameter>nowy_czas</parameter>, to bie��cy czas zostanie
+ zast�piony przez ten podany w parametrze.
+ </para>
</refsect1>
</refentry>
