cvs: phpdoc-ru /appendices filters.xml ini.xml

freespace Sun Mar 6 09:57:10 2005 EDT Modified files: /phpdoc-ru/appendices filters.xml ini.xml Log: Sync with en.

http://cvs.php.net/diff.php/phpdoc-ru/appendices/filters.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-ru/appendices/filters.xml diff -u phpdoc-ru/appendices/filters.xml:1.2 phpdoc-ru/appendices/filters.xml:1.3 --- phpdoc-ru/appendices/filters.xml:1.2 Wed Feb 16 12:09:18 2005 +++ phpdoc-ru/appendices/filters.xml Sun Mar 6 09:57:08 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="windows-1251"?> -<!-- EN-Revision: 1.13 Maintainer: freespace Status: ready --> -<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.14 Maintainer: freespace Status: ready --> +<!-- $Revision: 1.3 $ --> <appendix id="filters"> <title>Ñïèñîê äîñòóïíûõ ôèëüòðîâ</title> <para> @@ -233,13 +233,13 @@ <title>Êîìïðåññèîííûå ôèëüòðû</title> <simpara> -  òî âðåìÿ, êàê <xref linkend="wrappers.compression"/> îáåñïå÷èâàåò ñïîñîá - ñîçäàíèÿ gzip- è bz2-ñîâìåñòèìûõ ôàéëîâ â ëîêàëüíîé ôàéëîâîé ñèñòåìå, - îíè (???) íå ïðåäîñòàâëÿþò (???) îáùèõ ñðåäñòâ ñðåäñòâ äëÿ êîìïðåññèè â ñåòåâûõ - ïîòîêàõ, êàê íå ïðåäîñòàâëÿþò è ñðåäñòâ äëÿ ñîçäàíèÿ ïîòîêà áåç êîìïðåññèè - ñ ïîñëåäóþùèì ïðåâðàùåíèåì â êîìïðåññèðóåìûé. - Äëÿ ýòèõ öåëåé ê ëþáûì ïîòîêîâûì ðåñóðñàì â ëþáîå âðåìÿ ìîãóò ïðèìåíÿòüñÿ - êîìïðåññèîííûå ôèëüòðû. +  òî âðåìÿ, êàê <link linkend="wrappers.compression">Êîìïðåññèîííûå + îáâ¸ðòêè</link> îáåñïå÷èâàþò ñïîñîá ñîçäàíèÿ gzip- è bz2-ñîâìåñòèìûõ + ôàéëîâ â ëîêàëüíîé ôàéëîâîé ñèñòåìå, îíè íå ïðåäîñòàâëÿþò îáùèõ ñðåäñòâ + ñðåäñòâ äëÿ êîìïðåññèè â ñåòåâûõ ïîòîêàõ, êàê íå ïðåäîñòàâëÿþò è ñðåäñòâ + äëÿ ñîçäàíèÿ ïîòîêà áåç êîìïðåññèè ñ ïîñëåäóþùèì ïðåâðàùåíèåì â + êîìïðåññèðóåìûé. Äëÿ ýòèõ öåëåé ê ëþáûì ïîòîêîâûì ðåñóðñàì â ëþáîå âðåìÿ + ìîãóò ïðèìåíÿòüñÿ êîìïðåññèîííûå ôèëüòðû. </simpara> <note> @@ -293,11 +293,11 @@ <simpara> Êîìïðåññèîííûå ôèëüòðû zlib.* äîñòóïíû ñ âåðñèè PHP <literal>5.1.0</literal>, åñëè âêëþ÷åíà ïîääåðæêà - <xref linkend="ref.zlib"/> (???). Îíè òàê æå äîñòóïíû â êà÷åñòâå + <link linkend="ref.zlib">zlib</link>. Îíè òàê æå äîñòóïíû â êà÷åñòâå îáðàòíîãî ïîðòà äëÿ âåðñèé <literal>5.0.x</literal> ïóò¸ì óñòàíîâêè ïàêåòà <ulink url="&url.pecl.package;zlib_filter">zlib_filter</ulink> - èç <ulink url="&url.pecl;">PECL</ulink>. Ýòè ôèëüòðû <emphasis>íå</emphasis> - äîñòóïíû â PHP 4. + èç <ulink url="&url.pecl;">PECL</ulink>. + Ýòè ôèëüòðû <emphasis>íå</emphasis> äîñòóïíû â PHP 4. </simpara> <example> @@ -399,11 +399,11 @@ <simpara> Êîìïðåññèîííûå ôèëüòðû bzip2.* äîñòóïíû ñ âåðñèè PHP <literal>5.1.0</literal>, åñëè âêëþ÷åíà ïîääåðæêà - <xref linkend="ref.bzip2"/> (???). Îíè òàê æå äîñòóïíû â êà÷åñòâå + <link linkend="ref.bzip2">bz2</link>. Îíè òàê æå äîñòóïíû â êà÷åñòâå îáðàòíîãî ïîðòà äëÿ âåðñèé <literal>5.0.x</literal> ïóò¸ì óñòàíîâêè ïàêåòà <ulink url="&url.pecl.package;bz2_filter">bz2_filter</ulink> - èç <ulink url="&url.pecl;">PECL</ulink>. Ýòè ôèëüòðû <emphasis>íå</emphasis> - äîñòóïíû â PHP 4. + èç <ulink url="&url.pecl;">PECL</ulink>. + Ýòè ôèëüòðû <emphasis>íå</emphasis> äîñòóïíû â PHP 4. </simpara> <example> @@ -436,6 +436,121 @@ </programlisting> </example> </section> + + <section id="filters.encryption"> + <title>Øèôðóþùèå ôèëüòðû</title> + + <simpara> + <literal>mcrypt.*</literal> è <literal>mdecrypt.*</literal> + îáåñïå÷èâàþò ñèììåòðè÷åñêîå øèôðîâàíèå è äåøèôðîâàíèå ïðè ïîìîùè + libmcrypt. Îáà íàáîðà ôèëüòðîâ ïîääåðæèâàþò òå æå àëãîðèòìû, ÷òî è + <link linkend="ref.mcrypt">ðàñøèðåíèå mcrypt</link> â âèäå + <literal>mcrypt.ciphername</literal>, ãäå + <parameter>ciphername</parameter> - ýòî íàçâàíèå øèôðà, êàê åñëè + áû îíî ïåðåäàâàëîñü ôóíêöèè <function>mcrypt_module_open</function>. + Òàêæå äîñòóïíû ñëåäóþùèå ïÿòü ïàðàìåòðîâ: + </simpara> + + <para> + <table> + <title>Ïàðàìåòðû ôèëüòðà mcrypt</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Ïàðàìåòð</entry> + <entry>Îáÿçàòåëåí?</entry> + <entry>Ïî óìîë÷àíèþ</entry> + <entry>Ïðèìåð çíà÷åíèÿ</entry> + </row> + </thead> + <tbody> + <row> + <entry>mode</entry> + <entry>Íåò</entry> + <entry>cbc</entry> + <entry>cbc, cfb, ecb, nofb, ofb, stream</entry> + </row> + <row> + <entry>algorithms_dir</entry> + <entry>Íåò</entry> + <entry>ini_get('mcrypt.algorithms_dir')</entry> + <entry>Ïóòü ê ìîäóëÿì àëãîðèòìîâ</entry> + </row> + <row> + <entry>modes_dir</entry> + <entry>Íåò</entry> + <entry>ini_get('mcrypt.modes_dir')</entry> + <entry>Ïóòü ê ìîäóëÿì ðåæèìîâ</entry> + </row> + <row> + <entry>iv</entry> + <entry>Äà</entry> + <entry>N/A</entry> + <entry>Îáû÷íî 8, 16 èëè 32 áàéòà áèíàðíûõ äàííûõ. Çàâèñèò îò øèôðà</entry> + </row> + <row> + <entry>key</entry> + <entry>Äà</entry> + <entry>N/A</entry> + <entry>Îáû÷íî 8, 16 èëè 32 áàéòà áèíàðíûõ äàííûõ. Çàâèñèò îò øèôðà</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + + <example> + <title>Øèôðîâàíèå âûâîäà â ôàéë èñïîëüçóÿ 3DES</title> + <programlisting role="php"> +<![CDATA[ +<?php +$passphrase = 'My secret'; + +/* Turn a human readable passphrase + * into a reproducable iv/key pair + */ +$iv = substr(md5('iv'.$passphrase, true), 0, 8); +$key = substr(md5('pass1'.$passphrase, true) . + md5('pass2'.$passphrase, true), 0, 24); +$opts = array('iv'=>$iv, 'key'=>$key); + +$fp = fopen('secert-file.enc', 'wb'); +stream_filter_append($fp, 'mcrypt.tripledes', STREAM_FILTER_WRITE, $opts); +fwrite($fp, 'Secret secret secret data'); +fclose($fp); +?> +]]> + </programlisting> + </example> + + <example> + <title>×òåíèå çàøèôðîâàííîãî ôàéëà</title> + <programlisting role="php"> +<![CDATA[ +<?php +$passphrase = 'My secret'; + +/* Turn a human readable passphrase + * into a reproducable iv/key pair + */ +$iv = substr(md5('iv'.$passphrase, true), 0, 8); +$key = substr(md5('pass1'.$passphrase, true) . + md5('pass2'.$passphrase, true), 0, 24); +$opts = array('iv'=>$iv, 'key'=>$key); + +$fp = fopen('secert-file.enc', 'rb'); +stream_filter_append($fp, 'mdecrypt.tripledes', STREAM_FILTER_WRITE, $opts); +$data = rtrim(stream_get_contents($fp)); +fclose($fp); + +echo $data; +?> +]]> + </programlisting> + </example> + + </section> + </appendix> <!-- Keep this comment at the end of the file http://cvs.php.net/diff.php/phpdoc-ru/appendices/ini.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-ru/appendices/ini.xml diff -u phpdoc-ru/appendices/ini.xml:1.2 phpdoc-ru/appendices/ini.xml:1.3 --- phpdoc-ru/appendices/ini.xml:1.2 Wed Feb 23 15:30:03 2005 +++ phpdoc-ru/appendices/ini.xml Sun Mar 6 09:57:08 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="windows-1251"?> -<!-- EN-Revision: 1.11 Maintainer: freespace Status: ready --> -<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.13 Maintainer: freespace Status: ready --> +<!-- $Revision: 1.3 $ --> <appendix id="ini"> <title>Äèðåêòèâû &php.ini;</title> @@ -193,7 +193,7 @@ <entry>Äîñòóïíà ñ âåðñèè PHP 4.3.0.</entry> </row> <row> - <entry>auto_globals_jit</entry> + <entry><link linkend="ini.auto-globals-jit">auto_globals_jit</link></entry> <entry>"1"</entry> <entry>PHP_INI_PERDIR</entry> <entry>Äîñòóïíà ñ âåðñèè PHP 5.0.0.</entry> @@ -2345,6 +2345,10 @@ Âêëþ÷àåò ðåæèì ñîâìåñòèìîñòè ñ Zend Engine 1 (PHP 4). Ýòî âëèÿåò íà êëîíèðîâàíèå, ïðèâåäåíèå òèïîâ è ñðàâíåíèå îáúåêòîâ. </para> + <para> + Ñì. òàêæå ðàçäåë + <link linkend="migration5">Ìèãðàöèÿ èç PHP 4 â PHP 5</link>. + </para> </listitem> </varlistentry> </variablelist> @@ -2600,6 +2604,28 @@ </para> </listitem> </varlistentry> + + <varlistentry id="ini.auto-globals-jit"> + <term> + <parameter>auto_globals_jit</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Êîãäà âêëþ÷åíî, ïåðåìåííûå SERVER è ENV ñîçäàþòñÿ â òîò ìîìåíò, + êîãäà îíè âïåðâûå èñïîëüçóþòñÿ (Just In Time), à íå â íà÷àëå + âûïîëíåíèÿ ñêðèïòà. Åñëè ýòè ïåðåìåííûå â ñêðèïòå íå èñïîëüçóþòñÿ, + âêëþ÷åíèå ýòîé äèðåêòèâû ïðèâåä¸ò ê ðîñòó ïðîèçâîäèòåëüíîñòè. + </para> + <para> + Äèðåêòèâû PHP + <link linkend="ini.register-globals">register_globals</link>, + <link linkend="ini.register-long-arrays">register_long_arrays</link> è + <link linkend="ini.register-argc-argv">register_argc_argv</link> + äîëæíû áûòü âûêëþ÷åíû äëÿ òîãî, ÷òîáû ýòà äèðåêòèâà ðàáîòàëà. + </para> + </listitem> + </varlistentry> <varlistentry id="ini.register-globals"> <term>