cvs: phpdoc-pl /reference/session ini.xml
| From: | Leszek Krupinski | Date: | Mon, 21 Feb 2005 01:08:35 +0000 |
| Subject: | cvs: phpdoc-pl /reference/session ini.xml | ||
| Groups: | php.doc.pl | ||
| Request: | Send a blank email to doc-pl+get-423@lists.php.net to get a copy of this message | ||
leszek Sun Feb 20 20:08:35 2005 EDT
Added files:
/phpdoc-pl/reference/session ini.xml
Log:
http://cvs.php.net/co.php/phpdoc-pl/reference/session/ini.xml?r=1.1&p=1 Index: phpdoc-pl/reference/session/ini.xml +++ phpdoc-pl/reference/session/ini.xml <?xml version="1.0" encoding="iso-8859-2"?> <!-- EN-Revision: 1.29 Maintainer: leszek Status: ready --> <!-- $Revision: 1.1 $ --> <section id="session.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>Opcje konfiguracji</title> <tgroup cols="3"> <thead> <row> <entry>Nazwa</entry> <entry>Domy¶lna warto¶æ</entry> <entry>Mo¿liwo¶æ zmian</entry> </row> </thead> <tbody> <row> <entry>session.save_path</entry> <entry>"/tmp"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.name</entry> <entry>"PHPSESSID"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.save_handler</entry> <entry>"files"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.auto_start</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.gc_probability</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.gc_divisor</entry> <entry>"100"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.gc_maxlifetime</entry> <entry>"1440"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.serialize_handler</entry> <entry>"php"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_lifetime</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_path</entry> <entry>"/"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_domain</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_secure</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.use_cookies</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.use_only_cookies</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.referer_check</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.entropy_file</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.entropy_length</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cache_limiter</entry> <entry>"nocache"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cache_expire</entry> <entry>"180"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.use_trans_sid</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.bug_compat_42</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.bug_compat_warn</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.hash_function</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.hash_bits_per_character</entry> <entry>"4"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>url_rewriter.tags</entry> <entry>"a=href,area=href,frame=src,form=,fieldset="</entry> <entry>PHP_INI_ALL</entry> </row> <!-- Not yet <row> <entry>session.encode_sources</entry> <entry>"globals</entry> <entry>track"</entry> </row> --> </tbody> </tgroup> </table> Wiêcej szczegó³ów i definicje zmiennych PHP_INI_* znajduj± siê w opisie funkcji <function>ini_set</function>. </para> <para> System zarz±dzania sesjami obs³uguje wiele opcji konfiguracji, które mo¿na zamie¶ciæ w pliku &php.ini;. Poni¿ej znajduje siê ich krótki opis. <variablelist> <varlistentry id="ini.session.save-handler"> <term> <parameter>session.save_handler</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.save_handler</literal> okre¶la nazwê systemu obs³ugi, który bêdzie odpowiedzialny za przechowywanie i odzyskiwanie danych przypisanych do sesji. Dom¶lna warto¶æ to <literal>files</literal>. Patrz tak¿e: <function>session_set_save_handler</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.save-path"> <term> <parameter>session.save_path</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.save_path</literal> okre¶la argument, który przekazywany jest do systemu zapisywania sesji. Je¶li ustawiony jest dom¶lny system, plikowy, ta ¶cie¿ka bêdzie okre¶la³a gdzie tworzone bêd± pliki. Domy¶lna warto¶æ to <literal>/tmp</literal>. Patrz tak¿e: <function>session_save_path</function>. </simpara> <para> Opcjonalny argument N do tej dyrektywy okre¶la liczbê poziomów katalogów w których bêd± przechowywane pliki z sesjami. Na przyk³ad ustawienie <literal>'5;/tmp'</literal> mo¿e prowadziæ do stworzenia pliku z sesj± o ¶cie¿ce <literal>/tmp/4/b/1/e/3/sess_4b1e384ad74619bd212e236e52a5a174If </literal>. Aby u¿ywaæ N nale¿y stworzyæ wszystkie powy¿sze katalogi przed u¿yciem. W katalogu <filename>ext/session</filename> znajduje siê skrypt <filename>mod_files.sh</filename> który przygotuje niezbêdn± strukturê katalogów. Nale¿y zauwa¿yæ, ¿e u¿ywaj±c N o warto¶ci wiêkszej ni¿ 0 nie bêdzie przeprowadzane automatyczne sprz±tanie ¶mieci. Wiêcej informacji na ten temat znajduje siê w pliku &php.ini;. U¿ywaj±c N nale¿y tak¿e pamiêtaæ o otoczeniu warto¶ci <literal>session.save_path</literal> "cudzys³owami", poniewa¿ separator (<literal>;</literal>) jest u¿ywany tak¿e do oznaczania komentarzy w &php.ini;. </para> <warning> <para> Je¶li warto¶æ tej zmiennej zostanie ustawiona na katalog odczytywalny dla wszystkich u¿ytkowników, jak na przyk³ad <filename>/tmp</filename> (domy¶lna warto¶æ), inni u¿ytkownicy systemu bêd± mogli "porwaæ" sesjê przez pobranie listy plików z tego katalogu. </para> </warning> <note> <simpara> W PHP starszym ni¿ 4.3.6, u¿ytkownicy systemu Windows musieli zmieniæ warto¶æ tej zmiennej aby korzystaæ z obs³ugi sesji. Musi byæ podana poprawna ¶cie¿ka, na przyk³ad <filename>c:/temp</filename>. </simpara> </note> </listitem> </varlistentry> <varlistentry id="ini.session.name"> <term> <parameter>session.name</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.name</literal> okre¶la nazwê sesji, która zostanie u¿yta jako nazwa ciasteczka. Powinna ona zawieraæ tylko znaki alfanumeryczne. Domy¶lna warto¶æ to <literal>PHPSESSID</literal>. Patrz tak¿e: <function>session_name</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.auto-start"> <term> <parameter>session.auto_start</parameter> <type>boolean</type> </term> <listitem> <simpara> <literal>session.auto_start</literal> okre¶la, czy modu³ sesji automatycznie rozpocznie sesjê na pocz±tku ka¿dego ¿±dania. Domy¶na warto¶æ to <literal>0</literal> (wy³±czone). </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.serialize-handler"> <term> <parameter>session.serialize_handler</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.serialize_handler</literal> okre¶la nazwê podsystemu który bêdzie u¿yty do serializowania/deserializowania danych. Aktualnie PHP obs³uguje wewnêtrzny format (nazwa <literal>php</literal>) i WDDX (nazwa <literal>wddx</literal>). WDDX jest dostêpne tylko je¶li PHP zosta³o skompilowane z <link linkend="ref.wddx">obs³ug± WDDX</link>. Domy¶lna warto¶æ to <literal>php</literal>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.gc-probability"> <term> <parameter>session.gc_probability</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.gc_probability</literal> w po³±czeniu z <literal>session.gc_divisor</literal> jest u¿ywana do zarz±dzania prawdopodobieñstwem zdarzenia, ¿e zostanie uruchomiony gc (garbage collector - sprz±tacz ¶mieci). Domy¶lna warto¶æ to <literal>1</literal>. Wiêcej szczegó³ów mo¿na znale¼æ w opisie <link linkend="ini.session.gc-divisor">session.gc_divisor</link>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.gc-divisor"> <term> <parameter>session.gc_divisor</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.gc_divisor</literal> w po³±czeniu z <literal>session.gc_probability</literal> okre¶la prawdopodobieñstwo, z jakim gc (garbage collector - sprz±tacz ¶mieci) zostanie uruchomiony w czasie inicjalizacji sesji. Prawdopodobieñstwo jest okre¶lane przez obliczenie gc_probability/gc_divisor, na przyk³ad 1/100 oznacza, ¿e jest jednoprocentowa szansa, ¿e proces sprz±tania ¶mieci zostanie uruchomiony na pocz±tku sesji. Domy¶lna warto¶æ <literal>session.gc_divisor</literal> to <literal>100</literal>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.gc-maxlifetime"> <term> <parameter>session.gc_maxlifetime</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.gc_maxlifetime</literal> okre¶la liczbê sekund, po których dane zostan± uznane za "¶mieci" i sprz±tniête. </simpara> <note> <simpara> Je¶li u¿ywany jest domy¶lny podsystem obs³ugi sesji oparty na plikach, system plików musi ¶ledziæ czasy dostêpu (atime). System plików FAT u¿ywany w systemie Windows nie przechowuje takich informacji, a wiêc niezbêdne jest zapewnienie innego sposobu sprz±tania ¶mieci sesji, je¶li nie ma mo¿liwo¶ci u¿ywania systemu innego ni¿ FAT czy inny system plików który nie ¶ledzi czasu dostêpu. Od PHP 4.2.3 u¿ywany jest mtime (czas modyfikacji) zamiast atime. W zwi±zku z tym systemy plików nie ¶ledz±ce atime nie bêd± sprawia³y problemów. </simpara> </note> </listitem> </varlistentry> <varlistentry id="ini.session.referer-check"> <term> <parameter>session.referer_check</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.referer_check</literal> zawiera element ci±gu tekstowego, który ma byæ sprawdzany w polu HTTP Referer. Je¶li klient wys³a³ na g³ówek Referer a podany element ci±gu nie zosta³ w nim znaleziony, to identyfikator sesji zostanie oznaczony jako nieprawid³owy. Domy¶lna warto¶æ to pusty ci±g. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.entropy-file"> <term> <parameter>session.entropy_file</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.entropy_file</literal> okre¶la ¶cie¿kê do zewnêtrznego zasobu (pliku), który zostanie u¿yty jako dodatkowe ¼ród³o entropii przy generowaniu identyfikatora sesji. Przyk³adowo mo¿e to byæ <literal>/dev/random</literal> lub <literal>/dev/urandom</literal>, które s± dostêpne na wielu systemach Uniksowych. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.entropy-length"> <term> <parameter>session.entropy_length</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.entropy_length</literal> okre¶la liczbê bajtów, która zostanie odczytana z pliku podanego wy¿ej. Domy¶lna warto¶æ to <literal>0</literal> (wy³±czone). </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.use-cookies"> <term> <parameter>session.use_cookies</parameter> <type>boolean</type> </term> <listitem> <simpara> <literal>session.use_cookies</literal> okre¶la czy modu³ bêdzie u¿ywa³ ciasteczek do przechowywania identyfikatora sesji po stronie klienta. Domy¶lna warto¶æ to <literal>1</literal> (w³±czone). </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.use-only-cookies"> <term> <parameter>session.use_only_cookies</parameter> <type>boolean</type> </term> <listitem> <simpara> <literal>session.use_only_cookies</literal> okre¶la czy modu³ bêdzie u¿ywa³ <emphasis role="strong">tylko</emphasis> ciasteczek do przechowywania identyfikatora sesji po stronie klienta. Domy¶lna warto¶æ to cookies to store the session id on the client side. Defaults <literal>0</literal> (wy³±czone, dla kompatybilno¶ci wstecznej). W³±czenie tej opcji zapobiega atakom zwi±zanym z przekazywaniem identyfikatorów sesji w URLach. To ustawienie zosta³o dodane w PHP 4.3.0. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.cookie-lifetime"> <term> <parameter>session.cookie_lifetime</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.cookie_lifetime</literal> okre¶la czas ¿ycia ciasteczka w sekundach, co zostanie przekazane do przegl±darki. Warto¶æ 0 oznacza "dopóki przegl±darka nie zostanie zamkniêta". Domy¶lna warto¶æ to <literal>0</literal>. Patrz tak¿e: <function>session_get_cookie_params</function> i <function>session_set_cookie_params</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.cookie-path"> <term> <parameter>session.cookie_path</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.cookie_path</literal> okre¶la ¶cie¿kê u¿yt± do ustawienia ciasteczka sesyjnego. Domy¶lna warto¶æ to <literal>/</literal>. Patrz tak¿e: <function>session_get_cookie_params</function> i <function>session_set_cookie_params</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.cookie-domain"> <term> <parameter>session.cookie_domain</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.cookie_domain</literal> okre¶la domenê u¿yt± do ustawienia ciasteczka sesyjnego. Domy¶lna warto¶æ to brak domeny. Patrz tak¿e: <function>session_get_cookie_params</function> i <function>session_set_cookie_params</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.cookie-secure"> <term> <parameter>session.cookie_secure</parameter> <type>boolean</type> </term> <listitem> <simpara> <literal>session.cookie_secure</literal> Okre¶la czy ciasteczko powinno byæ przes³ane tylko poprzez bezpieczne po³±czenie. Domy¶lna warto¶æ to <literal>off</literal> (wy³±czone). Ta opcja zosta³a dodana w PHP 4.0.4. Patrz tak¿e: <function>session_get_cookie_params</function> i <function>session_set_cookie_params</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.cache-limiter"> <term> <parameter>session.cache_limiter</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.cache_limiter</literal> okre¶la metodê kontroli pamiêci podrêcznej u¿yt± dla stron sesyjnych (dopuszczalne warto¶ci to none, nocache, private, private_no_expire, public). Domy¶lna warto¶æ to <literal>nocache</literal>. Patrz tak¿e: <function>session_cache_limiter</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.cache-expire"> <term> <parameter>session.cache_expire</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.cache_expire</literal> okre¶la czas ¿ycia zbuforowanych stron sesyjnych, okre¶lony w minutach (nie ma to efektu dla ogranicznika nocache). Domy¶lna warto¶æ to <literal>180</literal>. Patrz tak¿e: <function>session_cache_expire</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.use-trans-sid"> <term> <parameter>session.use_trans_sid</parameter> <type>boolean</type> </term> <listitem> <simpara> <literal>session.use_trans_sid</literal> okre¶la, czy w³±czona jest obs³uga przezroczystego przekazywania identyfikatora sesji. Domy¶lna warto¶æ to <literal>0</literal> (wy³±czone). </simpara> <note> <simpara> W PHP 4.1.2 i starszych, opcja ta by³a w³±czana przez kompilacjê z parametrem <link linkend="configure.enable-trans-sid"> <literal>--enable-trans-sid</literal></link>. Od PHP 4.2.0, trans-sid jest domy¶lnie wkompilowywane. </simpara> <simpara> Zarz±dzanie sesjami oparte na URLu niesie za sob± wiêcej zagro¿eñ bezpieczeñstwa w stosunku do zarz±dzania opartego o ciasteczka. U¿ytkownicy mog± wysy³aæ emailem do swoich przyjació³ URLe zawieraj±ce identyfikatory sesji, lub te¿ zapisywaæ je do zak³adek i ³±czyæ siê z danym serwerem zawsze przy u¿yciu tego samego identyfikatora. </simpara> </note> </listitem> </varlistentry> <varlistentry id="ini.session.bug-compat-42"> <term> <parameter>session.bug_compat_42</parameter> <type>boolean</type> </term> <listitem> <simpara> PHP 4.2.0 i starsze mia³y nieudokumentowan± opcjê/b³±d, która pozwala³a na inicjalizacjê zmiennej sesyjnej w zasiêgu globalnym pomimo wy³±czenia <link linkend="ini.register-globals">register_globals</link>. PHP 4.3.0 i nowsze ostrzeg±, je¶li ta opcja, a tak¿e <link linkend="ini.session.bug-compat-warn">session.bug_compat_warn</link> s± w³±czone. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.bug-compat-warn"> <term> <parameter>session.bug_compat_warn</parameter> <type>boolean</type> </term> <listitem> <simpara> PHP 4.2.0 i starsze mia³y nieudokumentowan± opcjê/b³±d, która pozwala³a na inicjalizacjê zmiennej sesyjnej w zasiêgu globalnym pomimo wy³±czenia <link linkend="ini.register-globals">register_globals</link>. PHP 4.3.0 i nowsze ostrzeg±, je¶li ta opcja, a tak¿e <link linkend="ini.session.bug-compat-warn">session.bug_compat_42</link> s± w³±czone. session.bug_compat_warn</link>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.hash-function"> <term> <parameter>session.hash_function</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.hash_function</literal> pozwala na okre¶lenie algorytmu skrótu, który zostanie u¿yty do generowania identyfikatora sesji. '0' oznacza MD5 (128 bitów) a '1' oznacza SHA-1 (160 bitów). </simpara> <note> <para> Ta opcja zosta³a dodana w PHP 5. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.session.hash-bits-per-character"> <term> <parameter>session.hash_bits_per_character</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.hash_bits_per_character</literal> pozwala na okre¶lenie ile bitów jest przechowywanych w ka¿dym znaku przy konwersji danych binarnych na postaæ odczytywaln±. Dopuszczalne warto¶ci to '4' (0-9, a-f), '5' (0-9, a-v) i '6' (0-9, a-z, A-Z, "-", ","). </simpara> <note> <para> Ta opcja zosta³a dodana w PHP 5. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.url-rewriter.tags"> <term> <parameter>url_rewriter.tags</parameter> <type>string</type> </term> <listitem> <simpara> <literal>url_rewriter.tags</literal> okre¶la które znaczniki HTML s± przepisywane w celu dodania identyfikatora sesji je¶li w³±czona jest opcja przezroczystego przekazywania identyfikatora. Domy¶lna warto¶æ to <literal>a=href,area=href,frame=src,input=src,form=fakeentry,fieldset=</literal> </simpara> <note> <simpara> Aby uzyskaæ zgodno¶æ z XHTML, nale¿y usun±æ wpis <literal>form</literal> i u¿yæ znaczników <fieldset> wokó³ pól formularza. </simpara> </note> </listitem> </varlistentry> </variablelist> </para> <para> Opcje <link linkend="ini.track-vars"><literal>track_vars</literal></link> i <link linkend="ini.register-globals"><literal>register_globals</literal></link> wp³ywaj± na sposób zapisywania i odczytywania zmiennych sesyjnych. </para> <note> <para> Od wersji PHP 4.0.3 opcja <link linkend="ini.track-vars"><literal>track_vars</literal></link> jest zawsze w³±czona. </para> </note> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/co.php/phpdoc-pl/reference/session/ini.xml?r=1.1&p=1 Index: phpdoc-pl/reference/session/ini.xml +++ phpdoc-pl/reference/session/ini.xml <?xml version="1.0" encoding="iso-8859-2"?> <!-- EN-Revision: 1.29 Maintainer: leszek Status: ready --> <!-- $Revision: 1.1 $ --> <section id="session.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>Opcje konfiguracji</title> <tgroup cols="3"> <thead> <row> <entry>Nazwa</entry> <entry>Domy¶lna warto¶æ</entry> <entry>Mo¿liwo¶æ zmian</entry> </row> </thead> <tbody> <row> <entry>session.save_path</entry> <entry>"/tmp"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.name</entry> <entry>"PHPSESSID"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.save_handler</entry> <entry>"files"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.auto_start</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.gc_probability</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.gc_divisor</entry> <entry>"100"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.gc_maxlifetime</entry> <entry>"1440"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.serialize_handler</entry> <entry>"php"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_lifetime</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_path</entry> <entry>"/"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_domain</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_secure</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.use_cookies</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.use_only_cookies</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.referer_check</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.entropy_file</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.entropy_length</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cache_limiter</entry> <entry>"nocache"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cache_expire</entry> <entry>"180"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.use_trans_sid</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.bug_compat_42</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.bug_compat_warn</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.hash_function</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.hash_bits_per_character</entry> <entry>"4"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>url_rewriter.tags</entry> <entry>"a=href,area=href,frame=src,form=,fieldset="</entry> <entry>PHP_INI_ALL</entry> </row> <!-- Not yet <row> <entry>session.encode_sources</entry> <entry>"globals</entry> <entry>track"</entry> </row> --> </tbody> </tgroup> </table> Wiêcej szczegó³ów i definicje zmiennych PHP_INI_* znajduj± siê w opisie funkcji <function>ini_set</function>. </para> <para> System zarz±dzania sesjami obs³uguje wiele opcji konfiguracji, które mo¿na zamie¶ciæ w pliku &php.ini;. Poni¿ej znajduje siê ich krótki opis. <variablelist> <varlistentry id="ini.session.save-handler"> <term> <parameter>session.save_handler</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.save_handler</literal> okre¶la nazwê systemu obs³ugi, który bêdzie odpowiedzialny za przechowywanie i odzyskiwanie danych przypisanych do sesji. Dom¶lna warto¶æ to <literal>files</literal>. Patrz tak¿e: <function>session_set_save_handler</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.save-path"> <term> <parameter>session.save_path</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.save_path</literal> okre¶la argument, który przekazywany jest do systemu zapisywania sesji. Je¶li ustawiony jest dom¶lny system, plikowy, ta ¶cie¿ka bêdzie okre¶la³a gdzie tworzone bêd± pliki. Domy¶lna warto¶æ to <literal>/tmp</literal>. Patrz tak¿e: <function>session_save_path</function>. </simpara> <para> Opcjonalny argument N do tej dyrektywy okre¶la liczbê poziomów katalogów w których bêd± przechowywane pliki z sesjami. Na przyk³ad ustawienie <literal>'5;/tmp'</literal> mo¿e prowadziæ do stworzenia pliku z sesj± o ¶cie¿ce <literal>/tmp/4/b/1/e/3/sess_4b1e384ad74619bd212e236e52a5a174If </literal>. Aby u¿ywaæ N nale¿y stworzyæ wszystkie powy¿sze katalogi przed u¿yciem. W katalogu <filename>ext/session</filename> znajduje siê skrypt <filename>mod_files.sh</filename> który przygotuje niezbêdn± strukturê katalogów. Nale¿y zauwa¿yæ, ¿e u¿ywaj±c N o warto¶ci wiêkszej ni¿ 0 nie bêdzie przeprowadzane automatyczne sprz±tanie ¶mieci. Wiêcej informacji na ten temat znajduje siê w pliku &php.ini;. U¿ywaj±c N nale¿y tak¿e pamiêtaæ o otoczeniu warto¶ci <literal>session.save_path</literal> "cudzys³owami", poniewa¿ separator (<literal>;</literal>) jest u¿ywany tak¿e do oznaczania komentarzy w &php.ini;. </para> <warning> <para> Je¶li warto¶æ tej zmiennej zostanie ustawiona na katalog odczytywalny dla wszystkich u¿ytkowników, jak na przyk³ad <filename>/tmp</filename> (domy¶lna warto¶æ), inni u¿ytkownicy systemu bêd± mogli "porwaæ" sesjê przez pobranie listy plików z tego katalogu. </para> </warning> <note> <simpara> W PHP starszym ni¿ 4.3.6, u¿ytkownicy systemu Windows musieli zmieniæ warto¶æ tej zmiennej aby korzystaæ z obs³ugi sesji. Musi byæ podana poprawna ¶cie¿ka, na przyk³ad <filename>c:/temp</filename>. </simpara> </note> </listitem> </varlistentry> <varlistentry id="ini.session.name"> <term> <parameter>session.name</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.name</literal> okre¶la nazwê sesji, która zostanie u¿yta jako nazwa ciasteczka. Powinna ona zawieraæ tylko znaki alfanumeryczne. Domy¶lna warto¶æ to <literal>PHPSESSID</literal>. Patrz tak¿e: <function>session_name</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.auto-start"> <term> <parameter>session.auto_start</parameter> <type>boolean</type> </term> <listitem> <simpara> <literal>session.auto_start</literal> okre¶la, czy modu³ sesji automatycznie rozpocznie sesjê na pocz±tku ka¿dego ¿±dania. Domy¶na warto¶æ to <literal>0</literal> (wy³±czone). </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.serialize-handler"> <term> <parameter>session.serialize_handler</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.serialize_handler</literal> okre¶la nazwê podsystemu który bêdzie u¿yty do serializowania/deserializowania danych. Aktualnie PHP obs³uguje wewnêtrzny format (nazwa <literal>php</literal>) i WDDX (nazwa <literal>wddx</literal>). WDDX jest dostêpne tylko je¶li PHP zosta³o skompilowane z <link linkend="ref.wddx">obs³ug± WDDX</link>. Domy¶lna warto¶æ to <literal>php</literal>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.gc-probability"> <term> <parameter>session.gc_probability</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.gc_probability</literal> w po³±czeniu z <literal>session.gc_divisor</literal> jest u¿ywana do zarz±dzania prawdopodobieñstwem zdarzenia, ¿e zostanie uruchomiony gc (garbage collector - sprz±tacz ¶mieci). Domy¶lna warto¶æ to <literal>1</literal>. Wiêcej szczegó³ów mo¿na znale¼æ w opisie <link linkend="ini.session.gc-divisor">session.gc_divisor</link>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.gc-divisor"> <term> <parameter>session.gc_divisor</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.gc_divisor</literal> w po³±czeniu z <literal>session.gc_probability</literal> okre¶la prawdopodobieñstwo, z jakim gc (garbage collector - sprz±tacz ¶mieci) zostanie uruchomiony w czasie inicjalizacji sesji. Prawdopodobieñstwo jest okre¶lane przez obliczenie gc_probability/gc_divisor, na przyk³ad 1/100 oznacza, ¿e jest jednoprocentowa szansa, ¿e proces sprz±tania ¶mieci zostanie uruchomiony na pocz±tku sesji. Domy¶lna warto¶æ <literal>session.gc_divisor</literal> to <literal>100</literal>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.gc-maxlifetime"> <term> <parameter>session.gc_maxlifetime</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.gc_maxlifetime</literal> okre¶la liczbê sekund, po których dane zostan± uznane za "¶mieci" i sprz±tniête. </simpara> <note> <simpara> Je¶li u¿ywany jest domy¶lny podsystem obs³ugi sesji oparty na plikach, system plików musi ¶ledziæ czasy dostêpu (atime). System plików FAT u¿ywany w systemie Windows nie przechowuje takich informacji, a wiêc niezbêdne jest zapewnienie innego sposobu sprz±tania ¶mieci sesji, je¶li nie ma mo¿liwo¶ci u¿ywania systemu innego ni¿ FAT czy inny system plików który nie ¶ledzi czasu dostêpu. Od PHP 4.2.3 u¿ywany jest mtime (czas modyfikacji) zamiast atime. W zwi±zku z tym systemy plików nie ¶ledz±ce atime nie bêd± sprawia³y problemów. </simpara> </note> </listitem> </varlistentry> <varlistentry id="ini.session.referer-check"> <term> <parameter>session.referer_check</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.referer_check</literal> zawiera element ci±gu tekstowego, który ma byæ sprawdzany w polu HTTP Referer. Je¶li klient wys³a³ na g³ówek Referer a podany element ci±gu nie zosta³ w nim znaleziony, to identyfikator sesji zostanie oznaczony jako nieprawid³owy. Domy¶lna warto¶æ to pusty ci±g. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.entropy-file"> <term> <parameter>session.entropy_file</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.entropy_file</literal> okre¶la ¶cie¿kê do zewnêtrznego zasobu (pliku), który zostanie u¿yty jako dodatkowe ¼ród³o entropii przy generowaniu identyfikatora sesji. Przyk³adowo mo¿e to byæ <literal>/dev/random</literal> lub <literal>/dev/urandom</literal>, które s± dostêpne na wielu systemach Uniksowych. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.entropy-length"> <term> <parameter>session.entropy_length</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.entropy_length</literal> okre¶la liczbê bajtów, która zostanie odczytana z pliku podanego wy¿ej. Domy¶lna warto¶æ to <literal>0</literal> (wy³±czone). </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.use-cookies"> <term> <parameter>session.use_cookies</parameter> <type>boolean</type> </term> <listitem> <simpara> <literal>session.use_cookies</literal> okre¶la czy modu³ bêdzie u¿ywa³ ciasteczek do przechowywania identyfikatora sesji po stronie klienta. Domy¶lna warto¶æ to <literal>1</literal> (w³±czone). </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.use-only-cookies"> <term> <parameter>session.use_only_cookies</parameter> <type>boolean</type> </term> <listitem> <simpara> <literal>session.use_only_cookies</literal> okre¶la czy modu³ bêdzie u¿ywa³ <emphasis role="strong">tylko</emphasis> ciasteczek do przechowywania identyfikatora sesji po stronie klienta. Domy¶lna warto¶æ to cookies to store the session id on the client side. Defaults <literal>0</literal> (wy³±czone, dla kompatybilno¶ci wstecznej). W³±czenie tej opcji zapobiega atakom zwi±zanym z przekazywaniem identyfikatorów sesji w URLach. To ustawienie zosta³o dodane w PHP 4.3.0. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.cookie-lifetime"> <term> <parameter>session.cookie_lifetime</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.cookie_lifetime</literal> okre¶la czas ¿ycia ciasteczka w sekundach, co zostanie przekazane do przegl±darki. Warto¶æ 0 oznacza "dopóki przegl±darka nie zostanie zamkniêta". Domy¶lna warto¶æ to <literal>0</literal>. Patrz tak¿e: <function>session_get_cookie_params</function> i <function>session_set_cookie_params</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.cookie-path"> <term> <parameter>session.cookie_path</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.cookie_path</literal> okre¶la ¶cie¿kê u¿yt± do ustawienia ciasteczka sesyjnego. Domy¶lna warto¶æ to <literal>/</literal>. Patrz tak¿e: <function>session_get_cookie_params</function> i <function>session_set_cookie_params</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.cookie-domain"> <term> <parameter>session.cookie_domain</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.cookie_domain</literal> okre¶la domenê u¿yt± do ustawienia ciasteczka sesyjnego. Domy¶lna warto¶æ to brak domeny. Patrz tak¿e: <function>session_get_cookie_params</function> i <function>session_set_cookie_params</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.cookie-secure"> <term> <parameter>session.cookie_secure</parameter> <type>boolean</type> </term> <listitem> <simpara> <literal>session.cookie_secure</literal> Okre¶la czy ciasteczko powinno byæ przes³ane tylko poprzez bezpieczne po³±czenie. Domy¶lna warto¶æ to <literal>off</literal> (wy³±czone). Ta opcja zosta³a dodana w PHP 4.0.4. Patrz tak¿e: <function>session_get_cookie_params</function> i <function>session_set_cookie_params</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.cache-limiter"> <term> <parameter>session.cache_limiter</parameter> <type>string</type> </term> <listitem> <simpara> <literal>session.cache_limiter</literal> okre¶la metodê kontroli pamiêci podrêcznej u¿yt± dla stron sesyjnych (dopuszczalne warto¶ci to none, nocache, private, private_no_expire, public). Domy¶lna warto¶æ to <literal>nocache</literal>. Patrz tak¿e: <function>session_cache_limiter</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.cache-expire"> <term> <parameter>session.cache_expire</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.cache_expire</literal> okre¶la czas ¿ycia zbuforowanych stron sesyjnych, okre¶lony w minutach (nie ma to efektu dla ogranicznika nocache). Domy¶lna warto¶æ to <literal>180</literal>. Patrz tak¿e: <function>session_cache_expire</function>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.use-trans-sid"> <term> <parameter>session.use_trans_sid</parameter> <type>boolean</type> </term> <listitem> <simpara> <literal>session.use_trans_sid</literal> okre¶la, czy w³±czona jest obs³uga przezroczystego przekazywania identyfikatora sesji. Domy¶lna warto¶æ to <literal>0</literal> (wy³±czone). </simpara> <note> <simpara> W PHP 4.1.2 i starszych, opcja ta by³a w³±czana przez kompilacjê z parametrem <link linkend="configure.enable-trans-sid"> <literal>--enable-trans-sid</literal></link>. Od PHP 4.2.0, trans-sid jest domy¶lnie wkompilowywane. </simpara> <simpara> Zarz±dzanie sesjami oparte na URLu niesie za sob± wiêcej zagro¿eñ bezpieczeñstwa w stosunku do zarz±dzania opartego o ciasteczka. U¿ytkownicy mog± wysy³aæ emailem do swoich przyjació³ URLe zawieraj±ce identyfikatory sesji, lub te¿ zapisywaæ je do zak³adek i ³±czyæ siê z danym serwerem zawsze przy u¿yciu tego samego identyfikatora. </simpara> </note> </listitem> </varlistentry> <varlistentry id="ini.session.bug-compat-42"> <term> <parameter>session.bug_compat_42</parameter> <type>boolean</type> </term> <listitem> <simpara> PHP 4.2.0 i starsze mia³y nieudokumentowan± opcjê/b³±d, która pozwala³a na inicjalizacjê zmiennej sesyjnej w zasiêgu globalnym pomimo wy³±czenia <link linkend="ini.register-globals">register_globals</link>. PHP 4.3.0 i nowsze ostrzeg±, je¶li ta opcja, a tak¿e <link linkend="ini.session.bug-compat-warn">session.bug_compat_warn</link> s± w³±czone. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.bug-compat-warn"> <term> <parameter>session.bug_compat_warn</parameter> <type>boolean</type> </term> <listitem> <simpara> PHP 4.2.0 i starsze mia³y nieudokumentowan± opcjê/b³±d, która pozwala³a na inicjalizacjê zmiennej sesyjnej w zasiêgu globalnym pomimo wy³±czenia <link linkend="ini.register-globals">register_globals</link>. PHP 4.3.0 i nowsze ostrzeg±, je¶li ta opcja, a tak¿e <link linkend="ini.session.bug-compat-warn">session.bug_compat_42</link> s± w³±czone. session.bug_compat_warn</link>. </simpara> </listitem> </varlistentry> <varlistentry id="ini.session.hash-function"> <term> <parameter>session.hash_function</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.hash_function</literal> pozwala na okre¶lenie algorytmu skrótu, który zostanie u¿yty do generowania identyfikatora sesji. '0' oznacza MD5 (128 bitów) a '1' oznacza SHA-1 (160 bitów). </simpara> <note> <para> Ta opcja zosta³a dodana w PHP 5. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.session.hash-bits-per-character"> <term> <parameter>session.hash_bits_per_character</parameter> <type>integer</type> </term> <listitem> <simpara> <literal>session.hash_bits_per_character</literal> pozwala na okre¶lenie ile bitów jest przechowywanych w ka¿dym znaku przy konwersji danych binarnych na postaæ odczytywaln±. Dopuszczalne warto¶ci to '4' (0-9, a-f), '5' (0-9, a-v) i '6' (0-9, a-z, A-Z, "-", ","). </simpara> <note> <para> Ta opcja zosta³a dodana w PHP 5. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.url-rewriter.tags"> <term> <parameter>url_rewriter.tags</parameter> <type>string</type> </term> <listitem> <simpara> <literal>url_rewriter.tags</literal> okre¶la które znaczniki HTML s± przepisywane w celu dodania identyfikatora sesji je¶li w³±czona jest opcja przezroczystego przekazywania identyfikatora. Domy¶lna warto¶æ to <literal>a=href,area=href,frame=src,input=src,form=fakeentry,fieldset=</literal> </simpara> <note> <simpara> Aby uzyskaæ zgodno¶æ z XHTML, nale¿y usun±æ wpis <literal>form</literal> i u¿yæ znaczników <fieldset> wokó³ pól formularza. </simpara> </note> </listitem> </varlistentry> </variablelist> </para> <para> Opcje <link linkend="ini.track-vars"><literal>track_vars</literal></link> i <link linkend="ini.register-globals"><literal>register_globals</literal></link> wp³ywaj± na sposób zapisywania i odczytywania zmiennych sesyjnych. </para> <note> <para> Od wersji PHP 4.0.3 opcja <link linkend="ini.track-vars"><literal>track_vars</literal></link> jest zawsze w³±czona. </para> </note> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->