Обновление до английской версии (#326)

2025-08-16 18:22:04 +00:00 · 2021-09-23 11:03:14 +03:00
parent 5ae8c52891
commit be32e7d75d
9 changed files with 44 additions and 93 deletions
--- a/install/fpm/configuration.xml
+++ b/install/fpm/configuration.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a0ae28d3bc85f927c22649ebd9a590b921534b7d Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 4eeb07225f615fcde68cbefb84df2fc9bf278f1f Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <sect1 xml:id="install.fpm.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -898,7 +898,7 @@ php_admin_value[memory_limit] = 32M
   не могут быть перезаписаны через <function>ini_set</function>.
  </para>
  <para>
-   Начиная с версии 5.3.3 настройки PHP можно устанавливать через веб-сервер.
+   Настройки PHP можно устанавливать через веб-сервер.
   <example>
    <title>Установка настроек PHP в nginx.conf</title>
    <programlisting role="ini">
--- a/install/ini.xml
+++ b/install/ini.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a0ae28d3bc85f927c22649ebd9a590b921534b7d Maintainer: mch Status: ready -->
+<!-- EN-Revision: 4eeb07225f615fcde68cbefb84df2fc9bf278f1f Maintainer: mch Status: ready -->
 <!-- Reviewed: yes Maintainer: rjhdby -->
 <!-- $Revision$ -->
 <chapter xml:id="configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -21,8 +21,7 @@
    <listitem>
     <simpara>
      По месту расположения модуля SAPI (<literal>PHPIniDir</literal> директива
-      Apache 2, <literal>-c</literal> параметр командной строки CGI и CLI,
-      <literal>php_ini</literal> параметр в NSAPI)
+      Apache 2, <literal>-c</literal> параметр командной строки CGI и CLI)
     </simpara>
    </listitem>
    <listitem>
@ -195,50 +194,6 @@ $ PHP_INI_SCAN_DIR=/usr/local/etc/php.d: php
    </screen>
   </informalexample>
  </sect2>
