cvs: peardoc /ru/chapters intro.xml parts.xml standards.xml
| From: | Vitaliy N. Kravchenko | Date: | Tue, 15 Jan 2002 13:49:20 +0000 |
| Subject: | cvs: peardoc /ru/chapters intro.xml parts.xml standards.xml | ||
| Groups: | php.pear.cvs | ||
| Request: | Send a blank email to pear-cvs+get-1951@lists.php.net to get a copy of this message | ||
kvn Tue Jan 15 08:49:20 2002 EDT
Added files:
/peardoc/ru/chapters intro.xml parts.xml standards.xml
Log:
Let's go.
Index: peardoc/ru/chapters/intro.xml +++ peardoc/ru/chapters/intro.xml <?xml version='1.0' encoding='KOI8-R' ?> <!-- $Revision: 1.1 $ --> <chapter id="introduction"> <title>÷×ÅÄÅÎÉÅ.</title> <sect1 id="pear-whatis"> <title>þÔÏ ÜÔÏ ×ÏÏÂÝÅ ÔÁËÏÅ: PEAR?</title> <simpara> ðÒÏÅËÔ PHP Extension and Add-on Repository (PEAR) -- ÜÔÏ ÐÏÐÙÔËÁ ÒÁÚÒÁÂÏÔÁÔØ ÓÏÂÒÁÎÉÅ ÓËÒÉÐÔÏ×, ÐÏÈÏÖÉÈ ÎÁ ðÅÒÌÏ×ÓËÉÊ CPAN, ÉÌÉ TeX-Ï×ÙÊ CTAN, ÄÌÑ PHP. PEAR ×ËÌÀÞÁÅÔ × ÓÅÂÑ ÍÎÏÖÅÓÔ×Ï, ÎÁÉÂÏÌÅÅ ÞÁÓÔÏ ÉÓÐÏÌØÚÕÅÍÙÈ ËÏÄÏ×. ðÒÏÄ×ÉÇÁÑ ÉÎÆÒÁÓÔÒÕËÔÕÒÕ É ÏÐÒÅÄÅÌÅÎÉÑ ÓÔÁÎÄÁÒÔÏ×, Ë ËÏÔÏÒÙÍ ÄÏÌÖÎÙ ÐÒÉÄÅÒÖÉ×ÁÔØÓÑ ÒÁÚÒÁÂÏÔÞÉËÉ, PEAR, ×ÍÅÓÔÅ Ó PHP4, ÍÏÖÅÔ ÂÙÔØ ÎÕÖÅÎ ÄÌÑ ÐÏÎÉÍÁÎÉÑ PHP ÎÁ ÂÏÌÅÅ ×ÙÓÏËÏÍ ÕÒÏ×ÎÅ. </simpara> <para> ïÓÎÏ×ÎÁÑ ÃÅÌØ PEAR: <itemizedlist> <listitem> <simpara> ÚÁÇÏÔÏ×ÉÔØ ÕÓÔÏÊÞÉ×ÕÀ ÓÔÒÕËÔÕÒÕ ÂÉÂÌÉÏÔÅË, ÞÔÏÂÙ Á×ÔÏÒÙ ÍÏÇÌÉ ×ÙËÌÁÄÙ×ÁÔØ Ó×ÏÉ ×ÏÄÙ ×ÍÅÓÔÅ Ó ÄÒÕÇÉÍÉ ÒÁÚÒÁÂÏÔÞÉËÁÍÉ, ÄÌÑ ÏÂÝÅÇÏ ÉÓÐÏÌØÚÏ×ÁÎÉÑ </simpara> </listitem> <listitem> <simpara> ÓÄÅÌÁÔØ ÏÂÝÕÀ ÉÎÆÒÁÓÔÒÕËÔÕÒÕ ÄÌÑ ÜÔÏÇÏ ËÏÄÁ. </simpara> </listitem> <listitem> <simpara> ÏÐÒÅÄÅÌÉÔØ ÓÔÁÎÄÁÒÔÙ, ËÏÔÏÒÙÅ ÐÏÍÏÇÕÔ ÒÁÚÒÁÂÏÔÞÉËÁÍ ÐÉÓÁÔØ ËÏÍÐÁËÔÎÙÊ É ÞÁÓÔÏ ÉÓÐÏÌØÚÕÅÍÙÊ ËÏÄ </simpara> </listitem> <listitem> <simpara> ÐÒÅÄÌÏÖÉÔØ ÕÔÉÌÉÔÙ ÄÌÑ ÐÏÄÄÅÒÖÁÎÉÑ É ÒÁÓÐÒÅÄÅÌÅÎÉÑ ËÏÄÁ </simpara> </listitem> </itemizedlist> </para> </sect1> </chapter> <!-- 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 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 --> Index: peardoc/ru/chapters/parts.xml +++ peardoc/ru/chapters/parts.xml <?xml encoding="KOI8-R"?> <!-- $Revision: 1.1 $ --> <chapter id="parts"> <title>ôÒÉ ÞÁÓÔÉ PEAR</title> <simpara> PEAR ÓÏÓÔÏÉÔ ÉÚ ÔÒÅÈ ÞÁÓÔÅÊ, ËÏÔÏÒÙÅ ÏÐÉÓÁÎÙ × ÜÔÏÍ ÒÁÚÄÅÌÅ. </simpara> <sect1 id="parts-core"> <title>ñÄÒÏ</title> <simpara> ñÄÒÏ PEAR ÓÏÄÅÒÖÉÔ ÏÓÎÏ×ÎÏÊ ËÏÄ, ÏÔ ËÏÔÏÒÏÇÏ ÚÁ×ÉÓÑÔ ÍÎÏÇÉÅ ÐÒÏÇÒÁÍÎÙÅ ÐÁËÅÔÙ ÉÚ ÒÁÓÛÉÒÅÎÉÊ. ëÒÏÍÅ ÔÏÇÏ, ÏÎÏ ÓÏÄÅÒÖÉÔ ÕÎÉ×ÅÒÓÁÌØÎÙÊ ËÏÄ ×ÙÓÏËÏÇÏ ÕÒÏ×ÎÑ. </simpara> </sect1> <sect1 id="parts-extended"> <title>òÁÓÛÉÒÅÎÎÁÑ</title> <simpara> òÁÓÛÉÒÅÎÎÁÑ ÞÁÔØ PEAR ÓÏÄÅÒÖÉÔ ÏÓÎÏ×ÎÙÅ ÐÁËÅÔÙ ÐÒÏÇÒÁÍÍ, ÎÁÐÉÓÁÎÎÙÈ ÎÁ PHP; ÉÌÉ ÒÁÓÛÉÒÑÀÛÉÈ PHP, ÎÁÐÉÓÁÎÎÙÈ ÎÁ ó, ËÏÔÏÒÙÅ, × Ó×ÏÀ ÏÞÅÒÅÄØ, ÓÏÏÔ×ÅÔÓÔ×ÕÀÔ <link linkend="standards">ÓÔÁÎÄÁÒÔÁÍ ËÏÄÉÒÏ×ÁÎÉÑ</link> PEAR. </simpara> <para> ðÁËÅÔÙ ÐÒÏÇÒÁÍÍ ÉÚ ÒÁÓÛÉÒÅÎÎÏÊ ÞÁÓÔÉ PEAR ÕÓÔÁÎÁ×ÌÉ×ÁÀÔØÓÑ Ó ÐÏÍÏÛØÀ éÎÓÔÒÕÍÅÎÔÁÌØÎÙÈ ÓÒÅÄÓÔ× PEAR (PEAR installation tools) É ÓÏÏÔ×ÅÔÓÔ×ÕÀÔ <link linkend="standards">ÓÔÁÎÄÁÒÔÁÍ ËÏÄÉÒÏ×ÁÎÉÑ</link> PEAR. </para> </sect1> <sect1 id="parts-pecl"> <title>PECL</title> <simpara> PECL - ÜÔÏ ÒÅÐÏÚÉÔÏÒÉÊ ÄÌÑ ÒÁÓÛÉÒÅÎÉÊ PHP, ÎÁÐÉÓÁÎÎÙÈ ÎÁ C, ËÏÔÏÒÙÅ ÎÅ ÓÏÏÔ×ÅÔÓ×ÕÀÔ <link linkend="standards">ÓÔÁÎÄÁÒÔÁÍ ËÏÄÉÒÏ×ÁÎÉÑ</link> PEAR. </simpara> <para> PECL ÂÙÌ ÓÄÅÌÁÎ ÒÅÐÏÚÉÔÏÒÉÅÍ, ÄÌÑ ÄÅÒÅ×Á ÒÁÓÛÉÒÅÎÉÊ PHP (/ext/ - ÄÉÒÅËÔÏÒÉÑ), ËÏÔÏÒÏÅ ÂÙÌÏ ÐÅÒÅÎÅÓÅÎÏ × PEAR ÉÚ ÄÅÒÅ×Á ÉÓÈÏÄÎÙÈ ÔÅËÓÔÏ× PHP. </para> <para> ôÁË ËÁË éÎÓÔÒÕÍÅÎÔÁÌØÎÙÅ ÓÒÅÄÓÔ×Á PEAR ÎÅ ÐÏÚ×ÏÌÑÀÔ ÎÁ ÄÁÎÎÙÊ ÍÏÍÅÎÔ ÉÎÓÔÁÌÌÉÒÏ×ÁÔØ ÐÁËÅÔÙ ÐÒÏÇÒÁÍ PECL, ÚÄÅÓØ ÐÒÉ×ÏÄÉÔØÓÑ ËÒÁÔËÏÅ ÏÐÉÓÁÎÉÅ ÔÏÇÏ, ËÁË ÜÔÏ ÍÏÖÎÏ ÓÄÅÌÁÔØ: </para> <para> <itemizedlist> <listitem> <simpara> óËÁÞÁÊÔÅ ÐÁËÅÔ ÉÚ PEAR, ÚÁÔÅÍ ÒÁÚÐÁËÕÊÔÅ (TAR) ÅÇÏ ËÕÄÁ ÎÉÂÕÄØ. ðÅÒÅÊÄÉÔÅ × ÜÔÕ ÄÉÒÅËÔÏÒÉÀ É ×ÙÐÏÌÎÉÔÅ ÓÌÅÄÕÀÝÉÅ ÄÅÊÓÔ×ÉÑ. </simpara> </listitem> <listitem> <simpara>phpize</simpara> </listitem> <listitem> <simpara>./configure</simpara> </listitem> <listitem> <simpara>make</simpara> </listitem> <listitem> <simpara>cp modules/module.so /usr/local/lib/php</simpara> </listitem> </itemizedlist> </para> <para> ðÕÔØ, ÇÄÅ ÄÏÌÖÅÎ ÌÅÖÁÔØ ÍÏÄÕÌØ (*.so), ÍÏÖÅÔ ÏÔÌÉÞÁÔØÓÑ × ×ÁÛÅÊ ÓÉÓÔÅÍÅ (ÐÒÏ×ÅÒØÔÅ ÆÁÊÌ <filename>php.ini</filename> É Æ-ÃÉÀ <function> phpinfo</function>). äÌÑ ÉÓÐÏÌØÚÏ×ÁÎÉÑ ÍÏÄÕÌÑ ×Ù ÄÏÌÖÎÙ ÄÏÂÁ×ÉÔØ Ó ÐÏÍÏÛØÀ ÄÉÒÅËÔÉ×Ù extension × php.ini ÉÌÉ ÚÁÇÒÕÖÁÔØ ÅÇÏ Ó ÐÏÍÏÛØÀ ÆÕÎËÃÉÉ dl("module.so") ÉÚ ×ÙÛÅÇÏ php-ÆÁÊÌÁ. </para> <para> ÷Ù ÔÁËÖÅ ÍÏÖÅÔÅ ×ËÏÍÐÉÌÉÔØ ÜÔÏ ÒÁÓÛÉÒÅÎÉÅ ÐÒÑÍÏ × ×ÁÛ ÂÉÎÁÒÎÉË php. äÌÑ ÜÔÏÇÏ ×ÁÍ ÎÕÖÎÏ ÒÁÚÐÁËÏ×ÁÔØ ÐÁËÅÔ × php4/ext (× ÄÉÒÅËÔÏÒÉÉ Ó ÉÓÈÏÄÎÙÍÉ ÔÅËÓÔÁÍÉ PHP). ðÏÓÌÅ ÜÔÏÇÏ ÚÁÐÕÓÔÉÔÅ ÔÁËÖÅ phpize × ÄÉÒÅËÔÏÒÉÉ ÜÔÏÇÏ ÎÏ×ÏÇÏ ÍÏÄÕÌÑ. îÏ ÐÒÅÖÄÅ ×ÁÍ ÎÕÖÎÏ ÓËÏÎÆÉÇÕÒÉÒÏ×ÁÔØ ×ÁÛ php, ×Ù ÄÏÌÖÎÙ ÚÁÐÕÓÔÉÔØ <filename>./buildconf</filename> × ×ÅÒÈÎÅÊ ÄÉÒÅËÔÏÒÉÉ ÄÅÒÅ×Á ÉÓÈÏÄÎÉËÏ× php. ôÅÐÅÒØ ×Ù ÍÏÖÅÔÅ ËÏÎÆÉÇÕÒÉÔØ/ËÏÍÐÉÌÉÔØ (configure/compile) ×ÁÛ PHP Ó ÎÏ×ÙÍ ÍÏÄÕÌÅÍ, ÔÁË ËÁË ×Ù ÜÔÏ ÄÅÌÁÌÉ Ó ÄÒÕÇÉÍÉ ÓÔÁÎÄÁÒÔÎÙÍÉ ÍÏÄÕÌÑÍÉ. </para> </sect1> </chapter> <!-- 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 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 --> Index: peardoc/ru/chapters/standards.xml +++ peardoc/ru/chapters/standards.xml <?xml version='1.0' encoding='KOI8-R' ?> <chapter id="standards"> <title>óÔÁÎÄÁÒÔÙ ËÏÄÉÒÏ×ÁÎÉÑ PEAR</title> <note> <simpara> óÔÁÎÄÁÒÔÙ ËÏÄÉÒÏ×ÁÎÉÑ PEAR ÉÓÐÏÌØÚÕÀÔØÓÑ × ËÏÄÅ, ËÏÔÏÒÙÊ × ÉÔÏÇÅ ÓÔÁÅÔ ÞÁÓÔØÀ PEAR, ËÏÔÏÒÙÊ × Ó×ÏÀ ÏÞÅÒÅÄØ ÐÏÓÔÁ×ÌÑÅÔØÓÑ Ó ÄÉÓÔÒÉÂÕÔÉ×ÏÍ PHP ÉÌÉ ÄÏÓÔÕÐÅÎ ÄÌÑ ÓËÁÞÉ×ÁÎÉÑ ÞÅÒÅÚ ÕÔÉÌÉÔÙ ÉÎÓÔÁÌÑÃÉÉ PEAR. </simpara> </note> <sect1 id="standards.indenting"> <title>óÔÒÕËÔÕÒÁ ÎÁÐÉÓÁÎÉÑ</title> <para> éÓÐÏÌØÚÕÊÔÅ ÄÌÑ ÏÔÓÔÕÐÁ 4 ÐÒÏÂÅÌÁ, ÎÅ ÔÁÂÕÌÑÃÉÀ. åÓÌÉ ×Ù ÉÓÐÏÌØÚÕÅÔÅ Emacs ÄÌÑ ÒÅÄÁËÔÉÒÏ×ÁÎÉÑ ËÏÄÁ, ×Ù ÄÏÌÖÎÙ ÕÓÔÁÎÏ×ÉÔØ indent-tabs-mode × ÎÏÌØ. úÄÅÓØ ÐÒÉÍÅÒ ÐÏËÁÚÙ×ÁÀÝÉÊ ËÁË ÎÁÓÔÒÏÉÔØ Emacs (hook) (×Ù ÄÏÌÖÎÙ ÂÙÔØ Õ×ÅÒÅÎÙ ÞÔÏ ÜÔÏ ÂÕÄÅÔ ×ÙÚÙ×ÁÔØÓÑ, ËÏÇÄÙ ×Ù ÒÅÄÁËÔÉÒÕÅÔÅ php ÆÁÊÌÙ): <programlisting role="elisp"> (defun php-mode-hook () (setq tab-width 4 c-basic-offset 4 c-hanging-comment-ender-p nil indent-tabs-mode (not (and (string-match "/\\(PEAR\\|pear\\)/" (buffer-file-name)) (string-match "\.php$" (buffer-file-name)))))) </programlisting> </para> <para> á ÜÔÏ ÐÒÁ×ÉÌÁ ÕÓÔÁÎÏ×ËÉ ÄÌÑ vim ÒÅÄÁËÔÏÒÁ: <programlisting role="vim"> set expandtab set shiftwidth=4 set tabstop=4 </programlisting> </para> </sect1> <sect1 id="standards.control"> <title>õÐÒÁ×ÌÑÀÝÉÅ ÓÔÒÕËÔÕÒÙ</title> <para> ïÎÉ ×ËÌÕÞÁÀÔ ÏÐÅÒÁÔÏÒÙ if, for, while, switch, É Ô.Ä. úÄÅÓØ ÐÒÉÍÅÒ ÏÆÏÒÍÌÅÎÉÑ ÎÅÍÎÏÇÏ ÚÁÐÕÔÁÎÎÏÇÏ ÕÓÌÏ×ÉÑ: <programlisting role="php"> if ((condition1) || (condition2)) { action1; } elseif ((condition3) && (condition4)) { action2; } else { defaultaction; } </programlisting> </para> <simpara> õÐÒÁ×ÌÑÀÝÉÅ ×ÙÒÁÖÅÎÉÑ ÄÏÌÖÎÙ ÉÍÅÔØ ÏÄÉÎ ÐÒÏÂÅÌ ÍÅÖÄÕ ËÏÎÔÒÏÌØÎÙÍÉ ÏÐÅÒÁÔÏÒÁÍÉ É ËÒÕÇÌÙÍÉ ÓËÏÂËÁÍÉ, ÞÔÏÂÙ ÒÁÚÌÉÞÁÔØ ÉÈ ÏÔ ×ÙÚÏ×Ï× ÆÕÎËÃÉÊ. </simpara> <simpara> ÷Ù ÄÏÌÖÎÙ ÐÒÉÄÅÒÖÉ×ÁÔØÓÑ ÍÅÔÏÄÁ, ÞÔÏ ÆÉÇÕÒÎÙÅ ÓËÏÂËÉ ÎÕÖÎÏ ÓÔÁ×ÉÔØ ×ÅÚÄÅ,ÄÁÖÅ ÅÓÌÉ ÏÎÉ ÔÅÈÎÉÞÅÓËÉ ÎÅ ÏÂÑÚÁÔÅÌØÎÙ. ó ÐÏÍÏÝØÀ ÉÈ ×ÏÚÒÁÓÔÁÅÔ ÞÉÔÁÂÅÌØÎÏÓÔØ É ÕÍÅÎØÛÁÅÔØÓÑ ×ÅÒÏÑÔÎÏÓÔØ ÌÏÇÉÞÅÓËÉÈ ÏÛÉÂÏË ÐÒÉ ÄÏÂÁ×ÌÅÎÉÉ ÎÏ×ÙÈ ÓÔÒÏË × ËÏÄ. </simpara> <para> äÌÑ ×ÙÒÁÖÅÎÉÑ switch: <programlisting role="php"> switch (condition) { case 1: action1; break; case 2: action2; break; default: defaultaction; break; } </programlisting> </para> </sect1> <sect1 id="standards.funcalls"> <title>÷ÙÚÏ× ÆÕÎËÃÉÊ</title> <para> æÕÎËÃÉÉ ÄÏÌÖÎÙ ×ÙÚÙ×ÁÔØÓÑ ÂÅÚ ÐÒÏÂÅÌÏ× ÍÅÖÄÕ ÉÍÅÎÅÍ ÆÕÎËÃÉÉ É É ÏÔËÒÙÔÏÊ ËÒÕÇÌÏÊ ÓËÏÂËÏ, É ÐÅÒ×ÙÍ ÐÁÒÁÍÅÔÒÏÍ; ÐÒÏÂÅÌÙ ÍÅÖÄÕ ÚÁÐÑÔÙÍÉ É ËÁÖÄÙÍ ÐÁÒÁÍÅÔÒÏÍ, É ÂÅÚ ÐÒÏÂÅÌÏ× ÍÅÖÄÕ ÐÏÓÌÅÄÎÉÍ ÐÁÒÁÍÅÔÒÏÍ É ÚÁËÒÙ×ÁÀÝÅÊ ËÒÕÇÌÏÊ ÓËÏÂËÏÊ, É ÔÏÞËÏÊ Ó ÚÁÐÑÔÏÊ. ÷ÏÔ ÐÒÉÍÅÒ: <programlisting role="php"> $var = foo($bar, $baz, $quux); </programlisting> </para> <para> ëÁË ÐÏËÁÚÁÎÏ ÄÏÌÖÅÎ ÂÙÔØ ÏÄÉÎ ÐÒÏÂÅÌ Ó ËÁÖÄÏÊ ÓÔÏÒÏÎÙ ÚÎÁËÁ "ÒÁ×ÎÏ", ËÏÔÏÒÙÊ ÉÓÐÏÌØÚÕÅÔØÓÑ ÄÌÑ ×ÏÚ×ÒÁÝÅÎÉÑ ÚÎÁÞÅÎÉÑ ÆÕÎËÃÉÉ × ÐÅÒÅÍÅÎÎÕÀ. üÔÏ ÕÄÏÂÎÙÊ ÓÐÏÓÏ ÐÒÉÓ×ÁÉ×ÁÎÉÑ, ÂÏÌØÛÅ ÐÒÏÂÅÌÏ× ÍÏÖÅÔ ÂÙÔØ ÉÓÐÏÌØÚÏ×ÁÎÏ ÄÌÑ ÕÌÕÞÛÅÎÉÑ ÞÉÔÁÂÅÌØÎÏÓÔÉ. <programlisting role="php"> $short = foo($bar); $long_variable = foo($baz); </programlisting> </para> </sect1> <sect1 id="standards.funcdef"> <title>ïÐÒÅÄÅÌÅÎÉÅ æÕÎËÃÉÊ</title> <para> <programlisting role="php"> function fooFunction($arg1, $arg2 = '') { if (condition) { statement; } return $val; } </programlisting> </para> <para> áÒÇÕÍÅÎÔÙ ÓÏ ÚÎÁÞÅÎÉÑÍÉ ÐÏ ÕÍÏÌÞÁÎÉÀ ÄÏÌÖÎÙ ÂÙÔØ × ËÏÎÃÅ ÓÐÉÓËÁ ÁÒÇÕÍÅÎÔÏ×. ÷ÓÅÇÄÁ ÓÔÁÒÁÊÔÅÓØ ×ÏÚ×ÒÁÝÑÔØ ÐÏÄÄÁÀÝÅÅÓÑ ÉÎÔÅÒÐÒÅÔÁÃÉÉ ÚÎÁÞÅÎÉÅ. ÷ÏÔ ÂÏÌÅÅ ÐÏÌÎÙÊ ÐÒÉÍÅÒ: <programlisting role="php"> function connect(&$dsn, $persistent = false) { if (is_array($dsn)) { $dsninfo = &$dsn; } else { $dsninfo = DB::parseDSN($dsn); } if (!$dsninfo || !$dsninfo['phptype']) { return $this->raiseError(); } return true; } </programlisting> </para> </sect1> <sect1 id="standards.comments"> <title>ëÏÍÍÅÎÔÁÒÉÉ</title> <para> ÷ÎËÔÒÅÎÎÑÑ ÄÏËÕÍÅÎÔÁÃÉÑ ÄÌÑ ËÌÁÓÓÏ× ÄÏÌÖÎÁ ÂÙÔØ × ÆÏÒÍÁÔÅ PHPDoc, ÐÏÈÏÖÁÑ ÎÁ Javadoc. âÏÌÅÅ ÄÅÔÁÌØÎÕÀ ÉÎÆÏÒÍÁÃÉÀ Ï PHPDoc ×Ù ÍÏÖÅÔÅ ÎÁÊÔÉ ÚÄÅÓØ: <ulink url="&url.phpdoc;">&url.phpdoc;</ulink> </para> <para> îÅ ÄÏËÕÍÅÎÔÉÒÏ×ÁÎÎÙÅ ËÏÍÍÅÎÔÁÒÉÉ ÐÏÏÝØÒÑÀÔØÓÑ. çÌÁ×ÎÏÅ ÐÒÁ×ÉÌÏ × ÔÏÍ, ÞÔÏÂÙ ÅÓÌÉ ×Ù ×ÚÇÌÑÎÕÌÉ ÎÁ ËÁËÕÀ ÔÏ ÓÅËÃÉÀ ËÏÄÁ, É ÐÏÄÕÍÁÌÉ "÷ÁÈ, Ñ ÎÅ ÈÏÞÕ É Ð×ÔÁÔØÓÑ ÏÐÉÓÁÔØ ÜÔÏ..", ×Ù ÄÏÌÖÎÙ ËÏÍÍÅÎÔÉÒÏ×ÁÔØ ÜÔÉ ÒÁÚÄÅÌÙ ÄÏ ÔÏÇÏ, ËÁË ×Ù ÚÁÂÕÄÅÔÅ, ËÁË ÜÔÏ ÒÁÂÏÔÁÅÔ. </para> <para> ëÏÍÍÅÎÔÁÒÉÉ × ÓÔÉÌÅ C (/* */) É ÓÔÁÄÁÒÔÎÙÅ C++ ËÏÍÍÅÎÔÁÒÉÉ (// ) ÏÞÅÎØ ÈÏÒÏÛÉ. éÓÐÏÌØÚÏ×ÁÎÉÅ perl/shell ÓÔÉÌÑ ËÏÍÍÅÎÔÁÒÉÅ× (# ) ÐÒÉÍÅÎÑÅÔØÓÑ ÒÅÄËÏ. </para> </sect1> <sect1 id="standards.including"> <title>÷ÓÔÁ×ÌÅÎÉÅ ËÏÄÁ (including)</title> <para> ÷ÅÚÄÅ, ÇÄÙ ×Ù ÂÅÚÏÇÏ×ÏÒÏÞÎÏ ×ÓÔÁ×ÌÑÅÔÅ ËÌÁÓÓ-ÆÁÊÌ, ÉÓÐÏÌØÚÕÊÔÅ ÆÕÎËÃÉÀ <function>require_once</function>. ÷ÅÚÄÅ, ÇÄÙ ×Ù ÕÓÌÏ×ÎÏ ×ÓÔÁ×ÌÑÅÔÅ ËÌÁÓÓ-ÆÁÊÌ, ÉÓÐÏÌØÚÕÊÔÅ ÆÕÎËÃÉÀ <function>include_once</function>. ôÏÇÄÁ ×Ù ÍÏÖÅÔÅ ÂÙÔØ ÓÐÏËÏÊÎÙ, ÞÔÏ ËÌÁÓÓ-ÆÁÊÌÙ ÂÕÄÕÔ ×ËÌÀÞÁÔØÓÑ ÔÏÌØËÏ ÅÄÉÎÏÖÄÙ, É ×ÁÍ ÎÅ ÎÕÖÎÏ ÂÕÄÅÔ ÂÅÓÐÏËÏÉÔØÓÑ Ï ÜÔÏÍ. æÁÊÌÙ, ËÏÔÏÒÙÅ ×ËÌÀÞÅÎÙ Ó ÐÏÍÏÝØÀ <function>require_once</function> ÎÅ ÂÕÄÕÔ ×ËÌÀÞÁÔØÓÑ ÐÏ×ÔÏÒÎÏ ÆÕÎËÃÉÅÊ <function>include_once</function>. <note> <simpara> <function>include_once</function> É <function>require_once</function> - ÜÔÏ ×ÙÒÁÖÅÎÉÑ , ÎÅ ÆÕÎËÃÉÉ. ÷ÁÍ <emphasis>ÎÅ ÎÕÖÎÏ</emphasis> ÏÂÒÁÍÌÑÔØ ËÒÕÇÌÙÍÉ ÓËÏÂËÁÍÉ ÉÍÑ ÆÁÊÌÁ, ËÏÔÏÒÙÊ ×ËÌÀÞÁÅÔØÓÑ. </simpara> </note> </para> </sect1> <sect1 id="standards.tags"> <title>ôÅÇÉ PHP ËÏÄÁ</title> <para> <emphasis>÷ÓÅÇÄÁ</emphasis> ÉÓÐÏÌØÚÕÊÔÅ <literal><?php ?></literal> ÄÌÑ ×ÙÄÅÌÅÎÉÑ PHP ËÏÄÁ, ÎÅ ÉÓÐÏÌØÚÕÊÔÅ ËÏÒÏÔËÉÈ ÔÅÇÏ×, ÔÁËÉÈ ËÁË <literal><? ?></literal>. üÔÏ ÎÅÏÂÈÏÄÉÍÏ ÄÌÑ ÓÏ×ÍÅÓÔÉÍÏÓÔÉ Ó PEAR, Á ÔÁËÖÅ ÄÌÑ ÐÏÒÔÉÒÏ×ÁÎÉÑ É ×ËÌÀÞÅÎÉÑ PHP ËÏÄÁ ÎÁ ÒÁÚÌÉÞÎÙÈ ÏÐÅÒÁÃÉÏÎÎÙÈ ÓÉÓÔÅÍÁÈ É ÕÓÔÁÎÏ×ËÁÈ. </para> </sect1> <sect1 id="standards.header"> <title>âÌÏË ËÏÍÍÅÎÔÁÒÉÅ× × ÚÁÇÏÌÏ×ËÅ</title> <para> ÷ÅÓØ ÉÓÈÏÄÎÙÊ ËÏÄ × ÄÉÓÔÒÉÂÕÔÉ×Å PEAR ÄÏÌÖÎÙ ÓÏÄÅÒÖÁÔØ ÓÌÅÄÕÀÝÉÊ ÂÌÏË ËÏÍÍÅÎÔÁÒÉÅ× × ÚÁÇÏÌÏ×ËÅ: <programlisting role="php"> /* vim: set expandtab tabstop=4 shiftwidth=4: */ // +----------------------------------------------------------------------+ // | PHP version 4.0 | // +----------------------------------------------------------------------+ // | Copyright (c) 1997, 1998, 1999, 2000, 2001 The PHP Group | // +----------------------------------------------------------------------+ // | This source file is subject to version 2.0 of the PHP license, | // | that is bundled with this package in the file LICENSE, and is | // | available at through the world-wide-web at | // | http://www.php.net/license/2_02.txt. | // | If you did not receive a copy of the PHP license and are unable to | // | obtain it through the world-wide-web, please send a note to | // | license@php.net so we can mail you a copy immediately. | // +----------------------------------------------------------------------+ // | Authors: Original Author <author@example.com> | // | Your Name <you@example.com> | // +----------------------------------------------------------------------+ // // $Id$ </programlisting> </para> <para> üÔÏ ÎÅ ÔÒÕÄÎÏÅ ÐÒÁ×ÉÌÏ ÄÌÑ ÔÏÇÏ, ÞÔÏÂÙ ÏÐÒÅÄÅÌÑÔØ ÎÏ×ÙÅ ÉÓÈÏÄÎÉËÉ, Á ÔÁË ÖÅ ×ÎÏÓÉÔØ × ÓÐÉÓÁË Á×ÔÏÒÏ×, ËÏÔÏÒÙÅ ÄÏÂÁ×ÌÑÀÔ ÎÏ×ÙÅ ÉÓÈÏÄÎÉËÉ. </para> <para> ðÒÏÓÔÅÎØËÉÅ ÒÅÏÒÇÁÎÉÚÁÃÉÉ ËÏÄÁ ÉÌÉ ÉÓÐÒÁ×ÌÅÎÉÑ ÂÁÇÏ×. </para> <para> æÁÊÌÙ, ËÏÔÏÒÙÅ ÎÅ ×ÈÏÄÑÔ × ÒÅÐÏÚÉÔÏÒÉÊ PEAR, ÄÏÌÖÎÙ ÔÁË ÖÅ ÉÍÅÔØ ÜÔÏÔ ÓÔÁÔÉÞÅÓËÉÊ ÂÌÏË, ËÏÐÉÒÁÊÔ, ÌÉÃÅÎÚÉÀ, É Á×ÔÏÒÁ. </para> </sect1> <sect1 id="standards.cvstags"> <title>CVS ôÅÇÉ</title> <para> ÷ËÌÀÞÁÊÔÅ ÉÎÆÏÒÍÁÃÉÀ Ï ÐÒÏÉÚ×ÏÄÉÔÅÌÅ × ËÁÖÄÙÊ ÆÁÊÌ × ÙÏÒÍÁÔÅ CVS $Id$. ëÏÇÄÁ ÒÅÄÁËÔÉÒÕÅÔØÓÑ ËÁËÏÊ-ÔÏ ÆÁÊÌ, ÔÏ ÄÏÂÁ×ÌÑÊÔÅ ÜÔÏÔ ÔÅÇ, ÅÓÌÉ ÅÇÏ ÔÁÍ ÅÝÅ ÎÅÔ (ÉÌÉ ÍÅÎÑÊÔÅ ÓÕÝÅÓÔ×ÕÀÝÉÊ, ËÁË ÎÁÐÒÉÍÅÒ ÐÏÌÅ "ÄÁÔÁ ÍÏÄÉÆÉËÁÃÉÉ:" É Ô.Ä.). </para> </sect1> <sect1 id="standards.exampleurls"> <title>ðÒÉÍÅÒÙ URL.</title> <para> éÓÐÏÌØÚÕÊÔÅ "example.com" ÄÌÑ ×ÓÅÈ ÐÒÉÍÅÒÏ× ÓÓÙÌÏË (URL), ÉÓÈÏÄÑ ÉÚ RFC 2606. </para> </sect1> <sect1 id="standards.constants"> <title>éÍÅÎÏ×ÁÎÎÙÅ ËÏÎÓÔÁÎÔÙ.</title> <para> ëÏÎÓÔÁÎÔÙ ÄÏÌÖÎÙ ÂÙÔØ ×ÓÅÇÄÁ ÎÁÐÉÓÁÎÙ × ×ÅÒÈÎÅÍ ÒÅÇÉÓÔÒÅ Ó ÐÏÄÞÅÒËÉ×ÁÎÉÅÍ ÄÌÑ ÒÁÚÄÅÌÅÎÉÑ ÓÌÏ×. ðÒÅÆÉËÓ ËÏÎÓÔÁÎÔ ÄÏÌÖÅÎ ÂÙÔØ ËÁË ÉÍÑ ËÌÁÓÓÁ/ÐÁËÅÔÁ. îÁÐÒÉÍÅÒ, ËÏÎÓÔÁÎÔÙ, ÉÓÐÏÌØÚÕÅÍÙÅ × ÐÁËÅÔÅ <literal>DB::</literal> ÄÏÌÖÎÙ ÎÁÞÉÎÁÔØÓÑ ÎÁ "<literal>DB_</literal>". </para> </sect1> </chapter> <!-- 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 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 -->
Index: peardoc/ru/chapters/intro.xml +++ peardoc/ru/chapters/intro.xml <?xml version='1.0' encoding='KOI8-R' ?> <!-- $Revision: 1.1 $ --> <chapter id="introduction"> <title>÷×ÅÄÅÎÉÅ.</title> <sect1 id="pear-whatis"> <title>þÔÏ ÜÔÏ ×ÏÏÂÝÅ ÔÁËÏÅ: PEAR?</title> <simpara> ðÒÏÅËÔ PHP Extension and Add-on Repository (PEAR) -- ÜÔÏ ÐÏÐÙÔËÁ ÒÁÚÒÁÂÏÔÁÔØ ÓÏÂÒÁÎÉÅ ÓËÒÉÐÔÏ×, ÐÏÈÏÖÉÈ ÎÁ ðÅÒÌÏ×ÓËÉÊ CPAN, ÉÌÉ TeX-Ï×ÙÊ CTAN, ÄÌÑ PHP. PEAR ×ËÌÀÞÁÅÔ × ÓÅÂÑ ÍÎÏÖÅÓÔ×Ï, ÎÁÉÂÏÌÅÅ ÞÁÓÔÏ ÉÓÐÏÌØÚÕÅÍÙÈ ËÏÄÏ×. ðÒÏÄ×ÉÇÁÑ ÉÎÆÒÁÓÔÒÕËÔÕÒÕ É ÏÐÒÅÄÅÌÅÎÉÑ ÓÔÁÎÄÁÒÔÏ×, Ë ËÏÔÏÒÙÍ ÄÏÌÖÎÙ ÐÒÉÄÅÒÖÉ×ÁÔØÓÑ ÒÁÚÒÁÂÏÔÞÉËÉ, PEAR, ×ÍÅÓÔÅ Ó PHP4, ÍÏÖÅÔ ÂÙÔØ ÎÕÖÅÎ ÄÌÑ ÐÏÎÉÍÁÎÉÑ PHP ÎÁ ÂÏÌÅÅ ×ÙÓÏËÏÍ ÕÒÏ×ÎÅ. </simpara> <para> ïÓÎÏ×ÎÁÑ ÃÅÌØ PEAR: <itemizedlist> <listitem> <simpara> ÚÁÇÏÔÏ×ÉÔØ ÕÓÔÏÊÞÉ×ÕÀ ÓÔÒÕËÔÕÒÕ ÂÉÂÌÉÏÔÅË, ÞÔÏÂÙ Á×ÔÏÒÙ ÍÏÇÌÉ ×ÙËÌÁÄÙ×ÁÔØ Ó×ÏÉ ×ÏÄÙ ×ÍÅÓÔÅ Ó ÄÒÕÇÉÍÉ ÒÁÚÒÁÂÏÔÞÉËÁÍÉ, ÄÌÑ ÏÂÝÅÇÏ ÉÓÐÏÌØÚÏ×ÁÎÉÑ </simpara> </listitem> <listitem> <simpara> ÓÄÅÌÁÔØ ÏÂÝÕÀ ÉÎÆÒÁÓÔÒÕËÔÕÒÕ ÄÌÑ ÜÔÏÇÏ ËÏÄÁ. </simpara> </listitem> <listitem> <simpara> ÏÐÒÅÄÅÌÉÔØ ÓÔÁÎÄÁÒÔÙ, ËÏÔÏÒÙÅ ÐÏÍÏÇÕÔ ÒÁÚÒÁÂÏÔÞÉËÁÍ ÐÉÓÁÔØ ËÏÍÐÁËÔÎÙÊ É ÞÁÓÔÏ ÉÓÐÏÌØÚÕÅÍÙÊ ËÏÄ </simpara> </listitem> <listitem> <simpara> ÐÒÅÄÌÏÖÉÔØ ÕÔÉÌÉÔÙ ÄÌÑ ÐÏÄÄÅÒÖÁÎÉÑ É ÒÁÓÐÒÅÄÅÌÅÎÉÑ ËÏÄÁ </simpara> </listitem> </itemizedlist> </para> </sect1> </chapter> <!-- 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 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 --> Index: peardoc/ru/chapters/parts.xml +++ peardoc/ru/chapters/parts.xml <?xml encoding="KOI8-R"?> <!-- $Revision: 1.1 $ --> <chapter id="parts"> <title>ôÒÉ ÞÁÓÔÉ PEAR</title> <simpara> PEAR ÓÏÓÔÏÉÔ ÉÚ ÔÒÅÈ ÞÁÓÔÅÊ, ËÏÔÏÒÙÅ ÏÐÉÓÁÎÙ × ÜÔÏÍ ÒÁÚÄÅÌÅ. </simpara> <sect1 id="parts-core"> <title>ñÄÒÏ</title> <simpara> ñÄÒÏ PEAR ÓÏÄÅÒÖÉÔ ÏÓÎÏ×ÎÏÊ ËÏÄ, ÏÔ ËÏÔÏÒÏÇÏ ÚÁ×ÉÓÑÔ ÍÎÏÇÉÅ ÐÒÏÇÒÁÍÎÙÅ ÐÁËÅÔÙ ÉÚ ÒÁÓÛÉÒÅÎÉÊ. ëÒÏÍÅ ÔÏÇÏ, ÏÎÏ ÓÏÄÅÒÖÉÔ ÕÎÉ×ÅÒÓÁÌØÎÙÊ ËÏÄ ×ÙÓÏËÏÇÏ ÕÒÏ×ÎÑ. </simpara> </sect1> <sect1 id="parts-extended"> <title>òÁÓÛÉÒÅÎÎÁÑ</title> <simpara> òÁÓÛÉÒÅÎÎÁÑ ÞÁÔØ PEAR ÓÏÄÅÒÖÉÔ ÏÓÎÏ×ÎÙÅ ÐÁËÅÔÙ ÐÒÏÇÒÁÍÍ, ÎÁÐÉÓÁÎÎÙÈ ÎÁ PHP; ÉÌÉ ÒÁÓÛÉÒÑÀÛÉÈ PHP, ÎÁÐÉÓÁÎÎÙÈ ÎÁ ó, ËÏÔÏÒÙÅ, × Ó×ÏÀ ÏÞÅÒÅÄØ, ÓÏÏÔ×ÅÔÓÔ×ÕÀÔ <link linkend="standards">ÓÔÁÎÄÁÒÔÁÍ ËÏÄÉÒÏ×ÁÎÉÑ</link> PEAR. </simpara> <para> ðÁËÅÔÙ ÐÒÏÇÒÁÍÍ ÉÚ ÒÁÓÛÉÒÅÎÎÏÊ ÞÁÓÔÉ PEAR ÕÓÔÁÎÁ×ÌÉ×ÁÀÔØÓÑ Ó ÐÏÍÏÛØÀ éÎÓÔÒÕÍÅÎÔÁÌØÎÙÈ ÓÒÅÄÓÔ× PEAR (PEAR installation tools) É ÓÏÏÔ×ÅÔÓÔ×ÕÀÔ <link linkend="standards">ÓÔÁÎÄÁÒÔÁÍ ËÏÄÉÒÏ×ÁÎÉÑ</link> PEAR. </para> </sect1> <sect1 id="parts-pecl"> <title>PECL</title> <simpara> PECL - ÜÔÏ ÒÅÐÏÚÉÔÏÒÉÊ ÄÌÑ ÒÁÓÛÉÒÅÎÉÊ PHP, ÎÁÐÉÓÁÎÎÙÈ ÎÁ C, ËÏÔÏÒÙÅ ÎÅ ÓÏÏÔ×ÅÔÓ×ÕÀÔ <link linkend="standards">ÓÔÁÎÄÁÒÔÁÍ ËÏÄÉÒÏ×ÁÎÉÑ</link> PEAR. </simpara> <para> PECL ÂÙÌ ÓÄÅÌÁÎ ÒÅÐÏÚÉÔÏÒÉÅÍ, ÄÌÑ ÄÅÒÅ×Á ÒÁÓÛÉÒÅÎÉÊ PHP (/ext/ - ÄÉÒÅËÔÏÒÉÑ), ËÏÔÏÒÏÅ ÂÙÌÏ ÐÅÒÅÎÅÓÅÎÏ × PEAR ÉÚ ÄÅÒÅ×Á ÉÓÈÏÄÎÙÈ ÔÅËÓÔÏ× PHP. </para> <para> ôÁË ËÁË éÎÓÔÒÕÍÅÎÔÁÌØÎÙÅ ÓÒÅÄÓÔ×Á PEAR ÎÅ ÐÏÚ×ÏÌÑÀÔ ÎÁ ÄÁÎÎÙÊ ÍÏÍÅÎÔ ÉÎÓÔÁÌÌÉÒÏ×ÁÔØ ÐÁËÅÔÙ ÐÒÏÇÒÁÍ PECL, ÚÄÅÓØ ÐÒÉ×ÏÄÉÔØÓÑ ËÒÁÔËÏÅ ÏÐÉÓÁÎÉÅ ÔÏÇÏ, ËÁË ÜÔÏ ÍÏÖÎÏ ÓÄÅÌÁÔØ: </para> <para> <itemizedlist> <listitem> <simpara> óËÁÞÁÊÔÅ ÐÁËÅÔ ÉÚ PEAR, ÚÁÔÅÍ ÒÁÚÐÁËÕÊÔÅ (TAR) ÅÇÏ ËÕÄÁ ÎÉÂÕÄØ. ðÅÒÅÊÄÉÔÅ × ÜÔÕ ÄÉÒÅËÔÏÒÉÀ É ×ÙÐÏÌÎÉÔÅ ÓÌÅÄÕÀÝÉÅ ÄÅÊÓÔ×ÉÑ. </simpara> </listitem> <listitem> <simpara>phpize</simpara> </listitem> <listitem> <simpara>./configure</simpara> </listitem> <listitem> <simpara>make</simpara> </listitem> <listitem> <simpara>cp modules/module.so /usr/local/lib/php</simpara> </listitem> </itemizedlist> </para> <para> ðÕÔØ, ÇÄÅ ÄÏÌÖÅÎ ÌÅÖÁÔØ ÍÏÄÕÌØ (*.so), ÍÏÖÅÔ ÏÔÌÉÞÁÔØÓÑ × ×ÁÛÅÊ ÓÉÓÔÅÍÅ (ÐÒÏ×ÅÒØÔÅ ÆÁÊÌ <filename>php.ini</filename> É Æ-ÃÉÀ <function> phpinfo</function>). äÌÑ ÉÓÐÏÌØÚÏ×ÁÎÉÑ ÍÏÄÕÌÑ ×Ù ÄÏÌÖÎÙ ÄÏÂÁ×ÉÔØ Ó ÐÏÍÏÛØÀ ÄÉÒÅËÔÉ×Ù extension × php.ini ÉÌÉ ÚÁÇÒÕÖÁÔØ ÅÇÏ Ó ÐÏÍÏÛØÀ ÆÕÎËÃÉÉ dl("module.so") ÉÚ ×ÙÛÅÇÏ php-ÆÁÊÌÁ. </para> <para> ÷Ù ÔÁËÖÅ ÍÏÖÅÔÅ ×ËÏÍÐÉÌÉÔØ ÜÔÏ ÒÁÓÛÉÒÅÎÉÅ ÐÒÑÍÏ × ×ÁÛ ÂÉÎÁÒÎÉË php. äÌÑ ÜÔÏÇÏ ×ÁÍ ÎÕÖÎÏ ÒÁÚÐÁËÏ×ÁÔØ ÐÁËÅÔ × php4/ext (× ÄÉÒÅËÔÏÒÉÉ Ó ÉÓÈÏÄÎÙÍÉ ÔÅËÓÔÁÍÉ PHP). ðÏÓÌÅ ÜÔÏÇÏ ÚÁÐÕÓÔÉÔÅ ÔÁËÖÅ phpize × ÄÉÒÅËÔÏÒÉÉ ÜÔÏÇÏ ÎÏ×ÏÇÏ ÍÏÄÕÌÑ. îÏ ÐÒÅÖÄÅ ×ÁÍ ÎÕÖÎÏ ÓËÏÎÆÉÇÕÒÉÒÏ×ÁÔØ ×ÁÛ php, ×Ù ÄÏÌÖÎÙ ÚÁÐÕÓÔÉÔØ <filename>./buildconf</filename> × ×ÅÒÈÎÅÊ ÄÉÒÅËÔÏÒÉÉ ÄÅÒÅ×Á ÉÓÈÏÄÎÉËÏ× php. ôÅÐÅÒØ ×Ù ÍÏÖÅÔÅ ËÏÎÆÉÇÕÒÉÔØ/ËÏÍÐÉÌÉÔØ (configure/compile) ×ÁÛ PHP Ó ÎÏ×ÙÍ ÍÏÄÕÌÅÍ, ÔÁË ËÁË ×Ù ÜÔÏ ÄÅÌÁÌÉ Ó ÄÒÕÇÉÍÉ ÓÔÁÎÄÁÒÔÎÙÍÉ ÍÏÄÕÌÑÍÉ. </para> </sect1> </chapter> <!-- 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 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 --> Index: peardoc/ru/chapters/standards.xml +++ peardoc/ru/chapters/standards.xml <?xml version='1.0' encoding='KOI8-R' ?> <chapter id="standards"> <title>óÔÁÎÄÁÒÔÙ ËÏÄÉÒÏ×ÁÎÉÑ PEAR</title> <note> <simpara> óÔÁÎÄÁÒÔÙ ËÏÄÉÒÏ×ÁÎÉÑ PEAR ÉÓÐÏÌØÚÕÀÔØÓÑ × ËÏÄÅ, ËÏÔÏÒÙÊ × ÉÔÏÇÅ ÓÔÁÅÔ ÞÁÓÔØÀ PEAR, ËÏÔÏÒÙÊ × Ó×ÏÀ ÏÞÅÒÅÄØ ÐÏÓÔÁ×ÌÑÅÔØÓÑ Ó ÄÉÓÔÒÉÂÕÔÉ×ÏÍ PHP ÉÌÉ ÄÏÓÔÕÐÅÎ ÄÌÑ ÓËÁÞÉ×ÁÎÉÑ ÞÅÒÅÚ ÕÔÉÌÉÔÙ ÉÎÓÔÁÌÑÃÉÉ PEAR. </simpara> </note> <sect1 id="standards.indenting"> <title>óÔÒÕËÔÕÒÁ ÎÁÐÉÓÁÎÉÑ</title> <para> éÓÐÏÌØÚÕÊÔÅ ÄÌÑ ÏÔÓÔÕÐÁ 4 ÐÒÏÂÅÌÁ, ÎÅ ÔÁÂÕÌÑÃÉÀ. åÓÌÉ ×Ù ÉÓÐÏÌØÚÕÅÔÅ Emacs ÄÌÑ ÒÅÄÁËÔÉÒÏ×ÁÎÉÑ ËÏÄÁ, ×Ù ÄÏÌÖÎÙ ÕÓÔÁÎÏ×ÉÔØ indent-tabs-mode × ÎÏÌØ. úÄÅÓØ ÐÒÉÍÅÒ ÐÏËÁÚÙ×ÁÀÝÉÊ ËÁË ÎÁÓÔÒÏÉÔØ Emacs (hook) (×Ù ÄÏÌÖÎÙ ÂÙÔØ Õ×ÅÒÅÎÙ ÞÔÏ ÜÔÏ ÂÕÄÅÔ ×ÙÚÙ×ÁÔØÓÑ, ËÏÇÄÙ ×Ù ÒÅÄÁËÔÉÒÕÅÔÅ php ÆÁÊÌÙ): <programlisting role="elisp"> (defun php-mode-hook () (setq tab-width 4 c-basic-offset 4 c-hanging-comment-ender-p nil indent-tabs-mode (not (and (string-match "/\\(PEAR\\|pear\\)/" (buffer-file-name)) (string-match "\.php$" (buffer-file-name)))))) </programlisting> </para> <para> á ÜÔÏ ÐÒÁ×ÉÌÁ ÕÓÔÁÎÏ×ËÉ ÄÌÑ vim ÒÅÄÁËÔÏÒÁ: <programlisting role="vim"> set expandtab set shiftwidth=4 set tabstop=4 </programlisting> </para> </sect1> <sect1 id="standards.control"> <title>õÐÒÁ×ÌÑÀÝÉÅ ÓÔÒÕËÔÕÒÙ</title> <para> ïÎÉ ×ËÌÕÞÁÀÔ ÏÐÅÒÁÔÏÒÙ if, for, while, switch, É Ô.Ä. úÄÅÓØ ÐÒÉÍÅÒ ÏÆÏÒÍÌÅÎÉÑ ÎÅÍÎÏÇÏ ÚÁÐÕÔÁÎÎÏÇÏ ÕÓÌÏ×ÉÑ: <programlisting role="php"> if ((condition1) || (condition2)) { action1; } elseif ((condition3) && (condition4)) { action2; } else { defaultaction; } </programlisting> </para> <simpara> õÐÒÁ×ÌÑÀÝÉÅ ×ÙÒÁÖÅÎÉÑ ÄÏÌÖÎÙ ÉÍÅÔØ ÏÄÉÎ ÐÒÏÂÅÌ ÍÅÖÄÕ ËÏÎÔÒÏÌØÎÙÍÉ ÏÐÅÒÁÔÏÒÁÍÉ É ËÒÕÇÌÙÍÉ ÓËÏÂËÁÍÉ, ÞÔÏÂÙ ÒÁÚÌÉÞÁÔØ ÉÈ ÏÔ ×ÙÚÏ×Ï× ÆÕÎËÃÉÊ. </simpara> <simpara> ÷Ù ÄÏÌÖÎÙ ÐÒÉÄÅÒÖÉ×ÁÔØÓÑ ÍÅÔÏÄÁ, ÞÔÏ ÆÉÇÕÒÎÙÅ ÓËÏÂËÉ ÎÕÖÎÏ ÓÔÁ×ÉÔØ ×ÅÚÄÅ,ÄÁÖÅ ÅÓÌÉ ÏÎÉ ÔÅÈÎÉÞÅÓËÉ ÎÅ ÏÂÑÚÁÔÅÌØÎÙ. ó ÐÏÍÏÝØÀ ÉÈ ×ÏÚÒÁÓÔÁÅÔ ÞÉÔÁÂÅÌØÎÏÓÔØ É ÕÍÅÎØÛÁÅÔØÓÑ ×ÅÒÏÑÔÎÏÓÔØ ÌÏÇÉÞÅÓËÉÈ ÏÛÉÂÏË ÐÒÉ ÄÏÂÁ×ÌÅÎÉÉ ÎÏ×ÙÈ ÓÔÒÏË × ËÏÄ. </simpara> <para> äÌÑ ×ÙÒÁÖÅÎÉÑ switch: <programlisting role="php"> switch (condition) { case 1: action1; break; case 2: action2; break; default: defaultaction; break; } </programlisting> </para> </sect1> <sect1 id="standards.funcalls"> <title>÷ÙÚÏ× ÆÕÎËÃÉÊ</title> <para> æÕÎËÃÉÉ ÄÏÌÖÎÙ ×ÙÚÙ×ÁÔØÓÑ ÂÅÚ ÐÒÏÂÅÌÏ× ÍÅÖÄÕ ÉÍÅÎÅÍ ÆÕÎËÃÉÉ É É ÏÔËÒÙÔÏÊ ËÒÕÇÌÏÊ ÓËÏÂËÏ, É ÐÅÒ×ÙÍ ÐÁÒÁÍÅÔÒÏÍ; ÐÒÏÂÅÌÙ ÍÅÖÄÕ ÚÁÐÑÔÙÍÉ É ËÁÖÄÙÍ ÐÁÒÁÍÅÔÒÏÍ, É ÂÅÚ ÐÒÏÂÅÌÏ× ÍÅÖÄÕ ÐÏÓÌÅÄÎÉÍ ÐÁÒÁÍÅÔÒÏÍ É ÚÁËÒÙ×ÁÀÝÅÊ ËÒÕÇÌÏÊ ÓËÏÂËÏÊ, É ÔÏÞËÏÊ Ó ÚÁÐÑÔÏÊ. ÷ÏÔ ÐÒÉÍÅÒ: <programlisting role="php"> $var = foo($bar, $baz, $quux); </programlisting> </para> <para> ëÁË ÐÏËÁÚÁÎÏ ÄÏÌÖÅÎ ÂÙÔØ ÏÄÉÎ ÐÒÏÂÅÌ Ó ËÁÖÄÏÊ ÓÔÏÒÏÎÙ ÚÎÁËÁ "ÒÁ×ÎÏ", ËÏÔÏÒÙÊ ÉÓÐÏÌØÚÕÅÔØÓÑ ÄÌÑ ×ÏÚ×ÒÁÝÅÎÉÑ ÚÎÁÞÅÎÉÑ ÆÕÎËÃÉÉ × ÐÅÒÅÍÅÎÎÕÀ. üÔÏ ÕÄÏÂÎÙÊ ÓÐÏÓÏ ÐÒÉÓ×ÁÉ×ÁÎÉÑ, ÂÏÌØÛÅ ÐÒÏÂÅÌÏ× ÍÏÖÅÔ ÂÙÔØ ÉÓÐÏÌØÚÏ×ÁÎÏ ÄÌÑ ÕÌÕÞÛÅÎÉÑ ÞÉÔÁÂÅÌØÎÏÓÔÉ. <programlisting role="php"> $short = foo($bar); $long_variable = foo($baz); </programlisting> </para> </sect1> <sect1 id="standards.funcdef"> <title>ïÐÒÅÄÅÌÅÎÉÅ æÕÎËÃÉÊ</title> <para> <programlisting role="php"> function fooFunction($arg1, $arg2 = '') { if (condition) { statement; } return $val; } </programlisting> </para> <para> áÒÇÕÍÅÎÔÙ ÓÏ ÚÎÁÞÅÎÉÑÍÉ ÐÏ ÕÍÏÌÞÁÎÉÀ ÄÏÌÖÎÙ ÂÙÔØ × ËÏÎÃÅ ÓÐÉÓËÁ ÁÒÇÕÍÅÎÔÏ×. ÷ÓÅÇÄÁ ÓÔÁÒÁÊÔÅÓØ ×ÏÚ×ÒÁÝÑÔØ ÐÏÄÄÁÀÝÅÅÓÑ ÉÎÔÅÒÐÒÅÔÁÃÉÉ ÚÎÁÞÅÎÉÅ. ÷ÏÔ ÂÏÌÅÅ ÐÏÌÎÙÊ ÐÒÉÍÅÒ: <programlisting role="php"> function connect(&$dsn, $persistent = false) { if (is_array($dsn)) { $dsninfo = &$dsn; } else { $dsninfo = DB::parseDSN($dsn); } if (!$dsninfo || !$dsninfo['phptype']) { return $this->raiseError(); } return true; } </programlisting> </para> </sect1> <sect1 id="standards.comments"> <title>ëÏÍÍÅÎÔÁÒÉÉ</title> <para> ÷ÎËÔÒÅÎÎÑÑ ÄÏËÕÍÅÎÔÁÃÉÑ ÄÌÑ ËÌÁÓÓÏ× ÄÏÌÖÎÁ ÂÙÔØ × ÆÏÒÍÁÔÅ PHPDoc, ÐÏÈÏÖÁÑ ÎÁ Javadoc. âÏÌÅÅ ÄÅÔÁÌØÎÕÀ ÉÎÆÏÒÍÁÃÉÀ Ï PHPDoc ×Ù ÍÏÖÅÔÅ ÎÁÊÔÉ ÚÄÅÓØ: <ulink url="&url.phpdoc;">&url.phpdoc;</ulink> </para> <para> îÅ ÄÏËÕÍÅÎÔÉÒÏ×ÁÎÎÙÅ ËÏÍÍÅÎÔÁÒÉÉ ÐÏÏÝØÒÑÀÔØÓÑ. çÌÁ×ÎÏÅ ÐÒÁ×ÉÌÏ × ÔÏÍ, ÞÔÏÂÙ ÅÓÌÉ ×Ù ×ÚÇÌÑÎÕÌÉ ÎÁ ËÁËÕÀ ÔÏ ÓÅËÃÉÀ ËÏÄÁ, É ÐÏÄÕÍÁÌÉ "÷ÁÈ, Ñ ÎÅ ÈÏÞÕ É Ð×ÔÁÔØÓÑ ÏÐÉÓÁÔØ ÜÔÏ..", ×Ù ÄÏÌÖÎÙ ËÏÍÍÅÎÔÉÒÏ×ÁÔØ ÜÔÉ ÒÁÚÄÅÌÙ ÄÏ ÔÏÇÏ, ËÁË ×Ù ÚÁÂÕÄÅÔÅ, ËÁË ÜÔÏ ÒÁÂÏÔÁÅÔ. </para> <para> ëÏÍÍÅÎÔÁÒÉÉ × ÓÔÉÌÅ C (/* */) É ÓÔÁÄÁÒÔÎÙÅ C++ ËÏÍÍÅÎÔÁÒÉÉ (// ) ÏÞÅÎØ ÈÏÒÏÛÉ. éÓÐÏÌØÚÏ×ÁÎÉÅ perl/shell ÓÔÉÌÑ ËÏÍÍÅÎÔÁÒÉÅ× (# ) ÐÒÉÍÅÎÑÅÔØÓÑ ÒÅÄËÏ. </para> </sect1> <sect1 id="standards.including"> <title>÷ÓÔÁ×ÌÅÎÉÅ ËÏÄÁ (including)</title> <para> ÷ÅÚÄÅ, ÇÄÙ ×Ù ÂÅÚÏÇÏ×ÏÒÏÞÎÏ ×ÓÔÁ×ÌÑÅÔÅ ËÌÁÓÓ-ÆÁÊÌ, ÉÓÐÏÌØÚÕÊÔÅ ÆÕÎËÃÉÀ <function>require_once</function>. ÷ÅÚÄÅ, ÇÄÙ ×Ù ÕÓÌÏ×ÎÏ ×ÓÔÁ×ÌÑÅÔÅ ËÌÁÓÓ-ÆÁÊÌ, ÉÓÐÏÌØÚÕÊÔÅ ÆÕÎËÃÉÀ <function>include_once</function>. ôÏÇÄÁ ×Ù ÍÏÖÅÔÅ ÂÙÔØ ÓÐÏËÏÊÎÙ, ÞÔÏ ËÌÁÓÓ-ÆÁÊÌÙ ÂÕÄÕÔ ×ËÌÀÞÁÔØÓÑ ÔÏÌØËÏ ÅÄÉÎÏÖÄÙ, É ×ÁÍ ÎÅ ÎÕÖÎÏ ÂÕÄÅÔ ÂÅÓÐÏËÏÉÔØÓÑ Ï ÜÔÏÍ. æÁÊÌÙ, ËÏÔÏÒÙÅ ×ËÌÀÞÅÎÙ Ó ÐÏÍÏÝØÀ <function>require_once</function> ÎÅ ÂÕÄÕÔ ×ËÌÀÞÁÔØÓÑ ÐÏ×ÔÏÒÎÏ ÆÕÎËÃÉÅÊ <function>include_once</function>. <note> <simpara> <function>include_once</function> É <function>require_once</function> - ÜÔÏ ×ÙÒÁÖÅÎÉÑ , ÎÅ ÆÕÎËÃÉÉ. ÷ÁÍ <emphasis>ÎÅ ÎÕÖÎÏ</emphasis> ÏÂÒÁÍÌÑÔØ ËÒÕÇÌÙÍÉ ÓËÏÂËÁÍÉ ÉÍÑ ÆÁÊÌÁ, ËÏÔÏÒÙÊ ×ËÌÀÞÁÅÔØÓÑ. </simpara> </note> </para> </sect1> <sect1 id="standards.tags"> <title>ôÅÇÉ PHP ËÏÄÁ</title> <para> <emphasis>÷ÓÅÇÄÁ</emphasis> ÉÓÐÏÌØÚÕÊÔÅ <literal><?php ?></literal> ÄÌÑ ×ÙÄÅÌÅÎÉÑ PHP ËÏÄÁ, ÎÅ ÉÓÐÏÌØÚÕÊÔÅ ËÏÒÏÔËÉÈ ÔÅÇÏ×, ÔÁËÉÈ ËÁË <literal><? ?></literal>. üÔÏ ÎÅÏÂÈÏÄÉÍÏ ÄÌÑ ÓÏ×ÍÅÓÔÉÍÏÓÔÉ Ó PEAR, Á ÔÁËÖÅ ÄÌÑ ÐÏÒÔÉÒÏ×ÁÎÉÑ É ×ËÌÀÞÅÎÉÑ PHP ËÏÄÁ ÎÁ ÒÁÚÌÉÞÎÙÈ ÏÐÅÒÁÃÉÏÎÎÙÈ ÓÉÓÔÅÍÁÈ É ÕÓÔÁÎÏ×ËÁÈ. </para> </sect1> <sect1 id="standards.header"> <title>âÌÏË ËÏÍÍÅÎÔÁÒÉÅ× × ÚÁÇÏÌÏ×ËÅ</title> <para> ÷ÅÓØ ÉÓÈÏÄÎÙÊ ËÏÄ × ÄÉÓÔÒÉÂÕÔÉ×Å PEAR ÄÏÌÖÎÙ ÓÏÄÅÒÖÁÔØ ÓÌÅÄÕÀÝÉÊ ÂÌÏË ËÏÍÍÅÎÔÁÒÉÅ× × ÚÁÇÏÌÏ×ËÅ: <programlisting role="php"> /* vim: set expandtab tabstop=4 shiftwidth=4: */ // +----------------------------------------------------------------------+ // | PHP version 4.0 | // +----------------------------------------------------------------------+ // | Copyright (c) 1997, 1998, 1999, 2000, 2001 The PHP Group | // +----------------------------------------------------------------------+ // | This source file is subject to version 2.0 of the PHP license, | // | that is bundled with this package in the file LICENSE, and is | // | available at through the world-wide-web at | // | http://www.php.net/license/2_02.txt. | // | If you did not receive a copy of the PHP license and are unable to | // | obtain it through the world-wide-web, please send a note to | // | license@php.net so we can mail you a copy immediately. | // +----------------------------------------------------------------------+ // | Authors: Original Author <author@example.com> | // | Your Name <you@example.com> | // +----------------------------------------------------------------------+ // // $Id$ </programlisting> </para> <para> üÔÏ ÎÅ ÔÒÕÄÎÏÅ ÐÒÁ×ÉÌÏ ÄÌÑ ÔÏÇÏ, ÞÔÏÂÙ ÏÐÒÅÄÅÌÑÔØ ÎÏ×ÙÅ ÉÓÈÏÄÎÉËÉ, Á ÔÁË ÖÅ ×ÎÏÓÉÔØ × ÓÐÉÓÁË Á×ÔÏÒÏ×, ËÏÔÏÒÙÅ ÄÏÂÁ×ÌÑÀÔ ÎÏ×ÙÅ ÉÓÈÏÄÎÉËÉ. </para> <para> ðÒÏÓÔÅÎØËÉÅ ÒÅÏÒÇÁÎÉÚÁÃÉÉ ËÏÄÁ ÉÌÉ ÉÓÐÒÁ×ÌÅÎÉÑ ÂÁÇÏ×. </para> <para> æÁÊÌÙ, ËÏÔÏÒÙÅ ÎÅ ×ÈÏÄÑÔ × ÒÅÐÏÚÉÔÏÒÉÊ PEAR, ÄÏÌÖÎÙ ÔÁË ÖÅ ÉÍÅÔØ ÜÔÏÔ ÓÔÁÔÉÞÅÓËÉÊ ÂÌÏË, ËÏÐÉÒÁÊÔ, ÌÉÃÅÎÚÉÀ, É Á×ÔÏÒÁ. </para> </sect1> <sect1 id="standards.cvstags"> <title>CVS ôÅÇÉ</title> <para> ÷ËÌÀÞÁÊÔÅ ÉÎÆÏÒÍÁÃÉÀ Ï ÐÒÏÉÚ×ÏÄÉÔÅÌÅ × ËÁÖÄÙÊ ÆÁÊÌ × ÙÏÒÍÁÔÅ CVS $Id$. ëÏÇÄÁ ÒÅÄÁËÔÉÒÕÅÔØÓÑ ËÁËÏÊ-ÔÏ ÆÁÊÌ, ÔÏ ÄÏÂÁ×ÌÑÊÔÅ ÜÔÏÔ ÔÅÇ, ÅÓÌÉ ÅÇÏ ÔÁÍ ÅÝÅ ÎÅÔ (ÉÌÉ ÍÅÎÑÊÔÅ ÓÕÝÅÓÔ×ÕÀÝÉÊ, ËÁË ÎÁÐÒÉÍÅÒ ÐÏÌÅ "ÄÁÔÁ ÍÏÄÉÆÉËÁÃÉÉ:" É Ô.Ä.). </para> </sect1> <sect1 id="standards.exampleurls"> <title>ðÒÉÍÅÒÙ URL.</title> <para> éÓÐÏÌØÚÕÊÔÅ "example.com" ÄÌÑ ×ÓÅÈ ÐÒÉÍÅÒÏ× ÓÓÙÌÏË (URL), ÉÓÈÏÄÑ ÉÚ RFC 2606. </para> </sect1> <sect1 id="standards.constants"> <title>éÍÅÎÏ×ÁÎÎÙÅ ËÏÎÓÔÁÎÔÙ.</title> <para> ëÏÎÓÔÁÎÔÙ ÄÏÌÖÎÙ ÂÙÔØ ×ÓÅÇÄÁ ÎÁÐÉÓÁÎÙ × ×ÅÒÈÎÅÍ ÒÅÇÉÓÔÒÅ Ó ÐÏÄÞÅÒËÉ×ÁÎÉÅÍ ÄÌÑ ÒÁÚÄÅÌÅÎÉÑ ÓÌÏ×. ðÒÅÆÉËÓ ËÏÎÓÔÁÎÔ ÄÏÌÖÅÎ ÂÙÔØ ËÁË ÉÍÑ ËÌÁÓÓÁ/ÐÁËÅÔÁ. îÁÐÒÉÍÅÒ, ËÏÎÓÔÁÎÔÙ, ÉÓÐÏÌØÚÕÅÍÙÅ × ÐÁËÅÔÅ <literal>DB::</literal> ÄÏÌÖÎÙ ÎÁÞÉÎÁÔØÓÑ ÎÁ "<literal>DB_</literal>". </para> </sect1> </chapter> <!-- 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 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 -->