cvs: phpdoc-ru / translation.xml /appendices filters.xml
| From: | George Miroshnikov | Date: | Wed, 09 Feb 2005 18:17:22 +0000 |
| Subject: | cvs: phpdoc-ru / translation.xml /appendices filters.xml | ||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-599@lists.php.net to get a copy of this message | ||
freespace Wed Feb 9 13:17:22 2005 EDT
Added files:
/phpdoc-ru/appendices filters.xml
Modified files:
/phpdoc-ru translation.xml
Log:
Unassigned ftp reference from myself.
Added newly translated file.
http://cvs.php.net/diff.php/phpdoc-ru/translation.xml?r1=1.37&r2=1.38&ty=u Index: phpdoc-ru/translation.xml diff -u phpdoc-ru/translation.xml:1.37 phpdoc-ru/translation.xml:1.38 --- phpdoc-ru/translation.xml:1.37 Mon Jan 31 12:04:50 2005 +++ phpdoc-ru/translation.xml Wed Feb 9 13:17:22 2005 @@ -26,7 +26,6 @@ <file name="chapters/config.xml" person="alexws" type="translation" /> <file name="reference/sqlite/*" person="blindman" type="translation" /> <file name="reference/ctype/*" person="venya" type="translation" /> - <file name="reference/ftp/functions/*" person="freespace" type="translation" /> <file name="reference/array/*" person="sveta" type="translation" /> </work-in-progress> http://cvs.php.net/co.php/phpdoc-ru/appendices/filters.xml?r=1.1&p=1 Index: phpdoc-ru/appendices/filters.xml +++ phpdoc-ru/appendices/filters.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.12 Maintainer: freespace Status: ready --> <!-- $Revision: 1.1 $ --> <appendix id="filters"> <title>Ñïèñîê äîñòóïíûõ ôèëüòðîâ</title> <para> Ñëåäóþùèé ñïèñîê ïåðå÷èñëÿåò íåñêîëüêî âñòðîåííûõ ôèëüòðîâ äëÿ èñïîëüçîâàíèÿ ñ <function>stream_filter_append</function>. Âàøà âåðñèÿ PHP ìîæåò âêëþ÷àòü áîëüøå (èëè ìåíüøå) ôèëüòðîâ, ÷åì ïåðå÷èñëåíî çäåñü. </para> <para> Ñëåäóåò àêöåíòèðîâàòü âíèìàíèå íà îïðåäåë¸ííîé àñèììåòðè÷íîñòè ôóíêöèé <function>stream_filter_append</function> è <function>stream_filter_prepend</function>. Êàæäûé ïîòîê â PHP èìååò íåáîëüøîé <emphasis>áóôåð ÷òåíèÿ</emphasis>, â êîòîðîì îí õðàíèò áëîêè äàííûõ, ïîëó÷åííûå èç ôàéëîâîé ñèñòåìû èëè äðóãîãî ðåñóðñà, äëÿ òîãî ÷òîáû îáðàáàòûâàòü äàííûå íàèáîëåå ýôôåêòèâíûì îáðàçîì. Êàê òîëüêî äàííûå ïåðåíîñÿòñÿ èç ðåñóðñà âî âíóòðåííèé áóôåð ïîòîêà, îíè ñðàçó æå îáðàáàòûâàþòñÿ çàêðåïë¸ííûìè çà ïîòîêîì ôèëüòðàìè, íåçàâèñèìî îò òîãî, ãîòîâî ëè ïðèëîæåíèå PHP ïðèíèìàòü äàííûå èëè íåò. Åñëè äàííûå íàõîäÿòñÿ â áóôåðå ÷òåíèÿ â ìîìåíò, êîãäà â ôèëüòð ÷òî-òî <emphasis>äîïèñûâàþò â êîíåö</emphasis>, äàííûå áóäóò íåìåäëåííî îáðàáîòàíû ýòèì ôèëüòðîì, òàêèì îáðàçîì èõ íàõîæäåíèå â áóôåðå áóäåò ïðîçðà÷íûì.  òî æå âðåìÿ, åñëè äàííûå íàõîäÿòñÿ â áóôåðå â ìîìåíò, êîãäà â ôèëüòð ÷òî-òî <emphasis>äîïèñûâàþò â íà÷àëî</emphasis>, äàííûå <emphasis>ÍÅ</emphasis> áóäóò îáðàáîòàíû ýòèì ôèëüòðîì. Âìåñòî ýòîãî, îíè áóäóò æäàòü ìîìåíòà, êîãäà ñëåäóþùèé áëîê äàííûõ áóäåò ïîëó÷åí èç ðåñóðñà. </para> <para> Äëÿ ïîëó÷åíèÿ ñïèñêà ôèëüòðîâ, óñòàíîâëåííûõ â âàøó âåðñèþ PHP, èñïîëüçóéòå ôóíêöèþ <function>stream_get_filters</function>. </para> <section id="filters.string"> <title>Ñòðîêîâûå ôèëüòðû</title> <simpara> Âñå ýòè ôèëüòðû ñëóæàò äëÿ òîãî ñàìîãî, ÷òî ïîäðàçóìåâàþò èõ èìåíà â ñîîòâåòñâèè ñ ïîâåäåíèåì âñòðîåííûõ â PHP ôóíêöèé äëÿ ðàáîòû ñî ñòðîêàìè. Äëÿ ïîëó÷åíèÿ äîïîëíèòåëüíîé èíôîðìàöèè î êîíêðåòíîì ôèëüòðå, îáðàòèòåñü ê ñòðàíèöå ðóêîâîäñòâà ñîîòâåòñòâóþùåé ôóíêöèè. </simpara> <simpara> <literal>string.rot13</literal> (ñ âåðñèè PHP 4.3.0) Èñïîëüçîâàíèå ýòîãî ôèëüòðà ýêâèâàëåíòíî îáðàáîòêå âñåõ äàííûõ ïîòîêà ôóíêöèåé <function>str_rot13</function>. </simpara> <example> <title>string.rot13</title> <programlisting role="php"> <![CDATA[ <?php $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'string.rot13'); fwrite($fp, "This is a test.\n"); /* Outputs: Guvf vf n grfg. */ ?> ]]> </programlisting> </example> <simpara> <literal>string.toupper</literal> (ñ âåðñèè PHP 5.0.0) Èñïîëüçîâàíèå ýòîãî ôèëüòðà ýêâèâàëåíòíî îáðàáîòêå âñåõ äàííûõ ïîòîêà ôóíêöèåé <function>strtoupper</function>. </simpara> <example> <title>string.toupper</title> <programlisting role="php"> <![CDATA[ <?php $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'string.toupper'); fwrite($fp, "This is a test.\n"); /* Outputs: THIS IS A TEST. */ ?> ]]> </programlisting> </example> <simpara> <literal>string.tolower</literal> (ñ âåðñèè PHP 5.0.0) Èñïîëüçîâàíèå ýòîãî ôèëüòðà ýêâèâàëåíòíî îáðàáîòêå âñåõ äàííûõ ïîòîêà ôóíêöèåé <function>strtolower</function>. </simpara> <example> <title>string.tolower</title> <programlisting role="php"> <![CDATA[ <?php $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'string.tolower'); fwrite($fp, "This is a test.\n"); /* Outputs: this is a test. */ ?> ]]> </programlisting> </example> <simpara> <literal>string.strip_tags</literal> (ñ âåðñèè PHP 5.0.0) Èñïîëüçîâàíèå ýòîãî ôèëüòðà ýêâèâàëåíòíî îáðàáîòêå âñåõ äàííûõ ïîòîêà ôóíêöèåé <function>strip_tags</function>. Îí ïðèíèìàåò àðãóìåíòû â îäíîé èç äâóõ ôîðì: Ëèáî â âèäå ñòðîêè ñî ñïèñêîì òåãîâ, êàê è âòîðîé àðãóìåíò ôóíêöèè <function>strip_tags</function>, ëèáî ìàññèâ íàçâàíèé òåãîâ. </simpara> <example> <title>string.strip_tags</title> <programlisting role="php"> <![CDATA[ <?php $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'string.strip_tags', STREAM_FILTER_WRITE, "<b><i><u>"); fwrite($fp, "<b>bolded text</b> enlarged to a <h1>level 1 heading</h1>\n"); fclose($fp); /* Outputs: <b>bolded text</b> enlarged to a level 1 heading */ $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'string.strip_tags', STREAM_FILTER_WRITE, array('b','i','u')); fwrite($fp, "<b>bolded text</b> enlarged to a <h1>level 1 heading</h1>\n"); fclose($fp); /* Outputs: <b>bolded text</b> enlarged to a level 1 heading */ ?> ]]> </programlisting> </example> </section> <section id="filters.convert"> <title>Ïðåîáðàçîâûâàþùèå ôèëüòðû</title> <simpara> Êàê è ôèëüòðû string.*, ôèëüòðû convert.* ñîâåðøàþò äåéñòâèÿ, ñîîòâåòñòâóþùèå èõ èìåíàì. Ïðåîáðàçîâûâàþùèå ôèëüòðû áûëè äîáàâëåíû â PHP 5.0.0. Äëÿ ïîëó÷åíèÿ äîïîëíèòåëüíîé èíôîðìàöèè î êîíêðåòíîì ôèëüòðå, îáðàòèòåñü ê ñòðàíèöå ðóêîâîäñòâà ñîîòâåòñòâóþùåé ôóíêöèè. </simpara> <simpara> <literal>convert.base64-encode</literal> è <literal>convert.base64-decode</literal> Èñïîëüçîâàíèå ýòèõ ôèëüòðîâ ýêâèâàëåíòíî îáðàáîòêå âñåõ äàííûõ ïîòîêà ôóíêöèÿìè <function>base64_encode</function> è <function>base64_decode</function> ñîîòâåòñòâåííî. <literal>convert.base64-encode</literal> ïîääåðæèâàåò àðãóìåíòû, ïåðåäàííûå â âèäå àññîöèàòèâíîãî ìàññèâà. Åñëè óêàçàí àðãóìåíò <parameter>line-length</parameter>, ðåçóëüòàò base64 áóäåò ðàçäåë¸í íà êóñêè äëèííîé <parameter>line-length</parameter> ñèìâîëîâ êàæäûé. Åñëè óêàçàí àðãóìåíò <parameter>line-break-chars</parameter>, êàæäûé êóñîê áóäåò ðàçäåë¸í óêàçàííûìè ñèìâîëàìè. Ýòè ïàðàìåòðû äàþò òàêîé æå ýôôåêò, êàê è èñïîëüçîâàíèå <function>base64_encode</function> â ïàðå ñ <function>chunk_split</function>. </simpara> <example> <title>convert.base64-encode è convert.base64-decode</title> <programlisting role="php"> <![CDATA[ <?php $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'convert.base64-encode'); fwrite($fp, "This is a test.\n"); fclose($fp); /* Outputs: VGhpcyBpcyBhIHRlc3QuCg== */ $param = array('line-length' => 8, 'line-break-chars' => "\r\n"); $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'convert.base64-encode', STREAM_FILTER_WRITE, $param); fwrite($fp, "This is a test.\n"); fclose($fp); /* Outputs: VGhpcyBp : cyBhIHRl : c3QuCg== */ $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'convert.base64-decode'); fwrite($fp, "VGhpcyBpcyBhIHRlc3QuCg=="); fclose($fp); /* Outputs: This is a test. */ ?> ]]> </programlisting> </example> <simpara> <literal>convert.quoted-printable-encode</literal> è <literal>convert.quoted-printable-decode</literal> Èñïîëüçîâàíèå decode-âåðñèè ýòîãî ôèëüòðà ýêâèâàëåíòíî îáðàáîòêå âñåõ äàííûõ ïîòîêà ôóíêöèåé <function>quoted_printable_decode</function>. Ó ôèëüòðà <literal>convert.quoted-printable-encode</literal> íåòó ýêâèâàëåíòíîé ôóíêöèè. <literal>convert.quoted-printable-encode</literal> ïîääåðæèâàåò àðãóìåíòû, ïåðåäàííûå â âèäå àññîöèàòèâíîãî ìàññèâà.  äîïîëíåíèå ê àðãóìåíòàì, ïîääåðæèâàåìûìè <literal>convert.base64-encode</literal>, <literal>convert.quoted-printable-encode</literal> òàêæå ïîääåðæèâàåò boolean-àðãóìåíòû <parameter>binary</parameter> è <parameter>force-encode-first</parameter>. <literal>convert.base64-decode</literal> ïîääåðæèâàåò ëèøü àðãóìåíò <parameter>line-break-chars</parameter> â êà÷åñòâå ïîäñêàçêè äëÿ ÷èñòêè çàêîäèðîâàííûõ äàííûõ. </simpara> <example> <title> convert.quoted-printable-encode & convert.quoted-printable-decode </title> <programlisting role="php"> <![CDATA[ <?php $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'convert.quoted-printable-encode'); fwrite($fp, "This is a test.\n"); /* Outputs: =This is a test.=0A */ ?> ]]> </programlisting> </example> </section> <section id="filters.compression"> <title>Êîìïðåññèîííûå ôèëüòðû</title> <simpara>  òî âðåìÿ, êàê <xref linkend="wrappers.compression"/> îáåñïå÷èâàåò ñïîñîá ñîçäàíèÿ gzip- è bz2-ñîâìåñòèìûõ ôàéëîâ â ëîêàëüíîé ôàéëîâîé ñèñòåìå, îíè (???) íå ïðåäîñòàâëÿþò (???) îáùèõ ñðåäñòâ ñðåäñòâ äëÿ êîìïðåññèè â ñåòåâûõ ïîòîêàõ, êàê íå ïðåäîñòàâëÿþò è ñðåäñòâ äëÿ ñîçäàíèÿ ïîòîêà áåç êîìïðåññèè ñ ïîñëåäóþùèì ïðåâðàùåíèåì â êîìïðåññèðóåìûé. Äëÿ ýòèõ öåëåé ê ëþáûì ïîòîêîâûì ðåñóðñàì â ëþáîå âðåìÿ ìîãóò ïðèìåíÿòüñÿ êîìïðåññèîííûå ôèëüòðû. </simpara> <note> <simpara> Êîìïðåññèîííûå ôèëüòðû <emphasis>íå</emphasis> ãåíåðèðóþò çàãîëîâêîâ è îêîí÷àíèé, êîòîðûå èñïîëüçóþò óòèëèòû êîììàíäíîé ñòðîêè, òàêèå êàê <literal>gzip</literal>. Îíè ïðîñòî êîìïðåññèðóþò (ñæèìàþò) è äåêîìïðåññèðóþò (ðàçæèìàþò) ïîðöèè äàííûõ â êîìïðåññèðóåìîì ïîòîêå äàííûõ. </simpara> </note> <simpara> <literal>zlib.deflate</literal> (êîìïðåññèÿ) è <literal>zlib.inflate</literal> (äåêîìïðåññèÿ) ÿâëÿþòñÿ ðåàëèçàöèÿìè êîìïðåññèîííûõ ìåòîäîâ, îïèñàíûõ â <ulink url="&url.rfc;1951">RFC 1951</ulink>. Ôèëüòð <literal>deflate</literal> ïðèíèìàåò òðè àðãóìåíòà, ïåðåäàííûõ â âèäå àññîöèàòèâíîãî ìàññèâà. <parameter>level</parameter> îïðåäåëÿåò, êàêîé óðîâåíü êîìïðåññèè èñïîëüçîâàòü (1-9). Ïîâûøåíèå ýòîãî çíà÷åíèÿ ïðèâåä¸ò ê óìåíüøåíèþ îáú¸ìîâ äàííûõ çà ñ÷¸ò óâåëè÷åíèÿ âðåìåíè îáðàáîòêè. Ñóùåñòâóþò òàê æå äâà ñïåöèàëüíûõ óðîâíÿ êîìïðåññèè: 0 (äëÿ îòêëþ÷åíèÿ êîìïðåññèè) è -1 (âíóòðåííåå çíà÷åíèå ïî óìîë÷àíèþ áèáëèîòåêè zlib -- íà òåêóùèé ìîìåíò ðàâíî 6). <parameter>window</parameter> - ýòî ëîãàðèôì ðàçìåðà îêíà äèàïàçîíà ñæàòèÿ, ãäå áàçà ëîãàðèôìà ñîñòàâëÿåò 2. Âûñîêèå çíà÷åíèÿ (âïëîòü äî 15 -- 32768 áàéò) ïðèâîäÿò ê óëó÷øåíèþ êîìïðåññèè çà ñ÷¸ò ðîñòà íåîáõîäèìîé ïàìÿòè, â òî âðåìÿ êàê íèçêèå çíà÷åíèÿ (âïëîòü äë 9 -- 512 áàéò) ïðèâîäÿò ê óõóäøåíèþ êîìïðåññèè çà ñ÷¸ò óìåíüøåíèÿ íåîáõîäèìîé ïàìÿòè. Çíà÷åíèåì àðãóìåíòà <parameter>window</parameter> ïî óìîë÷àíèþ íà òåêóùèé ìîìåíò ÿâëÿåòñÿ <constant>15</constant>. <parameter>memory</parameter> îïðåäåëÿåò ìàñøòàá ðåçåðâèðóåìîé ïàìÿòè. Äîïóñòèìûå çíà÷åíèÿ íàõîäÿòñÿ â äèàïàçîíå îò 1 (ìèíèìàëüíîå ðåçåðâèðîâàíèå) äî 9 (ìàêñèìàëüíîå ðåçåðâèðîâàíèå). Òàêîå ðåçåðâèðîâàíèå ïàìÿòè âëèÿåò òîëüêî íà ñêîðîñòü è íå âëèÿåò íà ðàçìåð ãåíåðèðóåìûõ äàííûõ.. </simpara> <note> <simpara> Òàê êàê óðîâåíü êîìïðåññèè ÿâëÿåòñÿ íàèáîëåå ÷àñòî èñïîëüçóåìûì àðãóìåíòîì, âû ìîæåòå ïåðåäàòü òîëüêî åãî â êà÷åñòâå îáû÷íîãî öåëîãî ÷èñëà (integer), âìåñòî òîãî ÷òîáû ïåðåäàâàòü ìàññèâ èç îäíîãî ýëåìåíòà. </simpara> </note> <simpara> Êîìïðåññèîííûå ôèëüòðû zlib.* äîñòóïíû ñ âåðñèè PHP <literal>5.1.0</literal>, åñëè âêëþ÷åíà ïîääåðæêà <xref linkend="ref.zlib"/> (???). Îíè òàê æå äîñòóïíû â êà÷åñòâå îáðàòíîãî ïîðòà äëÿ âåðñèé <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. </simpara> <example> <title> <literal>zlib.deflate</literal> è <literal>zlib.inflate</literal> </title> <programlisting role="php"> <![CDATA[ <?php $params = array('level' => 6, 'window' => 15, 'memory' => 9); $original_text = "This is a test.\nThis is only a test.\nThis is not an important string.\n"; echo "The original text is " . strlen($original_text) . " characters long.\n"; $fp = fopen('test.deflated', 'w'); stream_filter_append($fp, 'zlib.deflate', STREAM_FILTER_WRITE, $params); fwrite($fp, $original_text); fclose($fp); echo "The compressed file is " . filesize('test.deflated') . " bytes long.\n"; echo "The original text was:\n"; /* Use readfile and zlib.inflate to decompress on the fly */ readfile('php://filter/zlib.inflate/resource=test.deflated'); /* Generates output: The original text is 70 characters long. The compressed file is 56 bytes long. The original text was: This is a test. This is only a test. This is not an important string. */ ?> ]]> </programlisting> </example> <example> <title> Óïðîù¸ííîå èñïîëüçîâàíèå <literal>zlib.deflate</literal> </title> <programlisting role="php"> <![CDATA[ <?php $original_text = "This is a test.\nThis is only a test.\nThis is not an important string.\n"; echo "The original text is " . strlen($original_text) . " characters long.\n"; $fp = fopen('test.deflated', 'w'); /* Here "6" indicates compression level 6 */ stream_filter_append($fp, 'zlib.deflate', STREAM_FILTER_WRITE, 6); fwrite($fp, $original_text); fclose($fp); echo "The compressed file is " . filesize('test.deflated') . " bytes long.\n"; /* Generates output: The original text is 70 characters long. The compressed file is 56 bytes long. */ ?> ]]> </programlisting> </example> <simpara> <literal>bzip2.compress</literal> è <literal>bzip2.decompress</literal> ðàáîòàþò òî÷íî òàê æå, êàê è ôèëüòðû zlib, îíèñàííûå âûøå. Ôèëüòð <literal>bzip2.compress</literal> ïðèíèìàåò äâà àðãóìåíòà â âèäå ýëåìåíòîâ àññîöèàòèâíîãî ìàññèâà: <parameter>blocks</parameter> ÿâëÿåòñÿ öåëî÷èñëåííûì (integer) çíà÷åíèåì â äèàïàçîíå îò 1 äî 9 è óêàçûâàåò íà êîëè÷åñòâî 100-êèëîáàéòîâûõ áëîêîâ ïàìÿòè äëÿ ðåçåðâèðîâàíèÿ â êà÷åñòâå ðàáî÷åãî ïðîñòðàíñòâà. <parameter>work</parameter> - ýòî òàê æå öåëî÷èñëåííîå (integer) çíà÷åíèå â äèàïàçîíå îò 0 äî 250, îïðåäåëÿþùåå ñêîëüêî óñèëèé íóæíî ïîòðàòèòü íà îáû÷íûé ìåòîä êîìïðåññèè ïåðåä ïåðåêëþ÷åíèåì íà ìåäëåííûé, íî áîëåå íà䏿íûé ìåòîä. Èçìåíåíèå ýòîãî ïàðàìåòðà âëèÿåò òîëüêî íà ñêîðîñòü êîìïðåññèè. Íè ðàçìåð ñæàòîãî ðåçóëüòàòà, íè èñïîëüçóåìûé îáú¸ì ïàìÿòè íå èçìåíÿþòñÿ ïðè ïîìîùè ýòîé íàñòðîéêè. Çíà÷åíèå 0 óêàçûâàåò áèáëèîòåêå bzip èñïîëüçîâàòü ñîáñòâåííîå âíóòðåííåå çíà÷åíèå ïî óìîë÷àíèþ. Ôèëüòð <literal>bzip2.decompress</literal> ïðèíèìàåò âñåãî îäèí àðãóìåíò, êîòîðûé ìîæåò áûòü ïåðåäàí ëèáî êàê îáû÷íîå boolean-çíà÷åíèå, ëèáî êàê ýëåìåíò <parameter>small</parameter> àññîöèàòèâíîãî ìàññèâà. Êîãäà <parameter>small</parameter> óñòàíîâëåí â &true;, áèáëèîòåêà bzip ñîâåðøèò äåêîìïðåññèþ ñ ìèíèìàëüíûì ðàñõîäîì ïàìÿòè çà ñ÷¸ò ïîíèæåíèÿ ñêîðîñòè. </simpara> <simpara> Êîìïðåññèîííûå ôèëüòðû bzip2.* äîñòóïíû ñ âåðñèè PHP <literal>5.1.0</literal>, åñëè âêëþ÷åíà ïîääåðæêà <xref linkend="ref.bzip2"/> (???). Îíè òàê æå äîñòóïíû â êà÷åñòâå îáðàòíîãî ïîðòà äëÿ âåðñèé <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. </simpara> <example> <title> <literal>bzip2.compress</literal> è <literal>bzip2.decompress</literal> </title> <programlisting role="php"> <![CDATA[ <?php $param = array('blocks' => 9, 'work' => 0); echo "The original file is " . filesize('LICENSE') . " bytes long.\n"; $fp = fopen('LICENSE.compressed', 'w'); stream_filter_append($fp, 'bzip2.compress', STREAM_FILTER_WRITE, $param); fwrite($fp, file_get_contents('LICENSE')); fclose($fp); echo "The compressed file is " . filesize('LICENSE.compressed') . " bytes long.\n"; /* Generates output: The original text is 3288 characters long. The compressed file is 1488 bytes long. */ ?> ]]> </programlisting> </example> </section> </appendix> <!-- 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/diff.php/phpdoc-ru/translation.xml?r1=1.37&r2=1.38&ty=u Index: phpdoc-ru/translation.xml diff -u phpdoc-ru/translation.xml:1.37 phpdoc-ru/translation.xml:1.38 --- phpdoc-ru/translation.xml:1.37 Mon Jan 31 12:04:50 2005 +++ phpdoc-ru/translation.xml Wed Feb 9 13:17:22 2005 @@ -26,7 +26,6 @@ <file name="chapters/config.xml" person="alexws" type="translation" /> <file name="reference/sqlite/*" person="blindman" type="translation" /> <file name="reference/ctype/*" person="venya" type="translation" /> - <file name="reference/ftp/functions/*" person="freespace" type="translation" /> <file name="reference/array/*" person="sveta" type="translation" /> </work-in-progress> http://cvs.php.net/co.php/phpdoc-ru/appendices/filters.xml?r=1.1&p=1 Index: phpdoc-ru/appendices/filters.xml +++ phpdoc-ru/appendices/filters.xml <?xml version="1.0" encoding="windows-1251"?> <!-- EN-Revision: 1.12 Maintainer: freespace Status: ready --> <!-- $Revision: 1.1 $ --> <appendix id="filters"> <title>Ñïèñîê äîñòóïíûõ ôèëüòðîâ</title> <para> Ñëåäóþùèé ñïèñîê ïåðå÷èñëÿåò íåñêîëüêî âñòðîåííûõ ôèëüòðîâ äëÿ èñïîëüçîâàíèÿ ñ <function>stream_filter_append</function>. Âàøà âåðñèÿ PHP ìîæåò âêëþ÷àòü áîëüøå (èëè ìåíüøå) ôèëüòðîâ, ÷åì ïåðå÷èñëåíî çäåñü. </para> <para> Ñëåäóåò àêöåíòèðîâàòü âíèìàíèå íà îïðåäåë¸ííîé àñèììåòðè÷íîñòè ôóíêöèé <function>stream_filter_append</function> è <function>stream_filter_prepend</function>. Êàæäûé ïîòîê â PHP èìååò íåáîëüøîé <emphasis>áóôåð ÷òåíèÿ</emphasis>, â êîòîðîì îí õðàíèò áëîêè äàííûõ, ïîëó÷åííûå èç ôàéëîâîé ñèñòåìû èëè äðóãîãî ðåñóðñà, äëÿ òîãî ÷òîáû îáðàáàòûâàòü äàííûå íàèáîëåå ýôôåêòèâíûì îáðàçîì. Êàê òîëüêî äàííûå ïåðåíîñÿòñÿ èç ðåñóðñà âî âíóòðåííèé áóôåð ïîòîêà, îíè ñðàçó æå îáðàáàòûâàþòñÿ çàêðåïë¸ííûìè çà ïîòîêîì ôèëüòðàìè, íåçàâèñèìî îò òîãî, ãîòîâî ëè ïðèëîæåíèå PHP ïðèíèìàòü äàííûå èëè íåò. Åñëè äàííûå íàõîäÿòñÿ â áóôåðå ÷òåíèÿ â ìîìåíò, êîãäà â ôèëüòð ÷òî-òî <emphasis>äîïèñûâàþò â êîíåö</emphasis>, äàííûå áóäóò íåìåäëåííî îáðàáîòàíû ýòèì ôèëüòðîì, òàêèì îáðàçîì èõ íàõîæäåíèå â áóôåðå áóäåò ïðîçðà÷íûì.  òî æå âðåìÿ, åñëè äàííûå íàõîäÿòñÿ â áóôåðå â ìîìåíò, êîãäà â ôèëüòð ÷òî-òî <emphasis>äîïèñûâàþò â íà÷àëî</emphasis>, äàííûå <emphasis>ÍÅ</emphasis> áóäóò îáðàáîòàíû ýòèì ôèëüòðîì. Âìåñòî ýòîãî, îíè áóäóò æäàòü ìîìåíòà, êîãäà ñëåäóþùèé áëîê äàííûõ áóäåò ïîëó÷åí èç ðåñóðñà. </para> <para> Äëÿ ïîëó÷åíèÿ ñïèñêà ôèëüòðîâ, óñòàíîâëåííûõ â âàøó âåðñèþ PHP, èñïîëüçóéòå ôóíêöèþ <function>stream_get_filters</function>. </para> <section id="filters.string"> <title>Ñòðîêîâûå ôèëüòðû</title> <simpara> Âñå ýòè ôèëüòðû ñëóæàò äëÿ òîãî ñàìîãî, ÷òî ïîäðàçóìåâàþò èõ èìåíà â ñîîòâåòñâèè ñ ïîâåäåíèåì âñòðîåííûõ â PHP ôóíêöèé äëÿ ðàáîòû ñî ñòðîêàìè. Äëÿ ïîëó÷åíèÿ äîïîëíèòåëüíîé èíôîðìàöèè î êîíêðåòíîì ôèëüòðå, îáðàòèòåñü ê ñòðàíèöå ðóêîâîäñòâà ñîîòâåòñòâóþùåé ôóíêöèè. </simpara> <simpara> <literal>string.rot13</literal> (ñ âåðñèè PHP 4.3.0) Èñïîëüçîâàíèå ýòîãî ôèëüòðà ýêâèâàëåíòíî îáðàáîòêå âñåõ äàííûõ ïîòîêà ôóíêöèåé <function>str_rot13</function>. </simpara> <example> <title>string.rot13</title> <programlisting role="php"> <![CDATA[ <?php $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'string.rot13'); fwrite($fp, "This is a test.\n"); /* Outputs: Guvf vf n grfg. */ ?> ]]> </programlisting> </example> <simpara> <literal>string.toupper</literal> (ñ âåðñèè PHP 5.0.0) Èñïîëüçîâàíèå ýòîãî ôèëüòðà ýêâèâàëåíòíî îáðàáîòêå âñåõ äàííûõ ïîòîêà ôóíêöèåé <function>strtoupper</function>. </simpara> <example> <title>string.toupper</title> <programlisting role="php"> <![CDATA[ <?php $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'string.toupper'); fwrite($fp, "This is a test.\n"); /* Outputs: THIS IS A TEST. */ ?> ]]> </programlisting> </example> <simpara> <literal>string.tolower</literal> (ñ âåðñèè PHP 5.0.0) Èñïîëüçîâàíèå ýòîãî ôèëüòðà ýêâèâàëåíòíî îáðàáîòêå âñåõ äàííûõ ïîòîêà ôóíêöèåé <function>strtolower</function>. </simpara> <example> <title>string.tolower</title> <programlisting role="php"> <![CDATA[ <?php $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'string.tolower'); fwrite($fp, "This is a test.\n"); /* Outputs: this is a test. */ ?> ]]> </programlisting> </example> <simpara> <literal>string.strip_tags</literal> (ñ âåðñèè PHP 5.0.0) Èñïîëüçîâàíèå ýòîãî ôèëüòðà ýêâèâàëåíòíî îáðàáîòêå âñåõ äàííûõ ïîòîêà ôóíêöèåé <function>strip_tags</function>. Îí ïðèíèìàåò àðãóìåíòû â îäíîé èç äâóõ ôîðì: Ëèáî â âèäå ñòðîêè ñî ñïèñêîì òåãîâ, êàê è âòîðîé àðãóìåíò ôóíêöèè <function>strip_tags</function>, ëèáî ìàññèâ íàçâàíèé òåãîâ. </simpara> <example> <title>string.strip_tags</title> <programlisting role="php"> <![CDATA[ <?php $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'string.strip_tags', STREAM_FILTER_WRITE, "<b><i><u>"); fwrite($fp, "<b>bolded text</b> enlarged to a <h1>level 1 heading</h1>\n"); fclose($fp); /* Outputs: <b>bolded text</b> enlarged to a level 1 heading */ $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'string.strip_tags', STREAM_FILTER_WRITE, array('b','i','u')); fwrite($fp, "<b>bolded text</b> enlarged to a <h1>level 1 heading</h1>\n"); fclose($fp); /* Outputs: <b>bolded text</b> enlarged to a level 1 heading */ ?> ]]> </programlisting> </example> </section> <section id="filters.convert"> <title>Ïðåîáðàçîâûâàþùèå ôèëüòðû</title> <simpara> Êàê è ôèëüòðû string.*, ôèëüòðû convert.* ñîâåðøàþò äåéñòâèÿ, ñîîòâåòñòâóþùèå èõ èìåíàì. Ïðåîáðàçîâûâàþùèå ôèëüòðû áûëè äîáàâëåíû â PHP 5.0.0. Äëÿ ïîëó÷åíèÿ äîïîëíèòåëüíîé èíôîðìàöèè î êîíêðåòíîì ôèëüòðå, îáðàòèòåñü ê ñòðàíèöå ðóêîâîäñòâà ñîîòâåòñòâóþùåé ôóíêöèè. </simpara> <simpara> <literal>convert.base64-encode</literal> è <literal>convert.base64-decode</literal> Èñïîëüçîâàíèå ýòèõ ôèëüòðîâ ýêâèâàëåíòíî îáðàáîòêå âñåõ äàííûõ ïîòîêà ôóíêöèÿìè <function>base64_encode</function> è <function>base64_decode</function> ñîîòâåòñòâåííî. <literal>convert.base64-encode</literal> ïîääåðæèâàåò àðãóìåíòû, ïåðåäàííûå â âèäå àññîöèàòèâíîãî ìàññèâà. Åñëè óêàçàí àðãóìåíò <parameter>line-length</parameter>, ðåçóëüòàò base64 áóäåò ðàçäåë¸í íà êóñêè äëèííîé <parameter>line-length</parameter> ñèìâîëîâ êàæäûé. Åñëè óêàçàí àðãóìåíò <parameter>line-break-chars</parameter>, êàæäûé êóñîê áóäåò ðàçäåë¸í óêàçàííûìè ñèìâîëàìè. Ýòè ïàðàìåòðû äàþò òàêîé æå ýôôåêò, êàê è èñïîëüçîâàíèå <function>base64_encode</function> â ïàðå ñ <function>chunk_split</function>. </simpara> <example> <title>convert.base64-encode è convert.base64-decode</title> <programlisting role="php"> <![CDATA[ <?php $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'convert.base64-encode'); fwrite($fp, "This is a test.\n"); fclose($fp); /* Outputs: VGhpcyBpcyBhIHRlc3QuCg== */ $param = array('line-length' => 8, 'line-break-chars' => "\r\n"); $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'convert.base64-encode', STREAM_FILTER_WRITE, $param); fwrite($fp, "This is a test.\n"); fclose($fp); /* Outputs: VGhpcyBp : cyBhIHRl : c3QuCg== */ $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'convert.base64-decode'); fwrite($fp, "VGhpcyBpcyBhIHRlc3QuCg=="); fclose($fp); /* Outputs: This is a test. */ ?> ]]> </programlisting> </example> <simpara> <literal>convert.quoted-printable-encode</literal> è <literal>convert.quoted-printable-decode</literal> Èñïîëüçîâàíèå decode-âåðñèè ýòîãî ôèëüòðà ýêâèâàëåíòíî îáðàáîòêå âñåõ äàííûõ ïîòîêà ôóíêöèåé <function>quoted_printable_decode</function>. Ó ôèëüòðà <literal>convert.quoted-printable-encode</literal> íåòó ýêâèâàëåíòíîé ôóíêöèè. <literal>convert.quoted-printable-encode</literal> ïîääåðæèâàåò àðãóìåíòû, ïåðåäàííûå â âèäå àññîöèàòèâíîãî ìàññèâà.  äîïîëíåíèå ê àðãóìåíòàì, ïîääåðæèâàåìûìè <literal>convert.base64-encode</literal>, <literal>convert.quoted-printable-encode</literal> òàêæå ïîääåðæèâàåò boolean-àðãóìåíòû <parameter>binary</parameter> è <parameter>force-encode-first</parameter>. <literal>convert.base64-decode</literal> ïîääåðæèâàåò ëèøü àðãóìåíò <parameter>line-break-chars</parameter> â êà÷åñòâå ïîäñêàçêè äëÿ ÷èñòêè çàêîäèðîâàííûõ äàííûõ. </simpara> <example> <title> convert.quoted-printable-encode & convert.quoted-printable-decode </title> <programlisting role="php"> <![CDATA[ <?php $fp = fopen('php://output', 'w'); stream_filter_append($fp, 'convert.quoted-printable-encode'); fwrite($fp, "This is a test.\n"); /* Outputs: =This is a test.=0A */ ?> ]]> </programlisting> </example> </section> <section id="filters.compression"> <title>Êîìïðåññèîííûå ôèëüòðû</title> <simpara>  òî âðåìÿ, êàê <xref linkend="wrappers.compression"/> îáåñïå÷èâàåò ñïîñîá ñîçäàíèÿ gzip- è bz2-ñîâìåñòèìûõ ôàéëîâ â ëîêàëüíîé ôàéëîâîé ñèñòåìå, îíè (???) íå ïðåäîñòàâëÿþò (???) îáùèõ ñðåäñòâ ñðåäñòâ äëÿ êîìïðåññèè â ñåòåâûõ ïîòîêàõ, êàê íå ïðåäîñòàâëÿþò è ñðåäñòâ äëÿ ñîçäàíèÿ ïîòîêà áåç êîìïðåññèè ñ ïîñëåäóþùèì ïðåâðàùåíèåì â êîìïðåññèðóåìûé. Äëÿ ýòèõ öåëåé ê ëþáûì ïîòîêîâûì ðåñóðñàì â ëþáîå âðåìÿ ìîãóò ïðèìåíÿòüñÿ êîìïðåññèîííûå ôèëüòðû. </simpara> <note> <simpara> Êîìïðåññèîííûå ôèëüòðû <emphasis>íå</emphasis> ãåíåðèðóþò çàãîëîâêîâ è îêîí÷àíèé, êîòîðûå èñïîëüçóþò óòèëèòû êîììàíäíîé ñòðîêè, òàêèå êàê <literal>gzip</literal>. Îíè ïðîñòî êîìïðåññèðóþò (ñæèìàþò) è äåêîìïðåññèðóþò (ðàçæèìàþò) ïîðöèè äàííûõ â êîìïðåññèðóåìîì ïîòîêå äàííûõ. </simpara> </note> <simpara> <literal>zlib.deflate</literal> (êîìïðåññèÿ) è <literal>zlib.inflate</literal> (äåêîìïðåññèÿ) ÿâëÿþòñÿ ðåàëèçàöèÿìè êîìïðåññèîííûõ ìåòîäîâ, îïèñàíûõ â <ulink url="&url.rfc;1951">RFC 1951</ulink>. Ôèëüòð <literal>deflate</literal> ïðèíèìàåò òðè àðãóìåíòà, ïåðåäàííûõ â âèäå àññîöèàòèâíîãî ìàññèâà. <parameter>level</parameter> îïðåäåëÿåò, êàêîé óðîâåíü êîìïðåññèè èñïîëüçîâàòü (1-9). Ïîâûøåíèå ýòîãî çíà÷åíèÿ ïðèâåä¸ò ê óìåíüøåíèþ îáú¸ìîâ äàííûõ çà ñ÷¸ò óâåëè÷åíèÿ âðåìåíè îáðàáîòêè. Ñóùåñòâóþò òàê æå äâà ñïåöèàëüíûõ óðîâíÿ êîìïðåññèè: 0 (äëÿ îòêëþ÷åíèÿ êîìïðåññèè) è -1 (âíóòðåííåå çíà÷åíèå ïî óìîë÷àíèþ áèáëèîòåêè zlib -- íà òåêóùèé ìîìåíò ðàâíî 6). <parameter>window</parameter> - ýòî ëîãàðèôì ðàçìåðà îêíà äèàïàçîíà ñæàòèÿ, ãäå áàçà ëîãàðèôìà ñîñòàâëÿåò 2. Âûñîêèå çíà÷åíèÿ (âïëîòü äî 15 -- 32768 áàéò) ïðèâîäÿò ê óëó÷øåíèþ êîìïðåññèè çà ñ÷¸ò ðîñòà íåîáõîäèìîé ïàìÿòè, â òî âðåìÿ êàê íèçêèå çíà÷åíèÿ (âïëîòü äë 9 -- 512 áàéò) ïðèâîäÿò ê óõóäøåíèþ êîìïðåññèè çà ñ÷¸ò óìåíüøåíèÿ íåîáõîäèìîé ïàìÿòè. Çíà÷åíèåì àðãóìåíòà <parameter>window</parameter> ïî óìîë÷àíèþ íà òåêóùèé ìîìåíò ÿâëÿåòñÿ <constant>15</constant>. <parameter>memory</parameter> îïðåäåëÿåò ìàñøòàá ðåçåðâèðóåìîé ïàìÿòè. Äîïóñòèìûå çíà÷åíèÿ íàõîäÿòñÿ â äèàïàçîíå îò 1 (ìèíèìàëüíîå ðåçåðâèðîâàíèå) äî 9 (ìàêñèìàëüíîå ðåçåðâèðîâàíèå). Òàêîå ðåçåðâèðîâàíèå ïàìÿòè âëèÿåò òîëüêî íà ñêîðîñòü è íå âëèÿåò íà ðàçìåð ãåíåðèðóåìûõ äàííûõ.. </simpara> <note> <simpara> Òàê êàê óðîâåíü êîìïðåññèè ÿâëÿåòñÿ íàèáîëåå ÷àñòî èñïîëüçóåìûì àðãóìåíòîì, âû ìîæåòå ïåðåäàòü òîëüêî åãî â êà÷åñòâå îáû÷íîãî öåëîãî ÷èñëà (integer), âìåñòî òîãî ÷òîáû ïåðåäàâàòü ìàññèâ èç îäíîãî ýëåìåíòà. </simpara> </note> <simpara> Êîìïðåññèîííûå ôèëüòðû zlib.* äîñòóïíû ñ âåðñèè PHP <literal>5.1.0</literal>, åñëè âêëþ÷åíà ïîääåðæêà <xref linkend="ref.zlib"/> (???). Îíè òàê æå äîñòóïíû â êà÷åñòâå îáðàòíîãî ïîðòà äëÿ âåðñèé <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. </simpara> <example> <title> <literal>zlib.deflate</literal> è <literal>zlib.inflate</literal> </title> <programlisting role="php"> <![CDATA[ <?php $params = array('level' => 6, 'window' => 15, 'memory' => 9); $original_text = "This is a test.\nThis is only a test.\nThis is not an important string.\n"; echo "The original text is " . strlen($original_text) . " characters long.\n"; $fp = fopen('test.deflated', 'w'); stream_filter_append($fp, 'zlib.deflate', STREAM_FILTER_WRITE, $params); fwrite($fp, $original_text); fclose($fp); echo "The compressed file is " . filesize('test.deflated') . " bytes long.\n"; echo "The original text was:\n"; /* Use readfile and zlib.inflate to decompress on the fly */ readfile('php://filter/zlib.inflate/resource=test.deflated'); /* Generates output: The original text is 70 characters long. The compressed file is 56 bytes long. The original text was: This is a test. This is only a test. This is not an important string. */ ?> ]]> </programlisting> </example> <example> <title> Óïðîù¸ííîå èñïîëüçîâàíèå <literal>zlib.deflate</literal> </title> <programlisting role="php"> <![CDATA[ <?php $original_text = "This is a test.\nThis is only a test.\nThis is not an important string.\n"; echo "The original text is " . strlen($original_text) . " characters long.\n"; $fp = fopen('test.deflated', 'w'); /* Here "6" indicates compression level 6 */ stream_filter_append($fp, 'zlib.deflate', STREAM_FILTER_WRITE, 6); fwrite($fp, $original_text); fclose($fp); echo "The compressed file is " . filesize('test.deflated') . " bytes long.\n"; /* Generates output: The original text is 70 characters long. The compressed file is 56 bytes long. */ ?> ]]> </programlisting> </example> <simpara> <literal>bzip2.compress</literal> è <literal>bzip2.decompress</literal> ðàáîòàþò òî÷íî òàê æå, êàê è ôèëüòðû zlib, îíèñàííûå âûøå. Ôèëüòð <literal>bzip2.compress</literal> ïðèíèìàåò äâà àðãóìåíòà â âèäå ýëåìåíòîâ àññîöèàòèâíîãî ìàññèâà: <parameter>blocks</parameter> ÿâëÿåòñÿ öåëî÷èñëåííûì (integer) çíà÷åíèåì â äèàïàçîíå îò 1 äî 9 è óêàçûâàåò íà êîëè÷åñòâî 100-êèëîáàéòîâûõ áëîêîâ ïàìÿòè äëÿ ðåçåðâèðîâàíèÿ â êà÷åñòâå ðàáî÷åãî ïðîñòðàíñòâà. <parameter>work</parameter> - ýòî òàê æå öåëî÷èñëåííîå (integer) çíà÷åíèå â äèàïàçîíå îò 0 äî 250, îïðåäåëÿþùåå ñêîëüêî óñèëèé íóæíî ïîòðàòèòü íà îáû÷íûé ìåòîä êîìïðåññèè ïåðåä ïåðåêëþ÷åíèåì íà ìåäëåííûé, íî áîëåå íà䏿íûé ìåòîä. Èçìåíåíèå ýòîãî ïàðàìåòðà âëèÿåò òîëüêî íà ñêîðîñòü êîìïðåññèè. Íè ðàçìåð ñæàòîãî ðåçóëüòàòà, íè èñïîëüçóåìûé îáú¸ì ïàìÿòè íå èçìåíÿþòñÿ ïðè ïîìîùè ýòîé íàñòðîéêè. Çíà÷åíèå 0 óêàçûâàåò áèáëèîòåêå bzip èñïîëüçîâàòü ñîáñòâåííîå âíóòðåííåå çíà÷åíèå ïî óìîë÷àíèþ. Ôèëüòð <literal>bzip2.decompress</literal> ïðèíèìàåò âñåãî îäèí àðãóìåíò, êîòîðûé ìîæåò áûòü ïåðåäàí ëèáî êàê îáû÷íîå boolean-çíà÷åíèå, ëèáî êàê ýëåìåíò <parameter>small</parameter> àññîöèàòèâíîãî ìàññèâà. Êîãäà <parameter>small</parameter> óñòàíîâëåí â &true;, áèáëèîòåêà bzip ñîâåðøèò äåêîìïðåññèþ ñ ìèíèìàëüíûì ðàñõîäîì ïàìÿòè çà ñ÷¸ò ïîíèæåíèÿ ñêîðîñòè. </simpara> <simpara> Êîìïðåññèîííûå ôèëüòðû bzip2.* äîñòóïíû ñ âåðñèè PHP <literal>5.1.0</literal>, åñëè âêëþ÷åíà ïîääåðæêà <xref linkend="ref.bzip2"/> (???). Îíè òàê æå äîñòóïíû â êà÷åñòâå îáðàòíîãî ïîðòà äëÿ âåðñèé <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. </simpara> <example> <title> <literal>bzip2.compress</literal> è <literal>bzip2.decompress</literal> </title> <programlisting role="php"> <![CDATA[ <?php $param = array('blocks' => 9, 'work' => 0); echo "The original file is " . filesize('LICENSE') . " bytes long.\n"; $fp = fopen('LICENSE.compressed', 'w'); stream_filter_append($fp, 'bzip2.compress', STREAM_FILTER_WRITE, $param); fwrite($fp, file_get_contents('LICENSE')); fclose($fp); echo "The compressed file is " . filesize('LICENSE.compressed') . " bytes long.\n"; /* Generates output: The original text is 3288 characters long. The compressed file is 1488 bytes long. */ ?> ]]> </programlisting> </example> </section> </appendix> <!-- 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 -->