leszek Sat Nov 3 19:03:13 2001 EDT
Modified files:
/phpdoc/pl/functions session.xml
Log:
Finished translation
Index: phpdoc/pl/functions/session.xml
diff -u phpdoc/pl/functions/session.xml:1.1 phpdoc/pl/functions/session.xml:1.2
--- phpdoc/pl/functions/session.xml:1.1 Tue Oct 30 07:31:32 2001
+++ phpdoc/pl/functions/session.xml Sat Nov 3 19:03:13 2001
@@ -1,5 +1,5 @@
<?xml encoding="iso-8859-2"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<reference id="ref.session">
<title>Funkje obs�ugi sesji</title>
<titleabbrev>Sesje</titleabbrev>
@@ -123,210 +123,211 @@
URL'i.
</para>
<para>
- PHP is capable of doing this transparently when compiled with
+ PHP mo�e to robi� 'przezroczy�cie' je�li zosta� skompilowany z opcj�
<link linkend="install.configure.enable-trans-sid">
- <literal>--enable-trans-sid</literal></link>. If you enable this option,
- relative URIs will be changed to contain the session id
- automatically. Alternatively, you can use the constant
- <literal>SID</literal> which is defined, if the client did not
- send the appropriate cookie. <literal>SID</literal> is either of
- the form <literal>session_name=session_id</literal> or is an empty
- string.
+ <literal>--enable-trans-sid</literal></link>. Je�li w��czysz t� opcj�,
+ wzgl�dne URI zostan� automatycznie podmienione tak, aby zawiera�y
+ identyfikator sesji. Mo�esz tak�e u�y� sta�ej <literal>SID</literal> kt�ra
+ jest definiowana je�li klient nie wys�a� odpowiedniego ciastka. <literal>
+ SID</literal> jest albo w postaci <literal>nazwa_sesji=id_sesji</literal>
+ lub pustym stringiem.
</para>
<para>
- The following example demonstrates how to register a variable, and
- how to link correctly to another page using SID.
+ Poni�szy przyk�ad demonstruje jak zarejestrowa� zmienn� i jak prawid�owo
+ wstawi� link do kolejnej strony korzystaj�c ze sta�ej SID.
<example>
- <title>Counting the number of hits of a single user</title>
+ <title>Zliczanie ilo�ci odwiedzin pojedy�czego u�ytkownika</title>
<programlisting role="php">
<?php
session_register ("count");
$count++;
?>
-Hello visitor, you have seen this page <?php echo $count; ?> times.<p>
+Witaj go�ciu. Ogl�dasz t� stron� <?php echo $count; ?> raz.<p>
<php?
-# the <?=SID?> is necessary to preserve the session id
-# in the case that the user has disabled cookies
+# <?=SID?> jest konieczne do zachowania identyfikatora sesji je�li
+# u�ytkownik wy��czy� ciastka
?>
-To continue, <A HREF="nextpage.php?<?=SID?>">click here</A>
+Aby kontynuowa�, <A HREF="nextpage.php?<?=SID?>">kliknij tutaj</A>
</programlisting>
</example>
</para>
<para>
- The <literal><?=SID?></literal> is not necessary, if
+ <literal><?=SID?></literal> nie jest konieczne je�li przy kompilacji
+ PHP u�yta zosta�a opcja
<link linkend="install.configure.enable-trans-sid">
- <literal>--enable-trans-sid</literal></link> was used to compile PHP.
+ <literal>--enable-trans-sid</literal></link>.
</para>
<note>
<para>
- Non-relative URLs are assumed to point to external sites and
- hence don't append the SID, as it would be a security risk to
- leak the SID to a different server.
+ PHP zak�ada, �e bezwzgl�dne URLe odnosz� si� do zewn�trznych serwis�w,
+ wi�c nie trzeba przekazywa� SID, poniewa� istnia�oby niebezpiecze�stwo
+ podkradania SID�w przez inny serwer.
</para>
</note>
<para>
- To implement database storage, or any other storage method, you
- will need to use <function>session_set_save_handler</function> to
- create a set of user-level storage functions.
+ Aby zaimplementowa� przechowywanie danych sesyjnych w bazie danych lub w
+ dowolnej innej postaci, musisz u�y�
+ <function>session_set_save_handler</function> do stworzenia zestawu
+ funkcji przechowuj�cych dane.
</para>
<para>
- The session management system supports a number of configuration
- options which you can place in your php.ini file. We will give a
- short overview.
+ System zarz�dzania sesj� obs�uguje wiele opcji konfiguracyjnych, kt�re
+ mo�esz wstawi� do swojego pliku php.ini. Oto ich kr�tki przegl�d.
<itemizedlist>
<listitem>
<simpara>
- <literal>session.save_handler</literal> defines the name of the
- handler which is used for storing and retrieving data
- associated with a session. Defaults to
- <literal>files</literal>.
+ <literal>session.save_handler</literal> definiuje nazw� procedury
+ obs�ugi, kt�ra jest u�ywana do przechowywania i odczytu danych
+ skojarzonych z sesj�. Domy�lnie <literal>files</literal>.
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.save_path</literal> defines the argument which
- is passed to the save handler. If you choose the default files
- handler, this is the path where the files are created.
- Defaults to <literal>/tmp</literal>.
+ <literal>session.save_path</literal> definiuje argument, kt�ry jest
+ przekazywany procedurze obs�ugi zapisu danych. Je�li wybierzesz
+ domy�ln� procedur� obs�ugi, jest to �cie�ka gdzie tworzone b�d� pliki z
+ danymi. Domy�lnie <literal>/tmp</literal>.
</simpara>
<warning>
<para>
- If you leave this set to a world-readable directory, such as
- <filename>/tmp</filename> (the default), other users on the
- server may be able to hijack sessions by getting the list of
- files in that directory.
+ Je�li w tej opcji ustawisz katalog, kt�ry jest og�lnie dost�pny, jak
+ na przyk�ad <filename>/tmp</filename> (domy�lna warto��), inni
+ u�ytkownicy serwera b�d� w stanie przechwyci� sesj� przez pobranie
+ listy plik�w z tego katalogu.
</para>
</warning>
</listitem>
<listitem>
<simpara>
- <literal>session.name</literal> specifies the name of the
- session which is used as cookie name. It should only contain
- alphanumeric characters. Defaults to
- <literal>PHPSESSID</literal>.
+ <literal>session.name</literal> okre�la nazw� sesji, kt�ra jest u�ywana
+ jako nazwa ciastka. Powinna zawiera� tylko znaki alfanumeryczne.
+ Domy�lnie <literal>PHPSESSID</literal>.
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.auto_start</literal> specifies whether the
- session module starts a session automatically on request
- startup. Defaults to <literal>0</literal> (disabled).
+ <literal>session.auto_start</literal> okre�la, czy modu� sesji
+ rozpoczyna sesj� na pocz�tku wywo�ania. Domy�lnie
+ <literal>0</literal> (wy��czony).
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.cookie_lifetime</literal> specifies the lifetime of
- the cookie in seconds which is sent to the browser. The value 0
- means "until the browser is closed." Defaults to
+ <literal>session.cookie_lifetime</literal> okre�la d�ugo�� �ycia w
+ sekundach ciastka przesy�anego do przegl�darki. Warto�� 0 oznacza
+ "dop�ki przegl�darka nie zosta�a zamkni�ta". Domy�lnie
<literal>0</literal>.
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.serialize_handler</literal> defines the name
- of the handler which is used to serialize/deserialize
- data. Currently, a PHP internal format (name
- <literal>php</literal>) and WDDX is supported (name
- <literal>wddx</literal>). WDDX is only available, if PHP is
- compiled with <link linkend="ref.wddx">WDDX
- support</link>. Defaults to <literal>php</literal>.
+ <literal>session.serialize_handler</literal> okre�la nazw� procedury
+ obs�ugi, kt�ra zostanie u�yta do serializacji/odserializacji danych.
+ Obecnie obs�ugiwany jest wewn�trzny format PHP (nazwa <literal>php
+ </literal> i WDDX (nazwa <literal>wddx</literal>). WDDX jest jedynym
+ dost�pnym formatem je�li PHP zosta�o skompilowane z
+ <link linkend="ref.wddx">obs�ug� WDDX</link>. Domy�lnie
+ <literal>php</literal>.
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.gc_probability</literal> specifies the
- probability that the gc (garbage collection) routine is started
- on each request in percent. Defaults to <literal>1</literal>.
+ <literal>session.gc_probability</literal> okre�la prawdopodobie�stwo w
+ procentach rozpocz�cia procedury gc (garbage collection - zbieranie
+ �mieci) przy ka�dym wywo�aniu. Domy�lnie <literal>1</literal>.
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.gc_maxlifetime</literal> specifies the number
- of seconds after which data will be seen as 'garbage' and
- cleaned up.
+ <literal>session.gc_maxlifetime</literal> okre�la ilo�� sekund, po
+ jakich dane b�d� rozpoznawane jako '�mieci' i usuwane.
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.referer_check</literal> contains the substring you
- want to check each HTTP Referer for. If the Referer was sent by the
- client and the substring was not found, the embedded session id will
- be marked as invalid. Defaults to the empty string.
+ <literal>session.referer_check</literal> zawiera podci�g, z kt�rym
+ HTTP_REFERER ma by� sprawdzany. Je�li HTTP_REFERER zosta� wys�any przez
+ klienta i nie zawiera� podanego podci�gu, identyfikator sesji podany
+ przez takiego klienta zostanie uznany za niewa�ny. Domy�lnie jest to
+ ci�g pusty.
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.entropy_file</literal> gives a path to an
- external resource (file) which will be used as an additional
- entropy source in the session id creation process. Examples are
- <literal>/dev/random</literal> or
- <literal>/dev/urandom</literal> which are available on many
- Unix systems.
+ <literal>session.entropy_file</literal> podaje �cie�k� do zewn�trznego
+ zasobu (pliku), kt�ry b�dzie u�yty jako dodatkowe �r�d�o entropii w
+ procesie tworzenia identyfikatora sesji. Przyk�ady to
+ <literal>/dev/random</literal> lub
+ <literal>/dev/urandom</literal>, kt�re s� dost�pne na wielu systemach
+ Unix.
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.entropy_length</literal> specifies the number
- of bytes which will be read from the file specified
- above. Defaults to <literal>0</literal> (disabled).
+ <literal>session.entropy_length</literal> okre�la liczb� bajt�w, kt�ra
+ b�dzie odczytana z pliku podanego powy�ej. Domy�lnie
+ <literal>0</literal> (wy��czona).
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.use_cookies</literal> specifies whether the
- module will use cookies to store the session id on the client
- side. Defaults to <literal>1</literal> (enabled).
+ <literal>session.use_cookies</literal> okre�la czy modu� b�dzie u�ywa�
+ ciasteczek do przechowywania identyfikatora sesji po stronie klienta.
+ Domy�lnie <literal>1</literal> (w��czona).
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.cookie_path</literal> specifies path to set
- in session_cookie. Defaults to <literal>/</literal>.
+ <literal>session.cookie_path</literal> okre�la �cie�k� kt�ra b�dzie
+ podana w session_cookie. Domy�lnie <literal>/</literal>.
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.cookie_domain</literal> specifies domain to
- set in session_cookie. Default is none at all.
+ <literal>session.cookie_domain</literal> okre�la domen� kt�ra ma by�
+ podana w session_cookie. Domy�lnie - pusta.
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.cache_limiter</literal> specifies cache control
- method to use for session pages (nocache/private/public).
- Defaults to <literal>nocache</literal>.
+ <literal>session.cache_limiter</literal> okre�la metod� u�ywan� do
+ przechowywania stron sesyjnych w pami�ci podr�cznej
+ (nocache/private/private_no_expire/public). Domy�lnie
+ <literal>nocache</literal>.
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.cache_expire</literal> specifies time-to-live
- for cached session pages in minutes, this has no effect for
- nocache limiter. Defaults to <literal>180</literal>.
+ <literal>session.cache_expire</literal> okre�la czas �ycia w minutach
+ stron sesyjnych zachowanych w pami�ci podr�cznej. Nie ma to efektu dla
+ metody <literal>nocache</literal>. Domy�lnie <literal>180</literal>
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>session.use_trans_sid</literal> whether transient sid support
- is enabled or not if enabled by compiling with
+ <literal>session.use_trans_sid</literal> okre�la czy b�dzie u�ywana
+ obs�uga przezroczystego przekazywania identyfikatora sesji. Opcja brana
+ pod uwag� tylko je�li PHP zosta�o skompilowane z opcj�
<link linkend="install.configure.enable-trans-sid">
<literal>--enable-trans-sid</literal></link>.
- Defaults to <literal>1</literal> (enabled).
+ Domy�lnie <literal>1</literal> (w��czona).
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>url_rewriter.tags</literal> spefifies which html tags are
- rewritten to include session id if transient sid support is enabled.
- Defaults to
<literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal>
+ <literal>url_rewriter.tags</literal> okre�la kt�re tagi HTML zostaj�
+ przepisane w celu dopisania identyfikatora sesji je�li w��czona zosta�a
+ opcja przezroczystego przekazywania identyfikatora sesji. Domy�lnie
+ <literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal>
</simpara>
</listitem>
</itemizedlist>
<note>
<para>
- Session handling was added in PHP 4.0.
+ Obs�uga sesji zosta�a dodana w PHP 4.0.
</para>
</note>
</para>
@@ -335,10 +336,10 @@
<refentry id="function.session-start">
<refnamediv>
<refname>session_start</refname>
- <refpurpose>Initialize session data</refpurpose>
+ <refpurpose>Inicjalizuj dane sesji</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>session_start</function></funcdef>
@@ -346,15 +347,15 @@
</funcprototype>
</funcsynopsis>
<simpara>
- <function>session_start</function> creates a session (or resumes
- the current one based on the session id being passed via a GET
- variable or a cookie).</simpara>
+ <function>session_start</function> tworzy sesj� (lub odtwarza bie��c�
+ w oparciu o identyfikator sesji przekazywany przez zmienne GET lub
+ ciasteczko).</simpara>
<simpara>
- This function always returns &true;.
+ Ta funkcja zawsze zwraca warot�� &true;.
</simpara>
<note>
<para>
- This function was added in PHP 4.0.
+ Ta funkcja zosta�a dodana w PHP 4.0.
</para>
</note>
</refsect1>
@@ -363,10 +364,10 @@
<refentry id="function.session-destroy">
<refnamediv>
<refname>session_destroy</refname>
- <refpurpose>Destroys all data registered to a session</refpurpose>
+ <refpurpose>Niszczy wszystkie dane zarejestrowane w sesji</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>session_destroy</function></funcdef>
@@ -374,13 +375,12 @@
</funcprototype>
</funcsynopsis>
<simpara>
- <function>session_destroy</function> destroys all of the data
- associated with the current session.
+ <function>session_destroy</function> niszczy wszystkie dane skojarzone z
+ bie��c� sesj�.
</simpara>
<simpara>
- This function returns &true; on success and
- &false; on failure to destroy
- the session data.
+ Funkcja ta zawraca &true; w przypadku sukcesu w niszczeniu danych sesji.
+ W przeciwnym przypadku zwracana jest warto�� &false;.
</simpara>
</refsect1>
</refentry>
@@ -388,49 +388,49 @@
<refentry id="function.session-name">
<refnamediv>
<refname>session_name</refname>
- <refpurpose>Get and/or set the current session name</refpurpose>
+ <refpurpose>Pobierz i/lub ustaw nazw� bie��cej sesji</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>session_name</function></funcdef>
<paramdef>string
- <parameter><optional>name</optional></parameter>
+ <parameter><optional>nazwa</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
- <function>session_name</function> returns the name of the current
- session. If <parameter>name</parameter> is specified, the name of
- the current session is changed to its value.
+ <function>session_name</function> zwraca nazw� bie��cej sesji. Je�li
+ podano parametr <parameter>name</parameter>, nazwa bie��cej sesji
+ zostanie zmieniona na t� warto��.
</para>
<para>
- The session name references the session id in cookies and
- URLs. It should contain only alphanumeric characters; it should
- be short and descriptive (i.e. for users with enabled cookie
- warnings). The session name is reset to the default value
- stored in <literal>session.name</literal> at request startup
- time. Thus, you need to call <function>session_name</function>
- for every request (and before <function>session_start</function>
- or <function>session_register</function> are called).
+ Nazwa sesji jest u�ywana w identyfikatorze sesji w ciasteczkach i URLach.
+ Powinna zawiera� tylko znaki alfanumeryczne; powinna by� kr�tka i
+ tre�ciwa (np. dla u�ytkownik�w z w��czonymi ostrze�eniami o
+ ciasteczkach). Nazwa sesji jest przywracana do domy�lnej warto�ci
+ okre�lonej w <literal>session.name</literal> na pocz�tku wywo�ania
+ strony, a wi�c musisz wywo�a� <function>session_name</function> dla
+ ka�dej strony (przed wywo�aniem w niej <function>session_start</function>
+ i <function>session_register</function>).
</para>
<example>
- <title><function>session_name</function> examples</title>
+ <title>Przyk�ady <function>session_name</function></title>
<programlisting role="php">
<?php
-# set the session name to WebsiteID
+# ustaw nazw� sesji na WebsiteID
-$previous_name = session_name ("WebsiteID");
+$poprzednia_nazwa = session_name ("WebsiteID");
-echo "The previous session name was $previous_name<p>";
+echo "Poprzedni� nazw� sesji by�o $poprzednia_nazwa<p>";
?>
</programlisting>
</example>
<note>
<para>
- This function was added in PHP 4.0.
+ Funkcja ta zosta�a dodana w PHP 4.0.
</para>
</note>
</refsect1>
@@ -439,25 +439,25 @@
<refentry id="function.session-module-name">
<refnamediv>
<refname>session_module_name</refname>
- <refpurpose>Get and/or set the current session module</refpurpose>
+ <refpurpose>Pobierz i/lub ustaw modu� bie��cej sesji</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>session_module_name</function></funcdef>
<paramdef>string
- <parameter><optional>module</optional></parameter>
+ <parameter><optional>modu�</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
- <function>session_module_name</function> returns the name of the
- current session module. If <parameter>module</parameter> is
- specified, that module will be used instead.
+ <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>
- This function was added in PHP 4.0.
+ Ta funkcja zosta�a dodana w PHP 4.0.
</para>
</note>
</para>
@@ -467,33 +467,34 @@
<refentry id="function.session-save-path">
<refnamediv>
<refname>session_save_path</refname>
- <refpurpose>Get and/or set the current session save path</refpurpose>
+ <refpurpose>Pobierz i/lub ustaw �cie�k� zapisu bie��cej sesji</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>session_save_path</function></funcdef>
<paramdef>string
- <parameter><optional>path</optional></parameter>
+ <parameter><optional>�cie�ka</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
- <function>session_save_path</function> returns the path of the current
- directory used to save session data. If <parameter>path</parameter>
- is specified, the path to which data is saved will be changed.
+ <function>session_save_path</function> zwraca �cie�k� do katalogu, kt�ry
+ aktualnie jest u�ywany do zapisu danych sesji. Je�li podany zosta�
+ parametr <parameter>�cie�ka</parameter>, zmieniona zostanie �cie�ka
+ zapisu danych.
<note>
<para>
- On some operating systems, you may want to specify a path on a
- filesystem that handles lots of small files efficiently. For
- example, on Linux, reiserfs may provide better performance than
- ext2fs.
+ Na niekt�rych systemach operacyjnych mo�esz chcia� poda� �cie�k� do
+ systemu plik�w, kt�ry lepiej obs�uguje du�e ilo�ci ma�ych plik�w. Na
+ przyk�ad na Linuksie reiserfs w takich warunkach ma lepsz� wydajno��
+ ni� ext2fs.
</para>
</note>
<note>
<para>
- This function was added in PHP 4.0.
+ Ta funkcja zosta�a dodana w PHP 4.0.
</para>
</note>
</para>
@@ -503,10 +504,10 @@
<refentry id="function.session-id">
<refnamediv>
<refname>session_id</refname>
- <refpurpose>Get and/or set the current session id</refpurpose>
+ <refpurpose>Pobierz i/lub ustaw identyfikator bie��cej sesji</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>session_id</function></funcdef>
@@ -514,14 +515,14 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>session_id</function> returns the session id for the
- current session. If <parameter>id</parameter> is specified, it
- will replace the current session id.
+ <function>session_id</function> zwraca identyfikator sesji dla bie��cej
+ sesji. Je�li podany zosta� parametr <parameter>id</parameter>, zostanie
+ on u�yty do zmiany identyfikatora bie��cej sesji.
</para>
<para>
- The constant <systemitem>SID</systemitem> can also be used to
- retrieve the current name and session id as a string suitable for
- adding to URLs.
+ Do pobrania nazwy i identyfikatora bie��cej sesji mo�a by� u�yta tak�e
+ sta�a <systemitem>SID</systemitem>, kt�ra zawiera string odpowiedni do
+ dodawania go do URLi.
</para>
</refsect1>
</refentry>
@@ -530,47 +531,45 @@
<refnamediv>
<refname>session_register</refname>
<refpurpose>
- Register one or more variables with the current session
+ Zarejestruj jedn� lub wi�cej zmiennych w bie��cej sesji
</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>session_register</function></funcdef>
- <paramdef>mixed <parameter>name</parameter></paramdef>
+ <paramdef>mixed <parameter>nazwa</parameter></paramdef>
<paramdef>mixed
<parameter><optional>...</optional></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- <function>session_register</function> variable number of
- arguments, any of which can be either a string holding the
- variable name or an array consisting of such variable names or
- other arrays. For each encountered variable name,
- <function>session_register</function> registers the global
- variable named by it with the current session.
+ <function>session_register</function> jest funkcj� o zmiennej liczbie
+ argument�w, z kt�rych ka�dy mo�e by� albo stringiem zawieraj�cym nazw�
+ zmiennej lub tablic� zawieraj�c� nazwy zmiennych lub inne tablice. Dla
+ ka�dej napotkanej nazwy zmiennej, <function>session_register</function>
+ rejestruje w bie��cej sesji globaln� zmienn� o danej nazwie.
</para>
<para>
- This function returns &true; when the variable is successfully
- registered with the session.
+ Funkcja ta zwraca warto�� &true; je�li zmienna zosta�a pomy�lnie
+ zarejestrowana w sesji.
</para>
<note>
<para>
- It is not currently possible to register resource variables in a
- session. For example, you can not create a connection to a
- database and store the connection id as a session variable and
- expect the connection to still be valid the next time the
- session is restored. PHP functions that return a resource are
- identified by having a return type of
- <literal>resource</literal> in their function definitions. A
- list of functions that return resources are available in the
- <link linkend="resource">resource types</link> appendix.
+ W chwili obecnej niemo�liwe jest zarejestrowanie w sesji zmiennych
+ zawieraj�cych zasoby. Na przyk�ad, nie mo�esz stworzy� po��czenia do
+ bazy danych i zachowa� identyfikator po��czenia jako zmienn� sesyjn� i
+ oczekowa�, �e po��czenie ci�gle b�dzie aktywne po odtworzeniu danych
+ sesji. Funkcj� PHP, kt�ra zwraca zasoby, identyfikuje si� przez
+ zwracanie typu <literal>resource</literal> w definicji funkcji. List�
+ funkcji, kt�re zwracaj� zasoby, mo�na znale�� w za��czniku
+ <link linkend="resource">typy zasob�w</link>.
</para>
</note>
<note>
<para>
- This function was added in PHP 4.0.
+ Funkcja ta zosta�a dodana w PHP 4.0.
</para>
</note>
</refsect1>
@@ -580,28 +579,27 @@
<refnamediv>
<refname>session_unregister</refname>
<refpurpose>
- Unregister a variable from the current session
+ Wyrejestruj zmienn� z bie��cej sesji
</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>session_unregister</function></funcdef>
- <paramdef>string <parameter>name</parameter></paramdef>
+ <paramdef>string <parameter>nazwa</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- <function>session_unregister</function> unregisters (forgets)
- the global variable named <parameter>name</parameter> from the
- current session.
+ <function>session_unregister</function> wyrejestrowuje (zapomina)
+ globaln� zmienn� o nazwie <parameter>nazwa</parameter> z bie��cej sesji.
</para>
<para>
- This function returns &true; when the variable is successfully
- unregistered from the session.
+ Funkcja ta zwraca warto�� &true; je�li zmienna zosta�a pomy�lnie
+ wyrejestrowana z sesji.
<note>
<para>
- This function was added in PHP 4.0.
+ Funkcja ta zosta�a dodana w PHP 4.0.
</para>
</note>
</para>
@@ -612,11 +610,11 @@
<refnamediv>
<refname>session_unset</refname>
<refpurpose>
- Free all session variables
+ Zwolnij wszystkie zmienne sesyjne
</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>session_unset</function></funcdef>
@@ -624,8 +622,8 @@
</funcprototype>
</funcsynopsis>
<para>
- The <function>session_unset</function> function free's all session variables
- currently registered.
+ Funkcja <function>session_unset</function> zwalnia wszystkie zmienne
+ sesyjne, kt�re s� aktualnie zarejestrowane.
</para>
</refsect1>
</refentry>
@@ -634,24 +632,24 @@
<refnamediv>
<refname>session_is_registered</refname>
<refpurpose>
- Find out if a variable is registered in a session
+ Sprawd�, czy zmienna jest zarejestrowana w sesji
</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>session_is_registered</function></funcdef>
- <paramdef>string <parameter>name</parameter></paramdef>
+ <paramdef>string <parameter>nazwa</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- <function>session_is_registered</function> returns &true; if there
- is a variable with the name <parameter>name</parameter>
- registered in the current session.
+ <function>session_is_registered</function> zwraca warto�� &true; je�li w
+ bie��cej sesji zarejestrowana jest zmienna o nazwie
+ <parameter>nazwa</parameter>.
<note>
<para>
- This function was added in PHP 4.0.
+ Funkcja ta zosta�a dodana w PHP 4.0.
</para>
</note>
</para>
@@ -662,11 +660,11 @@
<refnamediv>
<refname>session_get_cookie_params</refname>
<refpurpose>
- Get the session cookie parameters
+ Pobierz parametry ciasteczka sesyjnego
</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>
@@ -676,23 +674,23 @@
</funcprototype>
</funcsynopsis>
<para>
- The <function>session_get_cookie_params</function> function returns an
- array with the current session cookie information, the array contains
- the following items:
+ Funkcja <function>session_get_cookie_params</function> zwraca tablic�
+ zawieraj�c� informacje o bie��cym ciasteczku sesyjnym. Tablica zawiera
+ poni�sze informacje:
<itemizedlist>
<listitem>
<simpara>
- "lifetime" - The lifetime of the cookie.
+ "lifetime" - Czas �ycia ciasteczka.
</simpara>
</listitem>
<listitem>
<simpara>
- "path" - The path where information is stored.
+ "path" - �cie�ka na kt�rej przechowywane s� informacje.
</simpara>
</listitem>
<listitem>
<simpara>
- "domain" - The domain of the cookie.
+ "domain" - Domena ciasteczka.
</simpara>
</listitem>
</itemizedlist>
@@ -704,28 +702,28 @@
<refnamediv>
<refname>session_set_cookie_params</refname>
<refpurpose>
- Set the session cookie parameters
+ Ustaw parametry ciasteczka sesyjnego
</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>session_set_cookie_params</function></funcdef>
<paramdef>
- int <parameter>lifetime</parameter>
+ int <parameter>czas_�ycia</parameter>
</paramdef>
<paramdef>
- string <parameter><optional>path</optional></parameter>
+ string <parameter><optional>�cie�ka</optional></parameter>
</paramdef>
<paramdef>
- string <parameter><optional>domain</optional></parameter>
+ string <parameter><optional>domena</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
- Set cookie parameters defined in the php.ini file. The effect of this
- function only lasts for the duration of the script.
+ Ustaw parametry ciasteczka pierwotnie zdefiniowane w pliku php.ini. Efekt
+ dzia�ania tej funkcji widoczny jest tylko do ko�ca dzia�ania skryptu.
</para>
</refsect1>
</refentry>
@@ -733,23 +731,23 @@
<refentry id="function.session-decode">
<refnamediv>
<refname>session_decode</refname>
- <refpurpose>Decodes session data from a string</refpurpose>
+ <refpurpose>Dekoduje dane sesji ze stringu</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>session_decode</function></funcdef>
- <paramdef>string <parameter>data</parameter></paramdef>
+ <paramdef>string <parameter>dane</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- <function>session_decode</function> decodes the session data in
- <parameter>data</parameter>, setting variables stored in the
- session.
+ <function>session_decode</function> dekofuje dane sesji zawarte w
+ parametrze <parameter>dane</parameter>, ustawiaj�c zmienne zachowane w
+ sesji.
<note>
<para>
- This function was added in PHP 4.0.
+ Ta funkcja zosta�a dodana w PHP 4.0.
</para>
</note>
</para>
@@ -760,11 +758,11 @@
<refnamediv>
<refname>session_encode</refname>
<refpurpose>
- Encodes the current session data as a string
+ Koduje dane bie��cej sesji do postaci stringu
</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>session_encode</function></funcdef>
@@ -772,11 +770,11 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>session_encode</function> returns a string with the
- contents of the current session encoded within.
+ <function>session_encode</function> zwraca string zawieraj�cy zakodowane
+ dane bie��cej sesji.
<note>
<para>
- This function was added in PHP 4.0.
+ Ta funkcja zosta�a dodana w PHP 4.0.
</para>
</note>
</para>
@@ -787,60 +785,60 @@
<refnamediv>
<refname>session_set_save_handler</refname>
<refpurpose>
- Sets user-level session storage functions
+ Ustawia funkcje u�ytkownika do przechowywania sesji
</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void
<function>session_set_save_handler</function>
</funcdef>
<paramdef>string
- <parameter>open</parameter></paramdef><paramdef>string
- <parameter>close</parameter></paramdef><paramdef>string
- <parameter>read</parameter></paramdef><paramdef>string
- <parameter>write</parameter></paramdef><paramdef>string
- <parameter>destroy</parameter></paramdef><paramdef>string
+ <parameter>otw�rz</parameter></paramdef><paramdef>string
+ <parameter>zamknij</parameter></paramdef><paramdef>string
+ <parameter>czytaj</parameter></paramdef><paramdef>string
+ <parameter>zapisz</parameter></paramdef><paramdef>string
+ <parameter>niszcz</parameter></paramdef><paramdef>string
<parameter>gc</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- <function>session_set_save_handler</function> sets the user-level
- session storage functions which are used for storing and
- retrieving data associated with a session. This is most useful
- when a storage method other than those supplied by PHP sessions
- is preferred. i.e. Storing the session data in a local database.
+ <function>session_set_save_handler</function> ustawia funkcje u�ytkownika
+ do obs�ugi przechowywania sesji, kt�re u�ywane sa do zapisywania i
+ odtwarzania danych skojarzonych z sesj�. Jest to bardzo przydatne je�li
+ preferowany jest spos�b przechowywania sesji inny ni� ten, kt�ry jest
+ dostarczany z PHP, np. przechowywanie danych sesji w lokalnej bazie
+ danych.
</para>
<note>
<para>
- You must set the configuration option
- <parameter>session.save_handler</parameter> to
- <parameter>user</parameter> in your php.ini file for
- <function>session_set_save_handler</function> to take effect.
+ W swoim pliku php.ini musisz ustawi� opcj� konfiguracji
+ <parameter>session.save_handler</parameter> na
+ <parameter>user</parameter> aby
+ <function>session_set_save_handler</function> zadzia�a�o.
</para>
</note>
<note>
<para>
- The "write" handler is not executed until after the output
- stream is closed. Thus, output from debugging statements in the
- "write" handler will never be seen in the browser. If debugging
- output is necessary, it is suggested that the debug output be
- written to a file instead.
+ Procedura obs�ugi "zapisz" nie b�dzie wywo�ana dop�ki strumie� wyj�ciowy
+ jest otwarty. W zwi�zku z tym, wyj�cie instrukcji debugowania zawartych
+ w procedurze "zapisz" nigdy nie b�dzie widoczne w oknie przegl�darki.
+ Je�li konieczne jest wyj�cie debugowania, sugerowane jest zapisanie tego
+ wyj�cia do pliku.
</para>
</note>
<para>
- The following example provides file based session
- storage similar to the PHP sessions default save handler
- <parameter>files</parameter>. This example could easily be
- extended to cover database storage using your favorite PHP
- supported database engine.
+ Poni�szy przyk�ad opisuje metod� przechowywania danych sesyjnych w
+ plikach, podobn� do tej obs�ugiwanej wewn�trznie przez PHP. Przyk�ad ten
+ mo�e by� �atwo rozszerzony aby m�c u�y� go z twoj� ulubion� baz� danych
+ obs�ugiwan� przez PHP.
</para>
<para>
<example>
<title>
- <function>session_set_save_handler</function> example
+ Przyk�ad <function>session_set_save_handler</function>
</title>
<programlisting role="php">
<?php
@@ -890,8 +888,8 @@
}
/*********************************************
- * WARNING - You will need to implement some *
- * sort of garbage collection routine here. *
+ * UWAGA: Musisz sam zaimplementowa� obs�ug� *
+ * zbierania �mieci (gb) *
*********************************************/
function gc ($maxlifetime) {
return true;
@@ -901,7 +899,7 @@
session_start();
-// proceed to use sessions normally
+// dalej normalnie u�ywaj sesji
?>
</programlisting>
@@ -913,56 +911,72 @@
<refentry id="function.session-cache-limiter">
<refnamediv>
<refname>session_cache_limiter</refname>
- <refpurpose>Get and/or set the current cache limiter</refpurpose>
+ <refpurpose>
+ Pobierz i/lub ustaw bie��cy ogranicznik pami�ci podr�cznej
+ </refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>session_cache_limiter</function></funcdef>
<paramdef>string
- <parameter><optional>cache_limiter</optional></parameter>
+ <parameter><optional>ogranicznik</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
- <function>session_cache_limiter</function> returns the name of the
- current cache limiter. If <parameter>cache_limiter</parameter> is
- specified, the name of the current cache limiter is changed to the
- new value.
- </para>
- <para>
- The cache limiter controls the cache control HTTP headers sent to the
- client. These headers determine the rules by which the page content
- may be cached. Setting the cache limiter to <literal>nocache</literal>,
- for example, would disallow any client-side caching. A value of
- <literal>public</literal>, however, would permit caching. It can also
- be set to <literal>private</literal>, which is slightly more restrictive
- than <literal>public</literal>.
- </para>
- <para>
- The cache limiter is reset to the default value stored in
- <literal>session.cache_limiter</literal> at request startup time. Thus,
- you need to call <function>session_cache_limiter</function> for every
- request (and before <function>session_start</function> is called).
+ <function>session_cache_limiter</function> zwraca nazw� bie��cego
+ ogranicznika pami�ci podr�cznej. Je�li podany zosta� parametr
+ <parameter>ogranicznik</parameter>, nazwa bie��cego ogranicznego zostanie
+ zmieniona na now� warto��.
+ </para>
+ <para>
+ Ogranicznik pami�ci podr�cznej kontroluje nag��wki HTTP wysy�ane do
+ klienta. Nag��wki te ustalaj� zasady, wed�ug kt�rych zawarto�� strony
+ mo�e by� przechowywana w pami�ci podr�cznej przegl�darki. Ustawiaj�c
+ ogranicznik pami�ci podr�cznej na przyk�ad na<literal>nocache</literal>,
+ zabronimy jakiekolwiek zachowywanie strony po stronie klienta. Warto��
+ <literal>public</literal> pozwoli na takie przechywanie. Ogranicznikiem
+ mo�e by� te� <literal>private</literal>, kt�ry jest troszk� bardziej
+ restrykcyjny ni� <literal>public</literal>.
+ </para>
+ <para>
+ W trybie <literal>private</literal>, nag��wek <literal>Expire</literal>,
+ kt�ry jest wysy�any do klienta, mo�e spowodowa� nieoczekiwane dzia�anie
+ niekt�rych przegl�darem, mi�dzy innymi Mozilli. Mo�esz unikn�� tego
+ problemu u�ywaj�c trybu <literal>private_no_expire</literal>. Nag��wek
+ <literal>Expire</literal> nie jest w tym wypadku wysy�any do klienta.
+ </para>
+ <note>
+ <para>
+ <literal>private_no_expire</literal> zosta�o dodane w PHP 4.2.0dev.
+ </para>
+ </note>
+ <para>
+ Ogranicznik pami�ci podr�cznej w momencie wywo�ania skryptu jest zerowany
+ do warto�ci domy�lnej przechowywanej w
+ <literal>session.cache_limiter</literal>. W zwi�zku z tym niezb�dne jest
+ wywo�anie <function>session_cache_limiter</function> dla ka�dego
+ wywo�ania skryptu (i przed wywo�aniem <function>session_start</function>).
</para>
<example>
- <title><function>session_cache_limiter</function> examples</title>
+ <title>Przyk�ady <function>session_cache_limiter</function></title>
<programlisting role="php">
<?php
-# set the cache limiter to 'private'
+# Ustaw ogranicznik pami�ci podr�cznej na 'private'
session_cache_limiter('private');
$cache_limiter = session_cache_limiter();
-echo "The cache limiter is now set to $cache_limiter<p>";
+echo "Ogranicznikiem pami�ci podr�cznej jest teraz $cache_limiter<p>";
?>
</programlisting>
</example>
<note>
<para>
- This function was added in PHP 4.0.3.
+ Funkcja ta zosta�a dodana w PHP 4.0.3.
</para>
</note>
</refsect1>
@@ -971,10 +985,10 @@
<refentry id="function.session-write-close">
<refnamediv>
<refname>session_write_close</refname>
- <refpurpose>Write session data and end session</refpurpose>
+ <refpurpose>Zapisz dane i zako�cz sesj�</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>session_write_close</function></funcdef>
@@ -982,34 +996,36 @@
</funcprototype>
</funcsynopsis>
<para>
- End the current session and store session data.
+ Zako�cz bie��c� sesj� i zachowaj dane sesji.
</para>
<para>
- Session data is usually stored after your script terminated
- without the need to call <function>session_write_close</function>, but as
- session data is locked to prevent concurrent writes only one
- script may operate on a session at any time. When using framesets
- together with sessions you will experience the frames loading one
- by one due to this locking. You can reduce the time needed to
- load all the frames by ending the session as soon as all changes
- to session variables are done.
+ Dane sesji s� zazwyczaj przechowywane do czasu zako�czenie dzia�ania
+ skryptu bez konieczno�ci wywo�ania <function>session_write_close
+ </function>, ale poniewa� dane sesji s� blokowane w celu zapobie�enia
+ r�wnoleg�ym zapisom, tylko jeden skrypt mo�e operowa� na sesji w danej
+ chwili. U�ywaj�c ramek HTMLowych razem z sesjami napotkasz problemy
+ zwi�zane z jednoczesnym korzystaniem z jednej sesji przez kilka skrypt�w.
+ Mo�esz zmniejszy� czas niezb�dny do wczytania wszystkich ramek przez
+ ko�czenie sesji jak tylko wykonane s� wszystkie zmiany w zmiennych
+ sesyjnych.
</para>
-<!-- commented out until final decision on implementation
+<!-- wykomentowane do czasu ostatecznej decyzji o implementacji
<para>
- See also: <function>session_readonly</function>.
+ Zobacz tak�e: <function>session_readonly</function>.
</para>
-->
</refsect1>
</refentry>
-<!-- commented out until final decision on implementation
+<!-- wykomentowane do czasu ostatecznej decyzji o implementacji
<refentry id="function.session-readonly">
<refnamediv>
<refname>session_readonly</refname>
- <refpurpose>Begin session - reinitializes freezed variables, but no writeback on
request end</refpurpose>
+ <refpurpose>Rozpocznij sesj� - reinicjalizuj zamro�one zmienne, ale nie
+ nie zapisuj zmian po zako�czeniu wywo�ania</refpurpose>
</refnamediv>
<refsect1>
- <title>Description</title>
+ <title>Opis</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>session_readonly</function></funcdef>
@@ -1017,8 +1033,8 @@
</funcprototype>
</funcsynopsis>
<para>
- Read in session data without locking the session data. Changing
- session data is not possible, but frameset performance will be improved.
+ Odczytaj dane sesji bez blokowania tych danych. Nie jest mo�liwa zmiana
+ danych sesyjnych, ale zwi�kszona jest wydajno�� ramek HTML.
</para>
</refsect1>
</refentry>
