com doc/ru: Обновлен ие до англи йской верси и: chapters/tutorial.xml faq/build.xml faq/dat abases.xml
faq/installation.xml faq/passwords.xml f aq/using.xml language-snippets.ent
| From: | Sergey Panteleev | Date: | Wed, 24 Mar 2021 08:54:47 +0000 |
| Subject: | com doc/ru: Обновлен ие до англи йской верси и: chapters/tutorial.xml faq/build.xml faq/dat abases.xml faq/installation.xml faq/passwords.xml f aq/using.xml language-snippets.ent |
||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-8834@lists.php.net to get a copy of this message | ||
Commit: 1ca2848c1ac5c9013290f017afd47f04b8a685f2
Author: Sergey Panteleev <sergey@php.net> Wed, 24 Mar 2021 11:54:47 +0300
Parents: f607e5ec078e21e73f11b4deb865f127c74dadc6
Branches: master
Link: http://git.php.net/?p=doc/ru.git;a=commitdiff;h=1ca2848c1ac5c9013290f017afd47f04b8a685f2
Log:
Обновление до английской версии
Changed paths:
M chapters/tutorial.xml
M faq/build.xml
M faq/databases.xml
M faq/installation.xml
M faq/passwords.xml
M faq/using.xml
M language-snippets.ent
diff --git a/chapters/tutorial.xml b/chapters/tutorial.xml index 1aa0430be..cd3d05835 100644 --- a/chapters/tutorial.xml +++ b/chapters/tutorial.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 3e08a8aae657492bdcdc7c550099ddf072042fa9 Maintainer: shein Status: ready --> +<!-- EN-Revision: b8e1b1357def73f310c9f7405035b3acc0cb1eaf Maintainer: shein Status: ready --> <!-- Reviewed: yes Maintainer: rjhdby --> <!-- $Revision$ --> <chapter xml:id="tutorial" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -226,12 +226,7 @@ <varname>$_SERVER</varname> - специальная зарезервированная переменная PHP, которая содержит всю информацию, полученную от Web-сервера. Её также называют суперглобальной. Для более подробной информации смотрите раздел <link - linkend="language.variables.superglobals">Суперглобальные переменные</link>. Эти - специальные переменные появились в PHP, начиная с версии <link - xlink:href="&url.php.release4.1.0;">4.1.0</link>. До этого использовались массивы - <varname>$HTTP_*_VARS</varname>, такие как - <varname>$HTTP_SERVER_VARS</varname>. С версии PHP 5.4.0 эти старые переменные - удалены (см. замечания по <link linkend="tutorial.oldcode">старым программам</link>). + linkend="language.variables.superglobals">Суперглобальные переменные</link>. </para> </note> <para> @@ -450,55 +445,6 @@ if (strpos($_SERVER['HTTP_USER_AGENT'], 'MSIE') !== FALSE) { </para> </section> - <section xml:id="tutorial.oldcode"> - <info><title>Использование старых программ с новыми версиями PHP</title></info> - <para> - Сейчас PHP является популярным языком сценариев(скриптов) и поэтому появляется все - больше и больше распространяемых кусочков кода, которые вы можете использовать в - своих скриптах. В большинстве случаев разработчики PHP старались сохранить - совместимость с предыдущими версиями так, чтобы код, написанный для более старой - версии, работал (в идеале) и с новыми версиями языка без каких-либо изменений. Однако - случается так, что изменения всё-таки необходимы. - </para> - <para> - Есть два важных изменения, которые влияют на старые программы: - <itemizedlist> - <listitem> - <simpara> - С PHP 5.4.0, старые массивы <varname>$HTTP_*_VARS</varname> удалены. - Следующие <link linkend="language.variables.superglobals">суперглобальные массивы</link> - были добавлены в PHP <link xlink:href="&url.php.release4.1.0;">4.1.0</link>: - <varname>$_GET</varname>, <varname>$_POST</varname>, - <varname>$_COOKIE</varname>, <varname>$_SERVER</varname>, - <varname>$_FILES</varname>, <varname>$_ENV</varname>, - <varname>$_REQUEST</varname>, и <varname>$_SESSION</varname>. - </simpara> - </listitem> - <listitem> - <simpara> - Внешние переменные больше не глобализуются по умолчанию. Другими - словами, начиная с версии PHP - <link xlink:href="&url.php.release4.2.0;">4.2.0</link>, - директива <literal>register_globals</literal> - в &php.ini; по умолчанию <emphasis>отключена</emphasis> ("off"). - Рекомендуемый метод доступа к таким переменным - суперглобальные - массивы, описанные выше. Более старые программы, книги и руководства - могут считать, что данная директива включена ("<literal>on</literal>"). - К примеру, если бы эта директива была включена ("<literal>on</literal>"), - такой скрипт мог бы использовать переменную <varname>$id</varname>, - поступившую из строки URL <literal>http://www.example.com/foo.php?id=42</literal>. - Вне зависимости от значения данной директивы, переменная <varname>$_GET['id']</varname> - будет всегда доступна. - </simpara> - </listitem> - </itemizedlist> - Для дополнительной информации касательно изменений, связанных с - переменными, смотрите раздел "<link - linkend="language.variables.predefined">Предопределённые переменные</link>" - и ссылки этого раздела. - </para> - </section> - <section xml:id="tutorial.whatsnext"> <info><title>Что дальше?</title></info> <para> @@ -513,7 +459,6 @@ if (strpos($_SERVER['HTTP_USER_AGENT'], 'MSIE') !== FALSE) { </para> </section> </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/faq/build.xml b/faq/build.xml index 6a8457a40..47998e8bf 100644 --- a/faq/build.xml +++ b/faq/build.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 8c97f23264c18cf6496ec6fbfdce4688da182465 Maintainer: shein Status: ready --> +<!-- EN-Revision: b8e1b1357def73f310c9f7405035b3acc0cb1eaf Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <chapter xml:id="faq.build" xmlns="http://docbook.org/ns/docbook" @@ -190,73 +190,6 @@ </answer> </qandaentry> - <qandaentry xml:id="faq.build.apache"> - <question> - <para> - Я не могу понять как собрать PHP c Apache 1.3. - </para> - </question> - <answer> - <para> - На самом деле это очень легко. Аккуратно выполните следующие шаги: - <itemizedlist> - <listitem> - <simpara> - Скачайте последний дистрибутив Apache 1.3 с - <link xlink:href="&url.apache.source;">&url.apache.source;</link>. - </simpara> - </listitem> - <listitem> - <simpara> - Разархивируйте (ungzip/untar) его где-нибудь, - например, в <filename>/usr/local/src/apache-1.3</filename>. - </simpara> - </listitem> - <listitem> - <simpara> - Скомпилируйте PHP, сперва запустив - <command>./configure --with-apache=/<path>/apache-1.3 - </command> - (замените <path> на ваш настоящий путь к директории apache-1.3.) - </simpara> - </listitem> - <listitem> - <simpara> - Введите <command>make</command> с последующим <command>make install</command> - для сборки PHP и копирования всех необходимых файлов в дерево - дистрибутива Apache. - </simpara> - </listitem> - <listitem> - <simpara> - Перейдите в вашу директорию - <filename>/<path>/apache-1.3/src</filename> - и отредактируйте файл <filename>Configuration</filename>. - Добавьте в файл: <literal>AddModule modules/php4/libphp4.a</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - Введите: <command>./configure</command> и затем <literal>make</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - Теперь у вас должен быть бинарник httpd, поддерживающий PHP! - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - <emphasis>Замечание:</emphasis> - Вы также можете использовать новый скрипт <literal>./configure</literal> - в Apache. Смотрите инструкции в файле <literal>README.configure</literal>, - входящем в ваш дистрибутив Apache. - Также загляните в файл <filename>INSTALL</filename> из дистрибутива PHP. - </para> - </answer> - </qandaentry> - <qandaentry xml:id="faq.build.not-running"> <question> <para> @@ -542,7 +475,6 @@ $ gcc -E test.c >/dev/null </qandaentry> </qandaset> </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/faq/databases.xml b/faq/databases.xml index cca70bce3..d19a6529f 100644 --- a/faq/databases.xml +++ b/faq/databases.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: ae6be5bb4f40f334c713bdf0dc11ac6a59f6461d Maintainer: shein Status: ready --> +<!-- EN-Revision: b8e1b1357def73f310c9f7405035b3acc0cb1eaf Maintainer: shein Status: ready --> <!-- Reviewed: yes Maintainer: rjhdby --> <!-- $Revision$ --> <chapter xml:id="faq.databases" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -39,11 +39,6 @@ </question> <answer> <para> - Да. Если всё полностью выполняется под Windows 9x/Me или NT/2000, - то у вас уже есть все необходимые средства, так как для баз данных - Microsoft Access вы можете использовать ODBC и драйверы ODBC от Microsoft. - </para> - <para> Если вы хотите связать PHP, выполняющийся на Unix, и MS Access на Windows, то вам будут нужны драйверы ODBC для Unix. Такие ODBC драйверы для Unix есть у <link xlink:href="&url.openlink;">OpenLink @@ -154,83 +149,8 @@ </para> </answer> </qandaentry> - - <qandaentry xml:id="faq.databases.mysql.deprecated"> - <question> - <para> - Почему MySQL расширение (ext/mysql), которое я использовал - более 10 лет, теперь не рекомендуется использовать? Что - я должен использовать вместо него? Как мне обновить свои - программы? - </para> - </question> - <answer> - <para> - Есть три расширения для работы с MySQL, как описано в разделе - <link linkend="mysqlinfo.api.choosing">Выбор MySQL API</link> - Старое API не должно использоваться, оно является устаревшим с версии PHP 5.5.0 - и перемещено в PECL с версии PHP 7.0.0. - Настоятельно рекомендуется писать весь новый код с - использованием либо <link linkend="book.mysqli">mysqli</link>, - либо <link linkend="ref.pdo-mysql">PDO_MySQL</link>. - </para> - <para> - Скрипты для перехода со старого API пока недоступны, но - mysqli API содержит как процедурный так и объектный API, - схожие со старым процедурным ext/mysql API. - </para> - <para> - Нельзя совмещать различные расширения. Поэтому, например - передача mysqli соединения в PDO_MySQL или ext/mysql не - будет работать. - </para> - </answer> - </qandaentry> - - <qandaentry xml:id="faq.databases.mysqlresource"> - <question> - <para> - Почему я получаю ошибки типа - "Warning: 0 is not a MySQL result index in <file> - on line <x>" или "Warning: Supplied argument is not - a valid MySQL result resource in <file> on line <x>? - </para> - </question> - <answer> - <para> - Вы пытаетесь использовать идентификатор результата, который равен 0. - 0 означает, что ваш запрос не удался по какой-либо причине. Вам необходимо - сделать проверку на ошибки, после того как вы послали ваш запрос, и перед - тем, как вы пытаетесь использовать возвращённый идентификатор результата. - Правильный способ этой реализации выглядит примерно так: - <programlisting role="php"> -<![CDATA[ -<?php - -$result = mysql_query("SELECT * FROM tables_priv"); -if (!$result) { - echo mysql_error(); - exit; -} -?> -]]> - </programlisting> - или - <programlisting role="php"> -<![CDATA[ -<?php - -$result = mysql_query("SELECT * FROM tables_priv") - or die("Плохой запрос: " . mysql_error()); -?> -]]> - </programlisting> - </para> - </answer> - </qandaentry> </qandaset> </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/faq/installation.xml b/faq/installation.xml index 16a41231b..4d3cc0422 100644 --- a/faq/installation.xml +++ b/faq/installation.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: b65db9e1c6ad75d65a1ed364178d3451d36d2b18 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: b8e1b1357def73f310c9f7405035b3acc0cb1eaf Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: rjhdby --> <!-- $Revision$ --> <chapter xml:id="faq.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -397,7 +397,7 @@ cgi error: </question> <answer> <para> - В Windows 7, XP, Vista, 2008, 2012 и выше: + В Windows: <itemizedlist> <listitem><para> Старт → Панель Управления → Система @@ -426,37 +426,12 @@ cgi error: </para></listitem> </itemizedlist> </para> - <para> - В Windows 98/Me вам нужно отредактировать файл <filename>autoexec.bat</filename>: - <itemizedlist> - <listitem><para> - Откройте блокнот - </para></listitem> - <listitem><para> - Откройте в блокноте файл <filename>C:\autoexec.bat</filename> - </para></listitem> - <listitem><para> - Найдите строку PATH=C:\WINDOWS;C:\WINDOWS\COMMAND;..... - и добавьте в конце <literal>;C:\php</literal> - </para></listitem> - <listitem><para> - Сохраните изменения и перезагрузите компьютер. - </para></listitem> - </itemizedlist> - </para> <note> <simpara> Не забудьте перезагрузиться после описанных выше действий и, после перезагрузки, проверить, что переменная <envar>PATH</envar> содержит нужный путь. </simpara> </note> - <para> - В некоторых устаревших руководствах PHP предлагается поместить исполняемые файлы в - системный каталог Windows потому, что (<filename>C:\Windows</filename>, - <filename>C:\WINNT</filename>, и т.д..) по умолчанию заданы в переменной - окружения <envar>PATH</envar>. Но на данный момент это не рекомендуется, поскольку - может вызвать разнообразные проблемы. - </para> </answer> </qandaentry> @@ -498,27 +473,6 @@ cgi error: </para></listitem> </itemizedlist> </para> - <para> - В Windows 98/Me вам нужно отредактировать файл <filename>autoexec.bat</filename>: - <itemizedlist> - <listitem><para> - Откройте блокнот - </para></listitem> - <listitem><para> - Откройте в блокноте файл <filename>C:\autoexec.bat</filename> - </para></listitem> - <listitem><para> - Добавьте новую строку в конце файла: <literal>set - PHPRC=C:\php</literal> (замените <literal>C:\php</literal> на директорию, где - лежит &php.ini;). Обратите внимание, что путь не должен содержать пробелов. - К примеру, если файл лежит в <filename>C:\Program Files\PHP</filename>, вы - должны указать короткое имя <filename>C:\PROGRA~1\PHP</filename>. - </para></listitem> - <listitem><para> - Сохраните файл и перезагрузите компьютер - </para></listitem> - </itemizedlist> - </para> </answer> </qandaentry> @@ -573,7 +527,6 @@ Deny from all </qandaset> </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/faq/passwords.xml b/faq/passwords.xml index 3fef39986..d6066a490 100644 --- a/faq/passwords.xml +++ b/faq/passwords.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: f46266c6d6a4e0fa713fbd0cf19c02e9650b5096 Maintainer: shein Status: ready --> +<!-- EN-Revision: b8e1b1357def73f310c9f7405035b3acc0cb1eaf Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <chapter xml:id="faq.passwords" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -76,15 +76,14 @@ тем больше времени требуется для взлома его вывода методом "грубой силы". </para> <para> - PHP 5.5 предоставляет <link linkend="book.password">встроенное API хеширования паролей</link>, + PHP предоставляет <link linkend="book.password">встроенное API хеширования паролей</link>, которое безопасно работает и с <link linkend="function.password-hash">хешированием</link> - и с <link linkend="function.password-verify">проверкой паролей</link>. Также есть - <link xlink:href="&url.password.compat;">библиотека PHP для совместимости</link>, - доступная с PHP 5.3.7. + и с <link linkend="function.password-verify">проверкой паролей</link>. </para> + <!-- TODO Drop mention of crypt? --> <para> Другой возможностью является функция <function>crypt</function>, которая - поддерживает несколько алгоритмов хеширования в PHP 5.3 и новее. При использовании + поддерживает несколько алгоритмов хеширования. При использовании этой функции вы можете быть уверенным, что выбранный вами алгоритм доступен, так как PHP содержит собственную реализацию каждого поддерживаемого алгоритма, даже в случае, если какие-то из них @@ -172,7 +171,6 @@ </qandaset> </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/faq/using.xml b/faq/using.xml index 3cd54326f..cd7cea846 100644 --- a/faq/using.xml +++ b/faq/using.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 3e08a8aae657492bdcdc7c550099ddf072042fa9 Maintainer: shein Status: ready --> +<!-- EN-Revision: b8e1b1357def73f310c9f7405035b3acc0cb1eaf Maintainer: shein Status: ready --> <!-- Reviewed: yes Maintainer: rjhdby --> <!-- $Revision$ --> <chapter xml:id="faq.using" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -14,6 +14,7 @@ <qandaset> <qandaentry xml:id="faq.using.parameterorder"> + <!-- TODO: Mention named arguments --> <question> <para> Я не могу запомнить порядок аргументов PHP-функций, они что, случайны? @@ -304,9 +305,6 @@ foreach ($headers as $name => $content) { </link> так как он описывает общие сценарии для внешних переменных, таких как HTML форма, Cookie и URL. </para> - - ¬e.registerglobals; - </answer> </qandaentry> @@ -327,25 +325,6 @@ foreach ($headers as $name => $content) { </answer> </qandaentry> - <qandaentry xml:id="faq.using.cgi-vars"> - <question> - <para> - Я пытаюсь получить доступ к одной из стандартных CGI переменных - (таких как <varname>$DOCUMENT_ROOT</varname> или - <varname>$HTTP_REFERER</varname>) в определённой - пользователем функции и, похоже, она не может быть найдена. - В чем дело? - </para> - </question> - <answer> - <para> - Вместо этого используйте <varname>$_SERVER['DOCUMENT_ROOT']</varname> и - <varname>$_SERVER['HTTP_REFERER']</varname>. - </para> - - </answer> - </qandaentry> - <qandaentry xml:id="faq.using.shorthandbytes"> <question> <para> @@ -374,28 +353,8 @@ foreach ($headers as $name => $content) { </note> </answer> </qandaentry> - - <qandaentry xml:id="faq.using.windowslocalhostissue"> - <question> - <para> - Windows: Я постоянно получаю таймауты при соединении с <literal>localhost</literal>, - хотя с <literal>"127.0.0.1"</literal> все работает нормально? - </para> - </question> - <answer> - <para> - До версии PHP 5.3.4, существовала ошибка в коде резолвинга доменного имени, - не дававшая определить адрес <literal>localhost</literal> при включённом IPv6, - во всех ситуациях связанных с потоками. - Для обхода этой проблемы можно использовать <literal>"127.0.0.1"</literal> - или отключить резолвинг IPv6 в файле <filename>hosts</filename>. - </para> - </answer> - </qandaentry> - </qandaset> </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/language-snippets.ent b/language-snippets.ent index a9d090b0e..081dfcebb 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 161f44453835072c325d7a1615c71b454c45cd3e Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: b8e1b1357def73f310c9f7405035b3acc0cb1eaf Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> @@ -61,8 +61,6 @@ <!ENTITY note.randomseed '<note xmlns="http://docbook.org/ns/docbook"><simpara>Нет необходимости инициализировать генератор случайных чисел функциями <function>srand</function> или <function>mt_srand</function>, поскольку это происходит автоматически.</simpara></note>'> -<!ENTITY note.registerglobals '<note xmlns="http://docbook.org/ns/docbook"><title>register_globals: важное замечание</title><para>Начиная с PHP 4.2.0, значением директивы PHP <literal>register_globals</literal> по умолчанию является <emphasis>off</emphasis> (выключено). Сообщество PHP рекомендует не полагаться на эту директиву, а использовать вместо этого иные средства, такие как &link.superglobals;.</para></note>'> - <!ENTITY note.is-superglobal "<note xmlns='http://docbook.org/ns/docbook'><para>Это 'суперглобальная' или автоматическая глобальная переменная. Это просто означает, что она доступна во всех контекстах скрипта. Нет необходимости выполнять <command>global $variable;</command> для доступа к ней внутри метода или функции.</para></note>"> <!ENTITY note.uses-ob '<note xmlns="http://docbook.org/ns/docbook"><para>При использовании параметра <parameter>return</parameter> данная функция использует внутреннюю буферизацию вывода, поэтому она не может быть использована внутри callback-функции <function>ob_start</function>.</para></note>'> @@ -441,8 +439,6 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция была </varlistentry> '> -<!ENTITY avail.register-long-arrays 'Начиная с PHP 5.0.0, длинные <link xmlns="http://docbook.org/ns/docbook" linkend="language.variables.predefined">предопределённые переменные</link> массивов PHP могут быть отключены директивой <literal>register_long_arrays</literal>.'> - <!ENTITY ini.shorthandbytes '<simpara xmlns="http://docbook.org/ns/docbook">Если используется <type>int</type>, значение измеряется байтами. Вы также можете использовать сокращённую запись, которая описана в <link linkend="faq.using.shorthandbytes">этом разделе FAQ</link>.</simpara>'> <!ENTITY info.deprecated.alias 'Для обратной совместимости может быть использован следующий устаревший псевдоним: '> @@ -1484,32 +1480,27 @@ field_offset</parameter></term><listitem><para>Числовое смещение <!ENTITY mysql.alternative.note '<para xmlns="http://docbook.org/ns/docbook">Данное расширение устарело, начиная с версии PHP 5.5.0, и удалено в PHP 7.0.0. Используйте вместо него <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>. -Смотрите также инструкцию <link linkend="mysqlinfo.api.choosing">MySQL: -выбор API</link> и <link linkend="faq.databases.mysql.deprecated">соответствующий FAQ</link> для получения более подробной информации. +Смотрите также инструкцию <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>. Альтернативы для данной функции:</para>'> <!ENTITY mysql.alternative.note.4-3-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 4.3.0, и, вместе с <link linkend="book.mysql">расширением MySQL</link>, удалена PHP 7.0.0. Вместо неё используйте активно развивающиеся расширения <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>. -Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link> и -<link linkend="faq.databases.mysql.deprecated">это FAQ</link>. +Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>. Альтернативы для этой функции:</para>'> <!ENTITY mysql.alternative.note.5-3-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 5.3.0, и, вместе с <link linkend="book.mysql">расширением MySQL</link>, удалена PHP 7.0.0. Вместо неё используйте активно развивающиеся расширения <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>. -Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link> и -<link linkend="faq.databases.mysql.deprecated">это FAQ</link>. +Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>. Альтернативы для этой функции:</para>'> <!ENTITY mysql.alternative.note.5-4-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 5.4.0, и, вместе с <link linkend="book.mysql">расширением MySQL</link>, удалена PHP 7.0.0. Вместо неё используйте активно развивающиеся расширения <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>. -Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link> и -<link linkend="faq.databases.mysql.deprecated">это FAQ</link>. +Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>. Альтернативы для этой функции:</para>'> <!ENTITY mysql.alternative.note.5-5-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 5.5.0, и, вместе с <link linkend="book.mysql">расширением MySQL</link>, удалена PHP 7.0.0. Вместо неё используйте активно развивающиеся расширения <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>. -Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link> и -<link linkend="faq.databases.mysql.deprecated">это FAQ</link>. +Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>. Альтернативы для этой функции:</para>'> <!ENTITY mysql.close.connections.result.sets '<para xmlns="http://docbook.org/ns/docbook">
diff --git a/chapters/tutorial.xml b/chapters/tutorial.xml index 1aa0430be..cd3d05835 100644 --- a/chapters/tutorial.xml +++ b/chapters/tutorial.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 3e08a8aae657492bdcdc7c550099ddf072042fa9 Maintainer: shein Status: ready --> +<!-- EN-Revision: b8e1b1357def73f310c9f7405035b3acc0cb1eaf Maintainer: shein Status: ready --> <!-- Reviewed: yes Maintainer: rjhdby --> <!-- $Revision$ --> <chapter xml:id="tutorial" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -226,12 +226,7 @@ <varname>$_SERVER</varname> - специальная зарезервированная переменная PHP, которая содержит всю информацию, полученную от Web-сервера. Её также называют суперглобальной. Для более подробной информации смотрите раздел <link - linkend="language.variables.superglobals">Суперглобальные переменные</link>. Эти - специальные переменные появились в PHP, начиная с версии <link - xlink:href="&url.php.release4.1.0;">4.1.0</link>. До этого использовались массивы - <varname>$HTTP_*_VARS</varname>, такие как - <varname>$HTTP_SERVER_VARS</varname>. С версии PHP 5.4.0 эти старые переменные - удалены (см. замечания по <link linkend="tutorial.oldcode">старым программам</link>). + linkend="language.variables.superglobals">Суперглобальные переменные</link>. </para> </note> <para> @@ -450,55 +445,6 @@ if (strpos($_SERVER['HTTP_USER_AGENT'], 'MSIE') !== FALSE) { </para> </section> - <section xml:id="tutorial.oldcode"> - <info><title>Использование старых программ с новыми версиями PHP</title></info> - <para> - Сейчас PHP является популярным языком сценариев(скриптов) и поэтому появляется все - больше и больше распространяемых кусочков кода, которые вы можете использовать в - своих скриптах. В большинстве случаев разработчики PHP старались сохранить - совместимость с предыдущими версиями так, чтобы код, написанный для более старой - версии, работал (в идеале) и с новыми версиями языка без каких-либо изменений. Однако - случается так, что изменения всё-таки необходимы. - </para> - <para> - Есть два важных изменения, которые влияют на старые программы: - <itemizedlist> - <listitem> - <simpara> - С PHP 5.4.0, старые массивы <varname>$HTTP_*_VARS</varname> удалены. - Следующие <link linkend="language.variables.superglobals">суперглобальные массивы</link> - были добавлены в PHP <link xlink:href="&url.php.release4.1.0;">4.1.0</link>: - <varname>$_GET</varname>, <varname>$_POST</varname>, - <varname>$_COOKIE</varname>, <varname>$_SERVER</varname>, - <varname>$_FILES</varname>, <varname>$_ENV</varname>, - <varname>$_REQUEST</varname>, и <varname>$_SESSION</varname>. - </simpara> - </listitem> - <listitem> - <simpara> - Внешние переменные больше не глобализуются по умолчанию. Другими - словами, начиная с версии PHP - <link xlink:href="&url.php.release4.2.0;">4.2.0</link>, - директива <literal>register_globals</literal> - в &php.ini; по умолчанию <emphasis>отключена</emphasis> ("off"). - Рекомендуемый метод доступа к таким переменным - суперглобальные - массивы, описанные выше. Более старые программы, книги и руководства - могут считать, что данная директива включена ("<literal>on</literal>"). - К примеру, если бы эта директива была включена ("<literal>on</literal>"), - такой скрипт мог бы использовать переменную <varname>$id</varname>, - поступившую из строки URL <literal>http://www.example.com/foo.php?id=42</literal>. - Вне зависимости от значения данной директивы, переменная <varname>$_GET['id']</varname> - будет всегда доступна. - </simpara> - </listitem> - </itemizedlist> - Для дополнительной информации касательно изменений, связанных с - переменными, смотрите раздел "<link - linkend="language.variables.predefined">Предопределённые переменные</link>" - и ссылки этого раздела. - </para> - </section> - <section xml:id="tutorial.whatsnext"> <info><title>Что дальше?</title></info> <para> @@ -513,7 +459,6 @@ if (strpos($_SERVER['HTTP_USER_AGENT'], 'MSIE') !== FALSE) { </para> </section> </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/faq/build.xml b/faq/build.xml index 6a8457a40..47998e8bf 100644 --- a/faq/build.xml +++ b/faq/build.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 8c97f23264c18cf6496ec6fbfdce4688da182465 Maintainer: shein Status: ready --> +<!-- EN-Revision: b8e1b1357def73f310c9f7405035b3acc0cb1eaf Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <chapter xml:id="faq.build" xmlns="http://docbook.org/ns/docbook" @@ -190,73 +190,6 @@ </answer> </qandaentry> - <qandaentry xml:id="faq.build.apache"> - <question> - <para> - Я не могу понять как собрать PHP c Apache 1.3. - </para> - </question> - <answer> - <para> - На самом деле это очень легко. Аккуратно выполните следующие шаги: - <itemizedlist> - <listitem> - <simpara> - Скачайте последний дистрибутив Apache 1.3 с - <link xlink:href="&url.apache.source;">&url.apache.source;</link>. - </simpara> - </listitem> - <listitem> - <simpara> - Разархивируйте (ungzip/untar) его где-нибудь, - например, в <filename>/usr/local/src/apache-1.3</filename>. - </simpara> - </listitem> - <listitem> - <simpara> - Скомпилируйте PHP, сперва запустив - <command>./configure --with-apache=/<path>/apache-1.3 - </command> - (замените <path> на ваш настоящий путь к директории apache-1.3.) - </simpara> - </listitem> - <listitem> - <simpara> - Введите <command>make</command> с последующим <command>make install</command> - для сборки PHP и копирования всех необходимых файлов в дерево - дистрибутива Apache. - </simpara> - </listitem> - <listitem> - <simpara> - Перейдите в вашу директорию - <filename>/<path>/apache-1.3/src</filename> - и отредактируйте файл <filename>Configuration</filename>. - Добавьте в файл: <literal>AddModule modules/php4/libphp4.a</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - Введите: <command>./configure</command> и затем <literal>make</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - Теперь у вас должен быть бинарник httpd, поддерживающий PHP! - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - <emphasis>Замечание:</emphasis> - Вы также можете использовать новый скрипт <literal>./configure</literal> - в Apache. Смотрите инструкции в файле <literal>README.configure</literal>, - входящем в ваш дистрибутив Apache. - Также загляните в файл <filename>INSTALL</filename> из дистрибутива PHP. - </para> - </answer> - </qandaentry> - <qandaentry xml:id="faq.build.not-running"> <question> <para> @@ -542,7 +475,6 @@ $ gcc -E test.c >/dev/null </qandaentry> </qandaset> </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/faq/databases.xml b/faq/databases.xml index cca70bce3..d19a6529f 100644 --- a/faq/databases.xml +++ b/faq/databases.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: ae6be5bb4f40f334c713bdf0dc11ac6a59f6461d Maintainer: shein Status: ready --> +<!-- EN-Revision: b8e1b1357def73f310c9f7405035b3acc0cb1eaf Maintainer: shein Status: ready --> <!-- Reviewed: yes Maintainer: rjhdby --> <!-- $Revision$ --> <chapter xml:id="faq.databases" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -39,11 +39,6 @@ </question> <answer> <para> - Да. Если всё полностью выполняется под Windows 9x/Me или NT/2000, - то у вас уже есть все необходимые средства, так как для баз данных - Microsoft Access вы можете использовать ODBC и драйверы ODBC от Microsoft. - </para> - <para> Если вы хотите связать PHP, выполняющийся на Unix, и MS Access на Windows, то вам будут нужны драйверы ODBC для Unix. Такие ODBC драйверы для Unix есть у <link xlink:href="&url.openlink;">OpenLink @@ -154,83 +149,8 @@ </para> </answer> </qandaentry> - - <qandaentry xml:id="faq.databases.mysql.deprecated"> - <question> - <para> - Почему MySQL расширение (ext/mysql), которое я использовал - более 10 лет, теперь не рекомендуется использовать? Что - я должен использовать вместо него? Как мне обновить свои - программы? - </para> - </question> - <answer> - <para> - Есть три расширения для работы с MySQL, как описано в разделе - <link linkend="mysqlinfo.api.choosing">Выбор MySQL API</link> - Старое API не должно использоваться, оно является устаревшим с версии PHP 5.5.0 - и перемещено в PECL с версии PHP 7.0.0. - Настоятельно рекомендуется писать весь новый код с - использованием либо <link linkend="book.mysqli">mysqli</link>, - либо <link linkend="ref.pdo-mysql">PDO_MySQL</link>. - </para> - <para> - Скрипты для перехода со старого API пока недоступны, но - mysqli API содержит как процедурный так и объектный API, - схожие со старым процедурным ext/mysql API. - </para> - <para> - Нельзя совмещать различные расширения. Поэтому, например - передача mysqli соединения в PDO_MySQL или ext/mysql не - будет работать. - </para> - </answer> - </qandaentry> - - <qandaentry xml:id="faq.databases.mysqlresource"> - <question> - <para> - Почему я получаю ошибки типа - "Warning: 0 is not a MySQL result index in <file> - on line <x>" или "Warning: Supplied argument is not - a valid MySQL result resource in <file> on line <x>? - </para> - </question> - <answer> - <para> - Вы пытаетесь использовать идентификатор результата, который равен 0. - 0 означает, что ваш запрос не удался по какой-либо причине. Вам необходимо - сделать проверку на ошибки, после того как вы послали ваш запрос, и перед - тем, как вы пытаетесь использовать возвращённый идентификатор результата. - Правильный способ этой реализации выглядит примерно так: - <programlisting role="php"> -<![CDATA[ -<?php - -$result = mysql_query("SELECT * FROM tables_priv"); -if (!$result) { - echo mysql_error(); - exit; -} -?> -]]> - </programlisting> - или - <programlisting role="php"> -<![CDATA[ -<?php - -$result = mysql_query("SELECT * FROM tables_priv") - or die("Плохой запрос: " . mysql_error()); -?> -]]> - </programlisting> - </para> - </answer> - </qandaentry> </qandaset> </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/faq/installation.xml b/faq/installation.xml index 16a41231b..4d3cc0422 100644 --- a/faq/installation.xml +++ b/faq/installation.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: b65db9e1c6ad75d65a1ed364178d3451d36d2b18 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: b8e1b1357def73f310c9f7405035b3acc0cb1eaf Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: rjhdby --> <!-- $Revision$ --> <chapter xml:id="faq.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -397,7 +397,7 @@ cgi error: </question> <answer> <para> - В Windows 7, XP, Vista, 2008, 2012 и выше: + В Windows: <itemizedlist> <listitem><para> Старт → Панель Управления → Система @@ -426,37 +426,12 @@ cgi error: </para></listitem> </itemizedlist> </para> - <para> - В Windows 98/Me вам нужно отредактировать файл <filename>autoexec.bat</filename>: - <itemizedlist> - <listitem><para> - Откройте блокнот - </para></listitem> - <listitem><para> - Откройте в блокноте файл <filename>C:\autoexec.bat</filename> - </para></listitem> - <listitem><para> - Найдите строку PATH=C:\WINDOWS;C:\WINDOWS\COMMAND;..... - и добавьте в конце <literal>;C:\php</literal> - </para></listitem> - <listitem><para> - Сохраните изменения и перезагрузите компьютер. - </para></listitem> - </itemizedlist> - </para> <note> <simpara> Не забудьте перезагрузиться после описанных выше действий и, после перезагрузки, проверить, что переменная <envar>PATH</envar> содержит нужный путь. </simpara> </note> - <para> - В некоторых устаревших руководствах PHP предлагается поместить исполняемые файлы в - системный каталог Windows потому, что (<filename>C:\Windows</filename>, - <filename>C:\WINNT</filename>, и т.д..) по умолчанию заданы в переменной - окружения <envar>PATH</envar>. Но на данный момент это не рекомендуется, поскольку - может вызвать разнообразные проблемы. - </para> </answer> </qandaentry> @@ -498,27 +473,6 @@ cgi error: </para></listitem> </itemizedlist> </para> - <para> - В Windows 98/Me вам нужно отредактировать файл <filename>autoexec.bat</filename>: - <itemizedlist> - <listitem><para> - Откройте блокнот - </para></listitem> - <listitem><para> - Откройте в блокноте файл <filename>C:\autoexec.bat</filename> - </para></listitem> - <listitem><para> - Добавьте новую строку в конце файла: <literal>set - PHPRC=C:\php</literal> (замените <literal>C:\php</literal> на директорию, где - лежит &php.ini;). Обратите внимание, что путь не должен содержать пробелов. - К примеру, если файл лежит в <filename>C:\Program Files\PHP</filename>, вы - должны указать короткое имя <filename>C:\PROGRA~1\PHP</filename>. - </para></listitem> - <listitem><para> - Сохраните файл и перезагрузите компьютер - </para></listitem> - </itemizedlist> - </para> </answer> </qandaentry> @@ -573,7 +527,6 @@ Deny from all </qandaset> </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/faq/passwords.xml b/faq/passwords.xml index 3fef39986..d6066a490 100644 --- a/faq/passwords.xml +++ b/faq/passwords.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: f46266c6d6a4e0fa713fbd0cf19c02e9650b5096 Maintainer: shein Status: ready --> +<!-- EN-Revision: b8e1b1357def73f310c9f7405035b3acc0cb1eaf Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <chapter xml:id="faq.passwords" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -76,15 +76,14 @@ тем больше времени требуется для взлома его вывода методом "грубой силы". </para> <para> - PHP 5.5 предоставляет <link linkend="book.password">встроенное API хеширования паролей</link>, + PHP предоставляет <link linkend="book.password">встроенное API хеширования паролей</link>, которое безопасно работает и с <link linkend="function.password-hash">хешированием</link> - и с <link linkend="function.password-verify">проверкой паролей</link>. Также есть - <link xlink:href="&url.password.compat;">библиотека PHP для совместимости</link>, - доступная с PHP 5.3.7. + и с <link linkend="function.password-verify">проверкой паролей</link>. </para> + <!-- TODO Drop mention of crypt? --> <para> Другой возможностью является функция <function>crypt</function>, которая - поддерживает несколько алгоритмов хеширования в PHP 5.3 и новее. При использовании + поддерживает несколько алгоритмов хеширования. При использовании этой функции вы можете быть уверенным, что выбранный вами алгоритм доступен, так как PHP содержит собственную реализацию каждого поддерживаемого алгоритма, даже в случае, если какие-то из них @@ -172,7 +171,6 @@ </qandaset> </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/faq/using.xml b/faq/using.xml index 3cd54326f..cd7cea846 100644 --- a/faq/using.xml +++ b/faq/using.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 3e08a8aae657492bdcdc7c550099ddf072042fa9 Maintainer: shein Status: ready --> +<!-- EN-Revision: b8e1b1357def73f310c9f7405035b3acc0cb1eaf Maintainer: shein Status: ready --> <!-- Reviewed: yes Maintainer: rjhdby --> <!-- $Revision$ --> <chapter xml:id="faq.using" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -14,6 +14,7 @@ <qandaset> <qandaentry xml:id="faq.using.parameterorder"> + <!-- TODO: Mention named arguments --> <question> <para> Я не могу запомнить порядок аргументов PHP-функций, они что, случайны? @@ -304,9 +305,6 @@ foreach ($headers as $name => $content) { </link> так как он описывает общие сценарии для внешних переменных, таких как HTML форма, Cookie и URL. </para> - - ¬e.registerglobals; - </answer> </qandaentry> @@ -327,25 +325,6 @@ foreach ($headers as $name => $content) { </answer> </qandaentry> - <qandaentry xml:id="faq.using.cgi-vars"> - <question> - <para> - Я пытаюсь получить доступ к одной из стандартных CGI переменных - (таких как <varname>$DOCUMENT_ROOT</varname> или - <varname>$HTTP_REFERER</varname>) в определённой - пользователем функции и, похоже, она не может быть найдена. - В чем дело? - </para> - </question> - <answer> - <para> - Вместо этого используйте <varname>$_SERVER['DOCUMENT_ROOT']</varname> и - <varname>$_SERVER['HTTP_REFERER']</varname>. - </para> - - </answer> - </qandaentry> - <qandaentry xml:id="faq.using.shorthandbytes"> <question> <para> @@ -374,28 +353,8 @@ foreach ($headers as $name => $content) { </note> </answer> </qandaentry> - - <qandaentry xml:id="faq.using.windowslocalhostissue"> - <question> - <para> - Windows: Я постоянно получаю таймауты при соединении с <literal>localhost</literal>, - хотя с <literal>"127.0.0.1"</literal> все работает нормально? - </para> - </question> - <answer> - <para> - До версии PHP 5.3.4, существовала ошибка в коде резолвинга доменного имени, - не дававшая определить адрес <literal>localhost</literal> при включённом IPv6, - во всех ситуациях связанных с потоками. - Для обхода этой проблемы можно использовать <literal>"127.0.0.1"</literal> - или отключить резолвинг IPv6 в файле <filename>hosts</filename>. - </para> - </answer> - </qandaentry> - </qandaset> </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/language-snippets.ent b/language-snippets.ent index a9d090b0e..081dfcebb 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 161f44453835072c325d7a1615c71b454c45cd3e Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: b8e1b1357def73f310c9f7405035b3acc0cb1eaf Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> @@ -61,8 +61,6 @@ <!ENTITY note.randomseed '<note xmlns="http://docbook.org/ns/docbook"><simpara>Нет необходимости инициализировать генератор случайных чисел функциями <function>srand</function> или <function>mt_srand</function>, поскольку это происходит автоматически.</simpara></note>'> -<!ENTITY note.registerglobals '<note xmlns="http://docbook.org/ns/docbook"><title>register_globals: важное замечание</title><para>Начиная с PHP 4.2.0, значением директивы PHP <literal>register_globals</literal> по умолчанию является <emphasis>off</emphasis> (выключено). Сообщество PHP рекомендует не полагаться на эту директиву, а использовать вместо этого иные средства, такие как &link.superglobals;.</para></note>'> - <!ENTITY note.is-superglobal "<note xmlns='http://docbook.org/ns/docbook'><para>Это 'суперглобальная' или автоматическая глобальная переменная. Это просто означает, что она доступна во всех контекстах скрипта. Нет необходимости выполнять <command>global $variable;</command> для доступа к ней внутри метода или функции.</para></note>"> <!ENTITY note.uses-ob '<note xmlns="http://docbook.org/ns/docbook"><para>При использовании параметра <parameter>return</parameter> данная функция использует внутреннюю буферизацию вывода, поэтому она не может быть использована внутри callback-функции <function>ob_start</function>.</para></note>'> @@ -441,8 +439,6 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция была </varlistentry> '> -<!ENTITY avail.register-long-arrays 'Начиная с PHP 5.0.0, длинные <link xmlns="http://docbook.org/ns/docbook" linkend="language.variables.predefined">предопределённые переменные</link> массивов PHP могут быть отключены директивой <literal>register_long_arrays</literal>.'> - <!ENTITY ini.shorthandbytes '<simpara xmlns="http://docbook.org/ns/docbook">Если используется <type>int</type>, значение измеряется байтами. Вы также можете использовать сокращённую запись, которая описана в <link linkend="faq.using.shorthandbytes">этом разделе FAQ</link>.</simpara>'> <!ENTITY info.deprecated.alias 'Для обратной совместимости может быть использован следующий устаревший псевдоним: '> @@ -1484,32 +1480,27 @@ field_offset</parameter></term><listitem><para>Числовое смещение <!ENTITY mysql.alternative.note '<para xmlns="http://docbook.org/ns/docbook">Данное расширение устарело, начиная с версии PHP 5.5.0, и удалено в PHP 7.0.0. Используйте вместо него <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>. -Смотрите также инструкцию <link linkend="mysqlinfo.api.choosing">MySQL: -выбор API</link> и <link linkend="faq.databases.mysql.deprecated">соответствующий FAQ</link> для получения более подробной информации. +Смотрите также инструкцию <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>. Альтернативы для данной функции:</para>'> <!ENTITY mysql.alternative.note.4-3-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 4.3.0, и, вместе с <link linkend="book.mysql">расширением MySQL</link>, удалена PHP 7.0.0. Вместо неё используйте активно развивающиеся расширения <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>. -Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link> и -<link linkend="faq.databases.mysql.deprecated">это FAQ</link>. +Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>. Альтернативы для этой функции:</para>'> <!ENTITY mysql.alternative.note.5-3-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 5.3.0, и, вместе с <link linkend="book.mysql">расширением MySQL</link>, удалена PHP 7.0.0. Вместо неё используйте активно развивающиеся расширения <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>. -Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link> и -<link linkend="faq.databases.mysql.deprecated">это FAQ</link>. +Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>. Альтернативы для этой функции:</para>'> <!ENTITY mysql.alternative.note.5-4-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 5.4.0, и, вместе с <link linkend="book.mysql">расширением MySQL</link>, удалена PHP 7.0.0. Вместо неё используйте активно развивающиеся расширения <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>. -Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link> и -<link linkend="faq.databases.mysql.deprecated">это FAQ</link>. +Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>. Альтернативы для этой функции:</para>'> <!ENTITY mysql.alternative.note.5-5-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 5.5.0, и, вместе с <link linkend="book.mysql">расширением MySQL</link>, удалена PHP 7.0.0. Вместо неё используйте активно развивающиеся расширения <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>. -Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link> и -<link linkend="faq.databases.mysql.deprecated">это FAQ</link>. +Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>. Альтернативы для этой функции:</para>'> <!ENTITY mysql.close.connections.result.sets '<para xmlns="http://docbook.org/ns/docbook">