svn: /phpdoc/ru/trunk/reference/wincache/ book.xml constants.xml ini.xml reference.xml win32build.xml
[email protected] (Sergey Panteleev)
| Newsgroups | php.doc.ru |
|---|---|
| Message-ID | <[email protected]> |
sergey Thu, 03 Oct 2019 04:26:49 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=348124
Log:
docs(ru): Review
Changed paths:
U phpdoc/ru/trunk/reference/wincache/book.xml
U phpdoc/ru/trunk/reference/wincache/constants.xml
U phpdoc/ru/trunk/reference/wincache/ini.xml
U phpdoc/ru/trunk/reference/wincache/reference.xml
U phpdoc/ru/trunk/reference/wincache/win32build.xml
svn-diffs-348124.txt
(text/x-diff, 18.2 KB)
Modified: phpdoc/ru/trunk/reference/wincache/book.xml
===================================================================
--- phpdoc/ru/trunk/reference/wincache/book.xml 2019-10-02 22:40:12 UTC (rev 348123)
+++ phpdoc/ru/trunk/reference/wincache/book.xml 2019-10-03 04:26:49 UTC (rev 348124)
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 343277 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<book xml:id="book.wincache" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Windows Cache для PHP</title>
@@ -10,13 +10,13 @@
<preface xml:id="intro.wincache">
&reftitle.intro;
<para>
- Windows Cache Extension для PHP - это кеширующшее расширение, позволяющее
+ Windows Cache Extension для PHP - это кеширующий модуль, позволяющий
увеличить скорость работы PHP-приложений на Windows и Windows Server. Как только
- вы включаете Windows Cache Extension и оно загружается движком PHP, приложения
+ вы включаете Windows Cache Extension и он загружается движком PHP, приложения
начинают получать все его преимущества без необходимости менять их код.
</para>
<para>
- Расширение включает 5 различных типов кешей. Далее рассказывается про
+ Модуль включает 5 различных типов кешей. Далее рассказывается про
назначение и преимущества каждого типа кеша.
</para>
<itemizedlist>
@@ -27,7 +27,7 @@
выдает новый поток данных, обычно в формате HTML. Т.е. на стороне веб-сервера,
PHP читает, разбирает, компилирует и запускает PHP-скрипт каждый раз, когда его
запрашивает клиент. Чтение, разбор и компиляция создают дополнительную нагрузку
- на спроцессорные ядра и файловую систему сервера, что сказывается на конечной
+ на процессорные ядра и файловую систему сервера, что сказывается на конечной
производительности приложения. Кеширование байткода (опкода) PHP позволяет
держать уже скомпилированный код в разделяемой памяти и использовать его
при следующих запросах к тому же скрипту.
@@ -34,8 +34,8 @@
</para>
<para>
Поддержка кеширования опкодов была удалена в <literal>Wincache 2.0.0</literal>.
- Так что если она вам нужна, то следует использовать расширение
- <link linkend="book.opcache">OPcache</link>, которое было включено в
+ Так что если она вам нужна, то следует использовать модуль
+ <link linkend="book.opcache">OPcache</link>, который был включен в
PHP начиная с PHP 5.5.0.
</para>
</listitem>
@@ -43,7 +43,7 @@
<para>
<emphasis>File Cache</emphasis> - даже если включено кеширование опкодов, PHP
все равно обращается к файлам на файловой системе. Когда PHP-скрипт размещен
- на удаленной файловой папке, файловые операции значительно снижают
+ в удаленной файловой папке, файловые операции значительно снижают
производительность. Windows Cache Extension включает файловое кеширование, которое
используется для сохранения контента скриптов в разделяемой памяти, что сильно
сокращает количество операций доступа к файловой системе для PHP.
@@ -52,11 +52,11 @@
<listitem>
<para>
<emphasis>Resolve File Path Cache</emphasis> - скрипты PHP довольно часто
- включают или оперируют файлами используя относительные пути. Каждый такой
+ включают или оперируют файлами, используя относительные пути. Каждый такой
путь сначала нормализуется PHP до абсолютного пути. Когда приложение использует
большое количество файлов и обращается к ним по относительным путям, операции
выведения абсолютных путей могут негативно сказаться на производительности.
- Расширение Windows Cache Extension предоставляет инструмент кеширования
+ Модуль Windows Cache Extension предоставляет инструмент кеширования
Resolve File Path, который используется для сохранения сопоставления относительных
и абсолютных файловых путей, позволяя снизить количество операций их выведения.
</para>
Modified: phpdoc/ru/trunk/reference/wincache/constants.xml
===================================================================
--- phpdoc/ru/trunk/reference/wincache/constants.xml 2019-10-02 22:40:12 UTC (rev 348123)
+++ phpdoc/ru/trunk/reference/wincache/constants.xml 2019-10-03 04:26:49 UTC (rev 348124)
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 317663 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<appendix xml:id="wincache.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
Modified: phpdoc/ru/trunk/reference/wincache/ini.xml
===================================================================
--- phpdoc/ru/trunk/reference/wincache/ini.xml 2019-10-02 22:40:12 UTC (rev 348123)
+++ phpdoc/ru/trunk/reference/wincache/ini.xml 2019-10-03 04:26:49 UTC (rev 348124)
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 339527 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<section xml:id="wincache.configuration" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
@@ -8,7 +8,7 @@
&extension.runtime;
<para>
В таблице представлен список конфигурационных параметров
- расширения WinCache:
+ модуля WinCache:
</para>
<para>
<table>
@@ -220,13 +220,13 @@
<listitem>
<simpara>
Определяет список идентификаторов IIS веб-серверов, разделенных запятой,
- для которых должен быть разрешено/запрещено файловое кеширование.
+ для которых должно быть разрешено/запрещено файловое кеширование.
Эта настройка работает в паре с <literal>wincache.fcenabled</literal>: если
<literal>wincache.fcenabled</literal> установлено в 1, то для серверов,
перечисленных в <literal>wincache.fcenabledfilter</literal> файловое кеширование
будет отключено; если <literal>wincache.fcenabled</literal> установлено как 0, то
для серверов, перечисленных в <literal>wincache.fcenabledfilter</literal>
- файловое кеширование будет разрешено.
+ файловое кеширование будет включено.
</simpara>
</listitem>
</varlistentry>
@@ -253,7 +253,7 @@
Включает/отключает функционал оповещения об изменении файла. Если функционал
оповещения об изменениях файла поддерживается, то он может быть использован для
обновления кеша опкодов и файлового кеша при получении соответствующих
- оповещений. Если подобный механизм не поддерживается, например при использовании
+ оповещений. Если подобный механизм не поддерживается, например, при использовании
сетевых папок, wincache будет самостоятельно проверять файлы на предмет
изменения через заданные в настройке <literal>wincache.chkinterval</literal>
интервалы времени.
@@ -292,7 +292,7 @@
<warning xmlns="http://docbook.org/ns/docbook"><simpara>Эта опция была <emphasis>УДАЛЕНА</emphasis> в версии 2.0.0.0</simpara></warning>
<simpara>
Определяет список идентификаторов IIS веб-серверов, разделенных запятой,
- для которых должен быть разрешено/запрещено кеширование опкодов.
+ для которых должно быть разрешено/запрещено кеширование опкодов.
Эта настройка работает в паре с <literal>wincache.ocenabled</literal>: если
<literal>wincache.ocenabled</literal> установлено в 1, то для серверов,
перечисленных в <literal>wincache.ocenabledfilter</literal> файловое кеширование
@@ -325,7 +325,7 @@
</term>
<listitem>
<simpara>
- Определяет, сколько примерно файлов будет закешировано расширением, чтобы
+ Определяет, сколько примерно файлов будет закешировано модулем, чтобы
при старте был выделен соответствующий кусок памяти. Если количество файлов
превысит заданное значение, то WinCache произведет переаллокацию памяти.
</simpara>
@@ -338,7 +338,7 @@
</term>
<listitem>
<simpara>
- Определяет насколько часто (в секундах) расширение будет проверять файлы
+ Определяет насколько часто (в секундах) модуль будет проверять файлы
на предмет их изменения для обновления кешей. Значение 0 отключает данный
функционал. Изменения файлов не будут отражены в кеше до тех пор, пока
закешированная запись не будет удалена из кеша сборщиком устаревших
@@ -381,7 +381,7 @@
Определяет список файлов, которые не нужно кешировать.
Указываются только имена файлов. Символ разделитель - вертикальная черта "|".
<example>
- <title>Пример <literal>wincache.ignorelist</literal></title>
+ <title>Пример использования <literal>wincache.ignorelist</literal></title>
<programlisting role="ini">
<![CDATA[
wincache.ignorelist = "index.php|misc.php|admin.php"
@@ -399,7 +399,7 @@
<listitem>
<simpara>
Определяет строку, которая будет использоваться при именовании
- объектов помещаемых в разделяемую память. Это необходимо для
+ объектов, помещаемых в разделяемую память. Это необходимо для
предотвращения коллизий, когда несколько процессов работают
с разделяемой памятью. Длина данной строки не должна
превышать 8 символов.
@@ -455,7 +455,7 @@
</simpara></warning>
<simpara>
Задает абсолютный или относительный путь к reroute.ini, который содержит список
- функций PHP, чья реализация должна быть подменена реализацией из расширения
+ функций PHP, чья реализация должна быть подменена реализацией из модуля
WinCache. Если задан относительный путь, то он будет разрешаться относительно
местоположения файла php-cgi.exe.
</simpara>
@@ -469,7 +469,7 @@
<listitem>
<simpara>
Включает/отключает перенаправление некоторых функций файлового ввода/вывода
- для работу черех файловый кеш.
+ для работы через файловый кеш.
</simpara>
</listitem>
</varlistentry>
Modified: phpdoc/ru/trunk/reference/wincache/reference.xml
===================================================================
--- phpdoc/ru/trunk/reference/wincache/reference.xml 2019-10-02 22:40:12 UTC (rev 348123)
+++ phpdoc/ru/trunk/reference/wincache/reference.xml 2019-10-03 04:26:49 UTC (rev 348124)
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 317663 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<reference xml:id="ref.wincache" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>&Functions; WinCache</title>
Modified: phpdoc/ru/trunk/reference/wincache/win32build.xml
===================================================================
--- phpdoc/ru/trunk/reference/wincache/win32build.xml 2019-10-02 22:40:12 UTC (rev 348123)
+++ phpdoc/ru/trunk/reference/wincache/win32build.xml 2019-10-03 04:26:49 UTC (rev 348124)
@@ -1,14 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 317663 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<appendix xml:id="wincache.win32build" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>Building for Windows</title>
+ <title>Сборка для Windows</title>
<section xml:id="wincache.win32build.prereq">
<title>Пререквизиты</title>
<para>
- Для сборки расширения WinCache требуется:
+ Для сборки модуля WinCache требуется:
</para>
<orderedlist spacing="compact">
<listitem>
@@ -27,7 +27,7 @@
</para>
<para>
Получение исходного кода WinCache описано в разделе
- <link linkend="install.pecl.downloads">Скачивание PECL-расширений</link>.
+ <link linkend="install.pecl.downloads">Скачивание PECL-модулей</link>.
</para>
</section>
<section xml:id="wincache.win32build.building">
@@ -71,10 +71,10 @@
configure.js [все опции для сборки PHP] --enable-wincache
]]>
</programlisting>
- <literal>--enable-wincache</literal> is the only extra option which is
- required to ensure that WinCache extension gets built properly.
- This option will build WinCache and will statically link it with PHP dll.
- To build WinCache extension as a stand-alone DLL use the option
+ <literal>--enable-wincache</literal> это единственная дополнительная опция,
+ которая требуется для правильной сборки модуля WinCache.
+ Эта опция соберет WinCache и будет статически связывать его с PHP dll.
+ Чтобы создать модуль WinCache в качестве автономной библиотеки DLL, используйте параметр
<literal>--enable-wincache=shared</literal>.
</para>
</step>
@@ -93,7 +93,7 @@
<section xml:id="wincache.win32build.verify">
<title>Проверка сборки</title>
<para>
- Следующие шаги описывают процесс проверки того, что расширение было собрано корректно:
+ Следующие шаги описывают процесс проверки того, что модуль был собран корректно:
</para>
<procedure>
<step>
@@ -109,7 +109,7 @@
php.exe -n -d extension=php_wincache.dll -re wincache
]]>
</programlisting>
- Если расширение собрано правильно, в выводе этой команды будут показаны
+ Если модуль собран правильно, в выводе этой команды будут показаны
INI-директивы и функции поддерживаемые WinCache.
</para>
</step>