cvs: phpdoc-ru / language-snippets.ent

kai Thu Jan 15 15:21:39 2004 EDT Modified files: /phpdoc-ru language-snippets.ent Log: Synchronized with last (1.63) EN version

Index: phpdoc-ru/language-snippets.ent diff -u phpdoc-ru/language-snippets.ent:1.15 phpdoc-ru/language-snippets.ent:1.16 --- phpdoc-ru/language-snippets.ent:1.15 Wed Dec 25 11:38:06 2002 +++ phpdoc-ru/language-snippets.ent Thu Jan 15 15:21:39 2004 @@ -1,9 +1,9 @@ -<!-- EN-Revision: 1.33 Maintainer: tronic Status: ready --> -<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.63 Maintainer: tronic Status: ready --> +<!-- $Revision: 1.16 $ --> <!ENTITY warn.experimental '<warning><simpara>Ýòî ðàñøèðåíèå ÿâëÿåòñÿ <emphasis>ÝÊÑÏÅÐÈÌÅÍÒÀËÜÍÛÌ</emphasis>. Ïîâåäåíèå ýòîãî ðàñøèðåíèÿ, -âêëþ÷àÿ èìåíà åãî ôóíêöèé è îòíîñÿùóþñÿ ê íåìó äîêóìåíòàöèþ ìîæåò +âêëþ÷àÿ èìåíà åãî ôóíêöèé è îòíîñÿùóþñÿ ê íåìó äîêóìåíòàöèþ, ìîæåò èçìåíèòüñÿ â ïîñëåäóþùèõ âåðñèÿõ PHP áåç óâåäîìëåíèÿ. Èñïîëüçóéòå ýòî ðàñøèðåíèå íà ñâîé ñòðàõ è ðèñê.</simpara></warning>'> @@ -18,31 +18,94 @@ äîñòóïåí òîëüêî ñïèñîê àðãóìåíòîâ.</simpara></warning>'> <!ENTITY warn.no-win32-fopen-wrapper '<warning><para> - íàñòîÿùåå âðåìÿ âåðñèÿ <literal>PHP</literal> äëÿ Windows -íå ïîääåðæèâàåò âîçìîæíîñòü èñïîëüçîâàíèÿ óäàëåííûõ ôàéëîâ -ýòîé ôóíêöèåé äàæå â òîì ñëó÷àå, åñëè âêëþ÷åíà îïöèÿ -<link linkend="ini.allow-url-fopen">allow_url_fopen</link>.</para></warning>'> +Âåðñèè <literal>PHP</literal> äëÿ Windows äî PHP 4.3.0 íå +ïîääåðæèâàþò âîçìîæíîñòü èñïîëüçîâàíèÿ óäàëåííûõ ôàéëîâ ýòîé +ôóíêöèåé äàæå â òîì ñëó÷àå, åñëè îïöèÿ +<link linkend="ini.allow-url-fopen">allow_url_fopen</link> +âêëþ÷åíà.</para></warning>'> + +<!ENTITY note.no-remote '<note><simpara>Ýòà ôóíêöèÿ íå ïðèìåíèìà äëÿ +ðàáîòû ñ <link linkend="features.remote-files">óäàëåííûìè ôàéëàìè</link>, ïîñêîëüêó +ôàéë äîëæåí áûòü äîñòóïåí ÷åðåç ôàéëîâóþ ñèñòåìó ñåðâåðà.</simpara></note>'> <!ENTITY tip.ob-capture '<tip><simpara>Êàê è ñ ëþáîé äðóãîé ôóíêöèåé, îñóùåñòâëÿþùåé -âûâîä íåïîñðåäñòâåííî â áðîóçåð, âû ìîæåòå èñïîëüçîâàòü <link +âûâîä íåïîñðåäñòâåííî â áðàóçåð, âû ìîæåòå èñïîëüçîâàòü <link linkend="ref.outcontrol">ôóíêöèè êîíòðîëÿ âûâîäà</link>, ÷òîáû ïåðåõâàòûâàòü -âûâîäèìûå ýòîé ôóíêöèåé äàííûå è ñîõðàíÿòü èõ, íàïðèìåð, â <type>ñòðîêîâîé ïåðåìåííîé</type>.</simpara></tip>'> +âûâîäèìûå ýòîé ôóíêöèåé äàííûå è ñîõðàíÿòü èõ, íàïðèìåð, â <type>string</type>.</simpara></tip>'> <!ENTITY tip.fopen-wrapper '<tip><simpara>Äëÿ ýòîé ôóíêöèè âû ìîæåòå èñïîëüçîâàòü URL -â êà÷åñòâå èìåíè ôàéëà, åñëè áûëà âêëþ÷åíà îïöèÿ "fopen wrappers". Çà áîëåå ïîäðîáíîé -èíôîðìàöèåé îáðàòèòåñü ê îïèñàíèþ ôóíêöèè <function>fopen</function>.</simpara></tip>'> +â êà÷åñòâå èìåíè ôàéëà, åñëè áûëà âêëþ÷åíà îïöèÿ "fopen wrappers". Ñìîòðèòå áîëåå +ïîäðîáíóþ èíôîðìàöèþ îá îïðåäåëåíèè èìåíè ôàéëà â îïèñàíèè ôóíêöèè +<function>fopen</function>, à òàêæå ñïèñîê ïîääåðæèâàåìûõ ïðîòîêîëîâ URL â +<xref linkend="wrappers"/>.</simpara></tip>'> + +<!ENTITY tip.fopen-wrapper.stat '<tip><simpara>Íà÷èíàÿ ñ +<literal>PHP 5.0.0</literal>, ýòà ôóíêöèÿ òàêæå ìîæåò áûòü +èñïîëüçîâàíà ñ <emphasis>íåêîòîðûìè</emphasis> óïàêîâùèêàìè url. +Ñïèñîê óïàêîâùèêîâ, ïîääåðæèâàåìûõ ñåìåéñòâîì ôóíêöèé +<function>stat</function>, ñìîòðèòå â <xref linkend="wrappers"/>.</simpara></tip>'> <!ENTITY return.success 'Âîçâðàùàåò &true; â ñëó÷àå óñïåøíîãî çàâåðøåíèÿ, &false; â ñëó÷àå âîçíèêíîâåíèÿ îøèáêè.'> +<!ENTITY array.resetspointer '<note><simpara>Ïîñëå èñïîëüçîâàíèÿ +ýòà ôóíêöèÿ âåðíåò (<function>reset</function>) óêàçàòåëü ìàññèâà +â íà÷àëî.</simpara></note>'> + +<!ENTITY note.clearstatcache '<note><simpara>Ðåçóëüòàòû ýòîé ôóíêöèè +êýøèðóþòñÿ. Áîëåå ïîäðîáíóþ èíôîðìàöèþ ñìîòðèòå â ðàçäåëå +<function>clearstatcache</function>.</simpara></note>'> + <!ENTITY return.falseproblem '<warning><simpara>Ýòà ôóíêöèÿ ìîæåò âîçâðàùàòü êàê ëîãè÷åñêîå çíà÷åíèå &false;, òàê è íå îòíîñÿùååñÿ ê ëîãè÷åñêîìó òèïó -çíà÷åíèå, êîòîðîå ìîæåò ÿâëÿòüñÿ çíà÷åíèåì &false;, íàïðèìåð, <literal>0</literal> èëè +çíà÷åíèå, êîòîðîå âû÷èñëÿåòñÿ â &false;, íàïðèìåð, <literal>0</literal> èëè &quot;&quot;. Çà áîëåå ïîäðîáíîé èíôîðìàöèè îáðàòèòåñü ê ðàçäåëó <link -linkend="language.types.boolean">Ëîãè÷åñêèå òèïû</link>. Èñïîëüçóéòå <link +linkend="language.types.boolean">Áóëåâ òèï</link>. Èñïîëüçóéòå <link linkend="language.operators.comparison">îïåðàòîð ===</link> äëÿ ïðîâåðêè çíà÷åíèÿ, âîçâðàùàåìîãî ýòîé ôóíêöèåé.</simpara></warning>'> +<!ENTITY warn.imaprecodeyaz '<warning><simpara>Ðàñøèðåíèå <link +linkend="ref.imap">IMAP</link> íå ìîæåò èñïîëüçîâàòüñÿ âìåñòå ñ ðàñøèðåíèÿìè +<link linkend="ref.recode">ïåðåêîäèðîâêè</link> èëè <link +linkend="ref.yaz">YAZ</link>. Ýòî ñâÿçàíî ñ òåì ôàêòîì, ÷òî îíè îáà +èñïîëüçóþò îäèí è òîò æå âíóòðåííèé ñèìâîë.</simpara></warning>'> + +<!ENTITY note.registerglobals '<note><title>register_globals: âàæíîå +çàìå÷àíèå</title><para>Íà÷èíàÿ ñ PHP 4.2.0, çíà÷åíèåì äèðåêòèâû PHP +<link linkend="ini.register-globals">register_globals</link> ïî óìîë÷àíèþ +ÿâëÿåòñÿ <emphasis>off</emphasis> (âûêëþ÷åíî). Ñîîáùåñòâî PHP ðåêîìåíäóåò +âñåì íå ïîëàãàòüñÿ íà ýòó äèðåêòèâó, à èñïîëüçîâàòü âìåñòî ýòîãî èíûå +ñðåäñòâà, òàêèå êàê &link.superglobals;. +</para></note>'> + +<!ENTITY note.superglobals '<note><title>Ñóïåðãëîáàëüíûå ïåðåìåííûå: +çàìå÷àíèå î äîñòóïíîñòè</title><para>Íà÷èíàÿ ñ PHP 4.1.0, ñòàëè äîñòóïíûìè +ñóïåðãëîáàëüíûå ìàññèâû, òàêèå êàê <varname>$_GET</varname>, +<varname>$_POST</varname>, <varname>$_SERVER</varname> è ò.ä. Äîïîëíèòåëüíóþ +èíôîðìàöèþ ñìîòðèòå â ðàçäåëå ðóêîâîäñòâà &link.superglobals;</para></note>'> + +<!ENTITY avail.register-long-arrays 'Íà÷èíàÿ ñ PHP 5.0.0, äëèííûå +<link linkend="language.variables.predefined">ïðåäîïðåäåëåííûå ïåðåìåííûå</link> +ìàññèâîâ PHP ìîãóò áûòü îòêëþ÷åíû äèðåêòèâîé +<link linkend="ini.register-long-arrays">register_long_arrays</link>.'> + +<!ENTITY note.magicquotes.gpc '<note><title>Çàìå÷àíèå î äèðåêòèâå: magic_quotes_gpc +</title><para>Äèðåêòèâà PHP <link linkend="ini.magic-quotes-gpc"> +magic_quotes_gpc</link> èìååò çíà÷åíèå ïî óìîë÷àíèþ <literal>on</literal> +(âêëþ÷åíà). Ïî ñóòè ýòî ïðèìåíÿåò ôóíêöèþ <function>addslashes</function> êî +âñåì âàøèì GET-, POST-, è COOKIE-äàííûì. ×òîáû óäàëèòü äîáàâëåííûå êîñûå +÷åðòû, âû ìîæåòå èñïîëüçîâàòü <function>stripslashes</function>.</para></note>'> + +<!ENTITY note.config.t1lib '<note><simpara>Ýòà ôóíêöèÿ äîñòóïíà òîëüêî â +òîì ñëó÷àå, åñëè PHP áûë ñêîìïèëèðîâàí ñ îïöèåé +<option role="configure">--enable-t1lib</option>. +</simpara></note>'> + <!-- Various notes --> +<!ENTITY note.randomseed '<note><simpara>Íà÷èíàÿ ñ PHP 4.2.0, áîëüøå íåò +íåîáõîäèìîñòè èíèöèàëèçèðîâàòü ãåíåðàòîð ñëó÷àéíûõ ÷èñåë ôóíêöèÿìè +<function>srand</function> èëè <function>mt_srand</function>, ïîñêîëüêó +òåïåðü ýòî ïðîèñõîäèò àâòîìàòè÷åñêè.</simpara></note>'> + <!ENTITY note.not-bin-safe '<warning><simpara>Ýòà ôóíêöèÿ (ïîêà) íå áåçîïàñíà äëÿ îáðàáîòêè äàííûõ â äâîè÷íîé ôîðìå!</simpara></warning>'> @@ -79,6 +142,11 @@ èìååò ëè êàòàëîã, ñ êîòîðûì âû ñîáèðàåòåñü ðàáîòàòü, òàêîé æå UID, êàê è âûïîëíÿåìûé ñêðèïò.</simpara></note>'> +<!ENTITY note.language-construct '<note><simpara>Ïîñêîëüêó ýòî ÿçûêîâàÿ +êîíñòðóêöèÿ, à íå ôóíêöèÿ, îíà íå ìîæåò âûçûâàòüñÿ ïðè ïîìîùè +<link linkend="functions.variable-functions">ïåðåìåííûõ ôóíêöèé</link></simpara> +</note>'> + <!-- Common pieces in features/safe-mode.xml Jade doesn't allow in-line entities, so I put them here... Though they should have been inline in safe-mode.xml --> @@ -88,8 +156,8 @@ <!ENTITY sm.uidcheck.dir 'Ïðîâåðÿåò, èìååò ëè êàòàëîã, ñ êîòîðûì âû ñîáèðàåòåñü ðàáîòàòü, òàêîé æå UID, êàê è âûïîëíÿåìûé ñêðèïò.'> -<!ENTITY sm.disabled 'Ýòà ôóíêöèÿ íåäîñòóïíà, åñëè âêëþ÷åíà îïöèÿ -<link linkend="features.safe-mode">safe mode</link>.'> +<!ENTITY sm.disabled 'Ýòà ôóíêöèÿ íåäîñòóïíà â +<link linkend="features.safe-mode">áåçîïàñíîì ðåæèìå</link>.'> <!-- Common pieces in partintro-sections --> <!ENTITY no.config '<para>Äàííîå ðàñøèðåíèå íå îïðåäåëÿåò íèêàêèå äèðåêòèâû êîíôèãóðàöèè â &php.ini;.</para>'> @@ -99,9 +167,15 @@ <!ENTITY no.install '<para>Äëÿ èñïîëüçîâàíèÿ ýòèõ ôóíêöèé íå òðåáóåòñÿ ïðîâåäåíèå óñòàíîâêè, ïîñêîëüêó îíè ÿâëÿþòñÿ ÷àñòüþ ÿäðà PHP.</para>'> +<!-- Used in every chapter that has directive descriptions --> +<!ENTITY ini.descriptions.title '<para>Êðàòêîå ðàçúÿñíåíèå êîíôèãóðàöèîííûõ +äèðåêòèâ.</para>'> + +<!-- Common pieces for reference part BEGIN--> + <!-- Used in reference/$extname/ini.xml --> <!ENTITY extension.runtime '<simpara> -Ïîâåäåíèå ýòèõ ôóíêöèé íàõîäèòñÿ â çàâèñèìîñòè îò óñòàíîâîê â &php.ini;. +Ïîâåäåíèå ýòèõ ôóíêöèé çàâèñèò îò óñòàíîâîê â &php.ini;. </simpara>'> <!-- Used in reference/$extname/constants.xml --> @@ -120,16 +194,10 @@ <!-- Used in reference/$extname/classes.xml --> <!ENTITY extension.classes '<simpara> Ïåðå÷èñëåííûå íèæå êëàññû îïðåäåëÿþòñÿ äàííûì ðàñøèðåíèåì è -äîñòóïíû òîëüêî êîãäà PHP áûë ñîáðàí ñ ýòèì -ðàñøèðåíèåì èëè ýòî ðàñøèðåíèå áûëî äèíàìè÷åñêè -çàãðóæåíî âî âðåìÿ âûïîëíåíèÿ ñêðèïòà. +äîñòóïíû òîëüêî êîãäà PHP áûë ñîáðàí ñ ýòèì ðàñøèðåíèåì èëè ýòî +ðàñøèðåíèå áûëî äèíàìè÷åñêè çàãðóæåíî âî âðåìÿ âûïîëíåíèÿ ñêðèïòà. </simpara>'> -<!ENTITY windows.builtin '<simpara> Âåðñèÿ <literal>PHP</literal> äëÿ -Windows-ñîâìåñòèìûõ ïëàòôîðì èìååò âñòðîåííóþ ïîääåðæêó äàííîãî ðàñøèðåíèÿ. -Ýòî îçíà÷àåò, ÷òî äëÿ èñïîëüçîâàíèÿ äàííûõ ôóíêöèé íå òðåáóåòñÿ çàãðóçêà -íèêàêèõ äîïîëíèòåëüíûõ ðàñøèðåíèé.</simpara>'> - <!-- These are using in reference/$extname/reference.xml and other supplemental files to mark section titles --> <!ENTITY reftitle.intro '<title>Ââåäåíèå</title>'> @@ -141,3 +209,45 @@ <!ENTITY reftitle.classes '<title>Ïðåäîïðåäåëåííûå êëàññû</title>'> <!ENTITY reftitle.examples '<title>Ïðèìåðû</title>'> <!ENTITY reftitle.seealso '<title>Ñìîòðèòå òàêæå</title>'> + +<!-- Common pieces for reference part END --> + + +<!ENTITY windows.builtin '<simpara> Âåðñèÿ <literal>PHP</literal> äëÿ +Windows èìååò âñòðîåííóþ ïîääåðæêó äàííîãî ðàñøèðåíèÿ. Ýòî îçíà÷àåò, ÷òî +äëÿ èñïîëüçîâàíèÿ äàííûõ ôóíêöèé íå òðåáóåòñÿ çàãðóçêà íèêàêèõ +äîïîëíèòåëüíûõ ðàñøèðåíèé.</simpara>'> + +<!-- These are here as helpers for manual consistency and brievety--> +<!ENTITY php '<literal>PHP</literal>'> +<!ENTITY safemode '<link linkend="ini.safe-mode">safe mode</link>'> + +<!-- Database Notes --> +<!ENTITY database.field-case '<note><simpara>Èìåíà ïîëåé, âîçâðàùàåìûå ýòîé +ôóíêöèåé, <emphasis>ðåãèñòðî-çàâèñèìû</emphasis>.</simpara></note>'> + +<!-- Sybase Notes --> +<!ENTITY sybase.ct.only '<note><simpara>Ýòà ôóíêöèÿ äîñòóïíà òîëüêî ïðè +èñïîëüçîâàíèè èíòåðôåéñà ê Sybase áèáëèîòåêè CT, íî íå áèáëèîòåêè DB.</simpara></note>'> + +<!-- Some MySQL Notes --> +<!ENTITY mysql.field-case '<note><simpara>Èìåíà ïîëåé, âîçâðàùàåìûå ýòîé +ôóíêöèåé, <emphasis>ðåãèñòðî-çàâèñèìû</emphasis></simpara></note>'> + +<!-- CPDF Unit length --> +<!ENTITY cpdf.ul '<para>Íåîáÿçàòåëüíûé ïàðàìåòð <parameter>mode</parameter> +îïðåäåëÿåò åäèíèöó èçìåðåíèÿ. Åñëè îí íå óêàçàí, ëèáî ðàâåí 0, èñïîëüçóåòñÿ +îïðåäåëåííàÿ ïî óìîë÷àíèþ äëÿ ñòðàíèöû åäèíèöà èçìåðåíèÿ. Èíà÷å êîîðäèíàòû +èçìåðÿþòñÿ â ïóíêòàõ postscript áåç ó÷åòà òåêóùåé åäèíèöû èçìåðåíèÿ.</para>'> + +<!-- Notes for IPv6 --> +<!ENTITY ipv6.brackets '<note><simpara>Ïðè óêàçàíèè ÷èñëîâîãî àäðåñà IPv6 +(íàïðèìåð, fe80::1) âû äîëæíû çàêëþ÷àòü åãî â êâàäðàòíûå ñêîáêè. Íàïðèìåð, +<literal>tcp://[fe80::1]:80</literal>.</simpara></note>'> + +<!ENTITY ipv6.php5 '<note><simpara>Ïîääåðæêà IPv6 áûëà ââåäåíà â <literal>PHP +5.0.0 </literal>.</simpara></note>'> + +<!-- Notes for tidy --> +<!ENTITY note.tidy.ze2 '<note><simpara> Ýòà ôóíêöèÿ äîñòóïíà òîëüêî â Äâèæêå +Zend 2, ýòî îçíà÷àåò PHP &gt;= 5.0.0.</simpara></note>'>