cvs: phpdoc-ru / preface.xml /chapters intro.xml /language/control-structures if.xml

shafff Sat Jan 17 12:35:57 2009 UTC Added files: /phpdoc-ru/language/control-structures if.xml Modified files: /phpdoc-ru preface.xml /phpdoc-ru/chapters intro.xml Log: add if.xml, update few files to reflect current english version, edit translation

http://cvs.php.net/viewvc.cgi/phpdoc-ru/preface.xml?r1=1.19&r2=1.20&diff_format=u Index: phpdoc-ru/preface.xml diff -u phpdoc-ru/preface.xml:1.19 phpdoc-ru/preface.xml:1.20 --- phpdoc-ru/preface.xml:1.19 Wed Oct 10 10:40:33 2007 +++ phpdoc-ru/preface.xml Sat Jan 17 12:35:57 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 1.31 Maintainer: tronic Status: ready --> -<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.35 Maintainer: tronic Status: ready --> +<!-- $Revision: 1.20 $ --> <preface xml:id="preface" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <info> @@ -8,15 +8,15 @@ <abstract> <simpara> - <acronym>PHP</acronym>, что означает "PHP: Препроцессор - Гипертекста", является широко используемым языком сценариев - общего назначения с открытым исходным кодом. PHP создавался - специально для ведения Web-разработок и может использоваться - непосредственно в HTML-коде. Синтаксис языка берет начало - из C, Java и Perl и является легким для изучения. Преимущественным - назначением PHP является предоставление web-разработчикам + <acronym>PHP</acronym>, что расшифровывается как + PHP: Hypertext Preprocessor -- «PHP: Препроцессор Гипертекста», + является распространённым интерпретируемым языком общего назначения + с открытым исходным кодом. PHP создавался специально для ведения + Web-разработок и код на нём может внедряться непосредственно в HTML-код. + Синтаксис языка берёт начало из C, Java и Perl и является лёгким для изучения. + Основной целью PHP является предоставление web-разработчикам возможности быстрого создания динамически генерируемых web-страниц, - однако, область применения PHP не ограничивается только этим. + однако область применения PHP не ограничивается только этим. </simpara> </abstract> </info> @@ -31,11 +31,11 @@ </para> <para> - Вы можете получить это руководство в нескольких форматах + Это руководство доступно в нескольких форматах по адресу <link xlink:href="&url.php.doc.downloads;">&url.php.doc.downloads;</link>. - Более подробную информацию о том, как ведется работа над - руководством, вы сможете получить, обратившись к приложению - <link linkend="about">'Об этом руководстве'</link>. Если вам интересна + Более подробную информацию о том, как ведётся работа над + руководством, вы сможете получить обратившись к приложению + <link linkend="about">Об этом руководстве</link>. Если вам интересна <link linkend="history">история PHP</link>, обратитесь к соответствующему приложению. </para> http://cvs.php.net/viewvc.cgi/phpdoc-ru/chapters/intro.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-ru/chapters/intro.xml diff -u phpdoc-ru/chapters/intro.xml:1.5 phpdoc-ru/chapters/intro.xml:1.6 --- phpdoc-ru/chapters/intro.xml:1.5 Thu Jan 24 14:29:01 2008 +++ phpdoc-ru/chapters/intro.xml Sat Jan 17 12:35:57 2009 @@ -1,24 +1,24 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 1.37 Maintainer: tronic Status: ready --> -<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.49 Maintainer: shafff Status: ready --> +<!-- $Revision: 1.6 $ --> <chapter xml:id="introduction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Введение</title> + <info><title>Введение</title></info> - <sect1 xml:id="intro-whatis"> + <section xml:id="intro-whatis"> <title>Что такое PHP?</title> <para> <acronym>PHP</acronym> (рекурсивный акроним словосочетания - "PHP: Hypertext Preprocessor") - это широко используемый - язык программирования общего назначения с открытым - исходным кодом. PHP сконструирован специально для - ведения Web-разработок и может внедряться в HTML-код. + "PHP: Hypertext Preprocessor) - это распространённый + язык программирования общего назначения с открытым исходным кодом. + PHP сконструирован специально для ведения Web-разработок и + код на нём может внедряться в HTML-код. </para> <para> - Простой ответ, но что он может означать? Вот пример: + Простой ответ, но что он может означать? Вот пример кода: </para> <para> <example> - <title>Пример программирования на PHP</title> + <info><title>Пример программирования на PHP</title></info> <programlisting role="php"> <![CDATA[ <html> @@ -38,27 +38,23 @@ </example> </para> <para> - Обратите внимание на отличие этого скрипта от скриптов, - написанных на других языках, например, на Perl или C - - вместо того, чтобы создавать программу, которая занимается - формированием HTML-кода и содержит бесчисленное множество - предназначенных для этого команд, вы создаете HTML-код - с несколькими внедренными командами PHP (в приведенном - случае, предназначенными для вывода текста). Код PHP - отделяется специальными <link - linkend="language.basic-syntax.phpmode">начальным и конечным тегами</link>, - которые позволяют процессору PHP определять начало и конец участка HTML-кода, - содержащего PHP-скрипт. - </para> - <para> - Значительным отличием PHP от какого-либо кода, выполняющегося - на стороне клиента, например, JavaScript, является то, что - PHP-скрипты выполняются на сервере. Если бы у вас на сервере - был размещен скрипт, подобный вышеприведенному, клиент - получил бы только результат выполнения скрипта, причем он не + Вместо рутинного вывода HTML-кода командами языка + (как это происходит, например, в Perl или C), + сценарий PHP содержит HTML с вкраплениями кода (в нашем + случае, это вывод текста "Привет, я - скрипт PHP!"). + Код PHP отделяется специальными <link + linkend="language.basic-syntax.phpmode">начальным и конечным тегами + <code>&lt;?php</code> и <code>?&gt;</code></link>, + которые позволяют процессору PHP найти где PHP-код, а где просто HTML. + </para> + <para> + PHP отличается от JavaScript тем, что + PHP-сценарии выполняются на сервере. Если бы у вас на сервере + был размещён сценарий, подобный вышеприведенному, клиент + получил бы только результат выполнения скрипта, причём он не смог бы выяснить, какой именно код выполняется. Вы даже - можете сконфигурировать свой сервер таким образом, чтобы - HTML-файлы обрабатывались процессором PHP, так что клиенты + можете настроить свой сервер таким образом, чтобы + обычные HTML-файлы обрабатывались процессором PHP, так что клиенты даже не смогут узнать, получают ли они обычный HTML-файл или результат выполнения скрипта. </para> @@ -77,30 +73,29 @@ с <link linkend="tutorial">Вводного руководства</link>, если вас интересует исключительно веб-программирование. </para> - </sect1> + </section> - <sect1 xml:id="intro-whatcando"> - <title>Возможности PHP</title> + <section xml:id="intro-whatcando"> + <info><title>Возможности PHP</title></info> <para> - PHP может все. Главным образом, область применения PHP - сфокусирована на написание скриптов, работающих на - стороне сервера; таким образом, PHP способен выполнять - всё то, что выполняет любая другая программа CGI, например, - обрабатывать данных форм, генерировать динамические - страницы или отсылать и принимать cookies. Но PHP - способен выполнять и множество других задач. + PHP может всё. Главная область применения PHP + - на написание скриптов, работающих на стороне сервера; + таким образом, PHP способен выполнять всё то, что выполняет любая другая программа CGI, + например, обрабатывать данных форм, генерировать динамические + страницы или отсылать и принимать cookies. + Но PHP способен выполнять и многие другие задачи. </para> <para> - Существуют три основных области, где используется PHP. + Существуют три основных области применения PHP. <itemizedlist> <listitem> <simpara> Создание скриптов для выполнения на стороне сервера. PHP наиболее широко используется именно таким - образом. Все, что вам понадобится, это парсер PHP + образом. Всё, что вам понадобится, это интерпретатор PHP (в виде программы CGI или серверного модуля), веб-сервер - и броузер. Чтобы вы могли просматривать результаты - выполнения PHP-скриптов в броузере, вам нужен + и браузер. Для того чтобы можно было просматривать результаты + выполнения PHP-скриптов в браузере, нужен работающий веб-сервер и установленный PHP. В случае, если вы просто экспериментируете, вы вполне можете использовать свой домашний компьютер вместо сервера. За более @@ -147,8 +142,7 @@ PHP доступен для большинства операционных систем, включая Linux, многие модификации Unix (такие, как HP-UX, Solaris и OpenBSD), Microsoft Windows, Mac OS X, RISC OS, и многих других. - (Совершенно точно, что существует версия PHP для OS/2. Неизвестно, - правда, насколько соответствующая нынешним реалиям - Прим.перев.) + Также в PHP включена поддержка большинства современных вебсерверов, таких, как Apache, Microsoft Internet Information Server, Personal Web Server, серверов Netscape и iPlanet, сервера Oreilly @@ -159,27 +153,22 @@ </para> <para> Таким образом, выбирая PHP, вы получаете свободу выбора - операционной системы и вебсервера. Кроме того, у вас + операционной системы и веб-сервера. Кроме того, у вас появляется выбор между использованием процедурного или объектно-ориентированного программирования или - же их сочетания. Несмотря на то, что PHP 4 (текущая стабильная версия) - поддерживает не все особенности ООП, многие - библиотеки кода и большие приложения (включая - библиотеку PEAR) написаны только с использованием ООП. - PHP 5 исправляет некоторые слабости, присущие реализации ООП в PHP 4 и - предоставляет разработчику целосную объектную модель. + же их сочетания. Многие библиотеки кода и большие приложения + (включая библиотеку PEAR) написаны только с использованием ООП. </para> <para> - PHP способен не только выдавать HTML. Возможности PHP - включают формирование изображений, файлов PDF и даже - роликов Flash (с использованием libswf и Ming), создаваемых - "на лету". PHP также способен выдавать любые текстовые - данные, такие, как XHTML и другие XML-файлы. PHP способен + PHP способен генерировать не только HTML. Доступно + формирование изображений, файлов PDF и даже роликов Flash + (с использованием libswf и Ming), создаваемых «на лету». + PHP также способен генерировать любые текстовые + данные, такие, как XHTML и другие XML-файлы. PHP может осуществлять автоматическую генерацию таких файлов и сохранять их в файловой системе вашего сервера вместо того, чтобы отдавать клиенту, организуя, таким образом, - кеш динамического содержания, расположенный на стороне - сервера. + кэш динамического наполнения, расположенный на стороне сервера. </para> <para> Одним из значительных преимуществ PHP является поддержка @@ -212,17 +201,17 @@ <member>Unix dbm</member> </simplelist> </blockquote> - Также в PHP включена поддержка DBX для работы на абстрактном - уровне, так что вы можете работать с любой базой данных, - использующих DBX. Кроме того, PHP поддерживает ODBC (Open Database Connection - standard), таким образом, вы можете работать с любой базой - данных, поддерживающей этот всемирно признанный стандарт. + В PHP имеется интерфейсная прослойка, называемая PDO, + позволяющая работать с любой базой данных одинаково. + Кроме того, PHP поддерживает ODBC (Open Database Connection standard), + таким образом, вы можете работать с любой базой данных, + поддерживающей этот всемирно признанный стандарт. </para> <para> - PHP также поддерживает "общение" с другими сервисами с - использованием таких протоколов, как LDAP, IMAP, SNMP, NNTP, POP3, HTTP, + PHP также поддерживает «общение» с другими сервисами с + через такие протоколы, как LDAP, IMAP, SNMP, NNTP, POP3, HTTP, COM (на платформах Windows) и многих других. Кроме того, вы - получаете возможность работать с сетевыми сокетами "напрямую". + получаете возможность работать с сетевыми сокетами напрямую. PHP поддерживает стандарт обмена сложными структурами данных WDDX. Обращая внимание на взаимодействие между различными языками, следует упомянуть о поддержке объектов Java и возможности @@ -232,7 +221,7 @@ <para> PHP включает средства обработки текстовой информации, начиная с регулярных выражений Perl или POSIX Extended и - заканчивая парсером документов XML. Для парсинга XML + заканчивая парсером документов XML. Для анализа XML в PHP 4 используются стандарты SAX и DOM. Для преобразования документов XML вы можете использовать расширение XSLT. В PHP 5 обработка XML-документов стандартизирована и происходит на базе @@ -240,23 +229,17 @@ работы с XML: SimpleXML и XMLReader. </para> <para> - Используя PHP в области электронной коммерции, - вы обратите внимание на функции осуществления - платежей Cybercash, CyberMUT, VeriSign Payflow - Pro и CCVS. - </para> - <para> Последним по порядку, но не по значению, является поддержка многих других расширений, таких, как функции поисковой машины mnoGoSearch, функции IRC Gateway, функции для работы со сжатыми - файлами (gzip, bz2), функции календарных вычислений, + файлами (gzip, bz2, zip), функции календарных вычислений, функции перевода... </para> <para> Как вы видите, этой страницы не хватит для того, - чтобы перечислить все, что может предложить вам - PHP. Читайте следующую главу, <link linkend="install">Установка + чтобы перечислить всё, что может предложить вам PHP. + Читайте следующую главу, <link linkend="install">Установка PHP</link> и обратитесь к главе <link linkend="funcref">Справочник по функциям</link> за более подробными сведениями о перечисленных выше расширениях. @@ -285,11 +268,3 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> - - - - - - - - http://cvs.php.net/viewvc.cgi/phpdoc-ru/language/control-structures/if.xml?view=markup&rev=1.1 Index: phpdoc-ru/language/control-structures/if.xml +++ phpdoc-ru/language/control-structures/if.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: shafff Status: ready --> <sect1 xml:id="control-structures.if" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title><literal>if</literal></title> <para> Конструкция <literal>if</literal> является одной из наиболее важных во многих языках программирования, в том числе и PHP. Она предоставляет возможность условного выполнения фрагментов кода. Структура <literal>if</literal> реализована в PHP по аналогии с языком C: <informalexample> <programlisting> <![CDATA[ if (выражение) инструкция ]]> </programlisting> </informalexample> </para> <simpara> Как описано в <link linkend="language.expressions">разделе про выражения</link>, <replaceable>выражение</replaceable> вычисляется в булево значение. Если <replaceable>выражение</replaceable> принимает значение &true;, PHP выполнит <replaceable>инструкцию</replaceable>, а если оно принимает значение &false; - проигнорирует. Информацию о том, какие значения считаются равнозначными значению &false;, можно найти в разделе <link linkend="language.types.boolean.casting">Преобразование в булев тип</link>. </simpara> <para> Следующий пример выведет <computeroutput>a больше чем b</computeroutput> если значение переменной <varname>$a</varname> больше чем <varname>$b</varname>: <informalexample> <programlisting role="php"> <![CDATA[ <?php if ($a > $b) echo "a больше чем b"; ?> ]]> </programlisting> </informalexample> </para> <para> Часто необходимо, чтобы условно выполнялось более одной инструкции. Для этого можно объединить несколько инструкций в блок. Например, следующий код выведет <computeroutput>a больше чем b</computeroutput>, если значение переменной <varname>$a</varname> больше чем <varname>$b</varname>, и затем присвоит значение переменной <varname>$a</varname> переменной <varname>$b</varname>: <informalexample> <programlisting role="php"> <![CDATA[ <?php if ($a > $b) { echo "a больше, чем b"; $b = $a; } ?> ]]> </programlisting> </informalexample> </para> <simpara> Инструкции <literal>if</literal> могут быть вложены в другие инструкции <literal>if</literal> неограниченное количество раз, что даёт большую гибкость в организации условного выполнения различных частей программы. </simpara> </sect1> <!-- 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 -->