cvs: phpdoc /pl/functions session.xml
| From: | Leszek Krupinski | Date: | Sun, 04 Nov 2001 00:03:13 +0000 |
| Subject: | cvs: phpdoc /pl/functions session.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969338482@lists.php.net to get a copy of this message | ||
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>
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>