-  <sect2 xml:id="configuration.file.changelog">
-   &reftitle.changelog;
-
-   <para>
-    <informaltable>
-     <tgroup cols="2">
-      <thead>
-       <row>
-        <entry>&Version;</entry>
-        <entry>&Description;</entry>
-       </row>
-      </thead>
-      <tbody>
-       <row>
-        <entry>7.0.0</entry>
-        <entry>
-         Символ "решётка" (<literal>#</literal>) больше не используется для комментариев.
-        </entry>
-       </row>
-       <row>
-        <entry>5.3.0</entry>
-        <entry>
-         Символ "решётка" (<literal>#</literal>) больше не должен использоваться для
-         комментариев и вызовет предупреждение в случае использования.
-        </entry>
-       </row>
-       <row>
-        <entry>5.2.0</entry>
-        <entry>
-         Переменная окружения <varname>PHP_INI_SCAN_DIR</varname> может быть
-         установлена для переопределения набора сканируемых директорий.
-        </entry>
-       </row>
-       <row>
-        <entry>5.1.0</entry>
-        <entry>
-         Можно ссылаться на существующие ini-переменные из ini-файлов.
-        </entry>
-       </row>
-      </tbody>
-     </tgroup>
-    </informaltable>
-   </para>
-  </sect2>
 </sect1>

 <sect1 xml:id="configuration.file.per-user">
--- a/install/pecl.xml
+++ b/install/pecl.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8e732e84a1425cf0ab3a5b0da8fe113c7a6da85e Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 4eeb07225f615fcde68cbefb84df2fc9bf278f1f Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->

@ -70,12 +70,20 @@
     Можно также указать отдельные ревизии для установки.
    </simpara>
   </listitem>
+   <listitem>
+    <simpara>
+     <acronym>git</acronym>
+    </simpara>
+    <simpara>
+     Многие модули PECL находятся на GitHub.
+    </simpara>
+   </listitem>
   <listitem>
    <simpara>
     <acronym>SVN</acronym>
    </simpara>
    <simpara>
-     Большинство модулей PECL, также, находятся в <acronym>SVN</acronym>. Веб-интерфейс
+     Многие модули PECL, также, находятся в <acronym>SVN</acronym>. Веб-интерфейс
     для просмотра доступен по адресу <link xlink:href="&url.php.svn;pecl/">&url.php.svn;pecl/</link>.
     Для загрузки напрямую из <acronym>SVN</acronym> используется следующая последовательность
     команд:
@ -353,7 +361,7 @@ Loaded Configuration File   C:\Program Files\PHP\5.2\php.ini
   Иногда использование инсталлятора <literal>pecl</literal> не подходит. Это
   может быть связано с тем, что вы находитесь за файерволом или из-за того,
   что модуль, который вы хотите установить, недоступен в PECL-совместимом
-   пакете (к примеру, модули из SVN у которых ещё нет релизов). Если вам необходимо
+   пакете (к примеру, модули из git, у которых ещё нет релизов). Если вам необходимо
   собрать такой модуль, вы можете использовать низкоуровневые утилиты для
   выполнения сборки вручную.
  </simpara>
--- a/install/unix/apache2.xml
+++ b/install/unix/apache2.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 2b8d27771259f48ce8a4b59b2b38f7c370fdc360 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 4eeb07225f615fcde68cbefb84df2fc9bf278f1f Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <sect1 xml:id="install.unix.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -128,7 +128,7 @@ make install
        <screen>
 <![CDATA[
 cd ../php-NN
-./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysqli
+./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-pdo-mysql
 make
 make install
 ]]>
--- a/install/unix/debian.xml
+++ b/install/unix/debian.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 3049bd1d4a1bf7c75076e817aeba02e71c0013c2 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: f8682cd86a71640bf8771186d1d40881c7a0295e Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <sect1 xml:id="install.unix.debian" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -18,31 +18,31 @@
 <para>
  Хотя и существует универсальная инструкция по установке PHP на Unix/Linux,
  в этом разделе мы рассмотрим особенности специфичные для Debian,
-  такие как использование команд <literal>apt-get</literal> или <literal>aptitude</literal>.
+  такие как использование команд <literal>apt</literal> или <literal>aptitude</literal>.
  В рамках этого руководства обе эти команды рассматриваются как взаимозаменяемые.
 </para>
 <sect2 xml:id="install.unix.debian.apt">
  <title>Использование APT</title>
  <simpara>
   Во первых, обратите внимание на то, что некоторые пакеты связаны:
-   <literal>libapache2-mod-php5</literal> нужен для интеграции с Apache 2, и
+   <literal>libapache-mod-php</literal> нужен для интеграции с Apache 2, и
   <literal>php-pear</literal> с PEAR.
  </simpara>
  <simpara>
   Во-вторых, перед установкой убедитесь, что список пакетов находится в актуальном
   состоянии. Как правило, это делается с помощью команды
-   <command>apt-get update</command>.
+   <command>apt update</command>.
  </simpara>
  <example xml:id="install.unix.debian.apt.example">
   <title>Пример установки Apache 2 на Debian</title>
   <programlisting role="shell">
 <![CDATA[
-# apt-get install php5-common libapache2-mod-php5 php5-cli
+# apt install php-common libapache2-mod-php php-cli
 ]]>
   </programlisting>
  </example>
  <simpara>
-   APT автоматически установит модуль PHP 5 для Apache 2 и все их зависимости и,
+   APT автоматически установит модуль PHP для Apache 2 и все их зависимости и,
   затем, активирует их. Apache должен быть перезапущен для того, чтобы
   изменения вступили в силу. Например:
  </simpara>
@ -64,21 +64,21 @@
   <link linkend="book.mysql">MySQL</link>,
   <link linkend="book.curl">cURL</link>,
   <link linkend="book.image">GD</link> и т.д., это также можно сделать с помощью
-   команды <literal>apt-get</literal>.
+   команды <literal>apt</literal>.
  </simpara>
  <example xml:id="install.unix.debian.config.example">
-   <title>Способы получить список дополнительных пакетов PHP 5</title>
+   <title>Способы получить список дополнительных пакетов PHP</title>
   <programlisting role="shell">
 <![CDATA[
-# apt-cache search php5
-# aptitude search php5
-# aptitude search php5 |grep -i mysql
+# apt-cache search php
+# apt search php | grep -i mysql
+# aptitude search php
 ]]>
   </programlisting>
  </example>
  <simpara>
   Будет выведен список большого числа пакетов, включая несколько
-   специфичных, таких как php5-cgi, php5-cli и php5-dev. Определите, какие вам нужны
+   специфичных, таких как php-cgi, php-cli and php-dev. Определите, какие вам нужны
   и установите с помощью <literal>apt-get</literal> или <literal>aptitude</literal>.
   И, так как Debian производит проверку зависимостей, вам будет выведен запрос
   на их установку.
@ -87,14 +87,14 @@
   <title>Установка PHP с MySQL и cURL</title>
   <programlisting role="shell">
 <![CDATA[
-# apt-get install php5-mysql php5-curl
+# apt install php-mysql php-curl
 ]]>
   </programlisting>
  </example>
  <simpara>
   APT автоматически добавит необходимые строки в соответствующие
-   &php.ini;, <filename>/etc/php5/apache2/php.ini</filename>,
-   <filename>/etc/php5/conf.d/pdo.ini</filename>, и т.д. В зависимости от модуля, будут
+   &php.ini;, <filename>/etc/php/7.4/php.ini</filename>,
+   <filename>/etc/php/7.4/conf.d/*.ini</filename>, и т.д. В зависимости от модуля, будут
   внесены записи типа <literal>extension=foo.so</literal>.
   В любом случае, чтобы эти изменения вступили в силу, необходимо будет перезапустить
   сервер веб-сервер.
@ -121,7 +121,7 @@
   <listitem>
    <simpara>
     Для установки пакетов в Debian существуют две основных команды (не считая стандартных
-     вариантов Linux): <literal>apt-get</literal> и <literal>aptitude</literal>.
+     вариантов Linux): <literal>apt</literal> и <literal>aptitude</literal>.
     Объяснения их синтаксиса, особенностей и отличий друг от друга выходит за
     рамки данного руководства.
    </simpara>
--- a/install/unix/index.xml
+++ b/install/unix/index.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd48d47d8be2ff78295bc1a8605807325d2f11fd Maintainer: shein Status: ready -->
+<!-- EN-Revision: 4eeb07225f615fcde68cbefb84df2fc9bf278f1f Maintainer: shein Status: ready -->
 <!-- Reviewed: yes Maintainer: rjhdby -->
 <!-- $Revision$ -->
 <chapter xml:id="install.unix" xmlns="http://docbook.org/ns/docbook">
@ -134,14 +134,12 @@
 </note>

 <!-- web server specific nodes -->
- &install.unix.apache1;
 &install.unix.apache2;
 &install.unix.nginx;
 &install.unix.lighttpd-14;
 &install.unix.litespeed;
 &install.unix.commandline;
 <!-- operating system specific nodes -->
- &install.unix.hpux;
 &install.unix.openbsd;
 &install.unix.solaris;
 <!-- distribution specific nodes -->
--- a/install/unix/openbsd.xml
+++ b/install/unix/openbsd.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d4fc928c2450c3211bb3569cc83670c13c3fad7b Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 4eeb07225f615fcde68cbefb84df2fc9bf278f1f Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <sect1 xml:id="install.unix.openbsd" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -91,18 +91,6 @@
   </listitem>
  </itemizedlist>
 </sect2>
-
- <sect2 xml:id="install.unix.openbsd.older">
-  <title>Старые релизы</title>
-  <simpara>
-   Старые релизы OpenBSD используют систему FLAVORS для компиляции статически
-   собранного PHP. Так как собрать бинарный пакет таким образом достаточно трудно,
-   он объявлен устаревшим. Вы всё ещё можете использовать старые стабильные
-   бинарные порты, если хотите, но они больше не поддерживаются командой OpenBSD.
-   Если у вас есть какие-либо возражения, обратитесь к Анилу Мадхавапедди, сейчас он
-   занимается поддержкой порта (ник avsm на openbsd dot com).
-  </simpara>
- </sect2>
 </sect1>

 <!-- Keep this comment at the end of the file
--- a/install/unix/solaris.xml
+++ b/install/unix/solaris.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8b11ddd74b1e0161d90749e21789b3fd83f0e6d6 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 4eeb07225f615fcde68cbefb84df2fc9bf278f1f Maintainer: rjhdby Status: ready -->
 <!-- $Revision$ -->
 <!-- Reviewed: yes Maintainer: rjhdby -->

@ -59,11 +59,6 @@
  <para>
   Для сборки некоторых модулей или редактирования исходников PHP также могут понадобиться
   <itemizedlist>
-    <listitem>
-     <simpara>
-      flex (до версии PHP 5.2)
-     </simpara>
-    </listitem>
    <listitem>
     <simpara>
      re2c
--- a/reference/funchand/functions/call-user-func.xml
+++ b/reference/funchand/functions/call-user-func.xml
@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: eec6a4a36bf452bf271f116e7b6b9bb09d1181c3 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 2eb43ad4f41a8c62516abd804721786e50717af6 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <refentry xml:id="function.call-user-func" xmlns="http://docbook.org/ns/docbook">
@ -62,6 +62,11 @@ echo $a."\n";
 // Вместо этого можно использовать этот способ
 call_user_func_array('increment', array(&$a));
 echo $a."\n";
+
+// Также можно использовать функцию в качестве переменной
+$increment = 'increment';
+$increment($a);
+echo $a."\n";
 ?>
 ]]>
         </programlisting>
@ -71,6 +76,7 @@ echo $a."\n";
 Warning: Parameter 1 to increment() expected to be a reference, value given in …
 0
 1
+2
 ]]>
         </screen>
        </example>
@ -206,6 +212,7 @@ call_user_func(function($arg) { print "[$arg]\n"; }, 'test');
   <simplelist>
    <member><function>call_user_func_array</function></member>
    <member><function>is_callable</function></member>
+    <member><link linkend="functions.variable-functions">Обращение к функциям через переменные</link></member>
    <member><methodname>ReflectionFunction::invoke</methodname></member>
    <member><methodname>ReflectionMethod::invoke</methodname></member>
   </simplelist>