Filter: improvements

git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@343656 c90b9560-bf6c-de11-be94-00142212c4b1
2025-08-16 18:22:04 +00:00 · 2017-12-16 08:20:16 +00:00
parent 3de13c58d4
commit abb0c528ea
4 changed files with 39 additions and 39 deletions
--- a/reference/filter/constants.xml
+++ b/reference/filter/constants.xml
@ -14,7 +14,7 @@
   </term>
   <listitem>
    <simpara>
-     <link linkend="reserved.variables.post">POST</link> переменные.
+     Переменные <link linkend="reserved.variables.post">POST</link>.
    </simpara>
   </listitem>
  </varlistentry>
@ -25,7 +25,7 @@
   </term>
   <listitem>
    <simpara>
-     <link linkend="reserved.variables.get">GET</link> переменные.
+     Переменные <link linkend="reserved.variables.get">GET</link>.
    </simpara>
   </listitem>
  </varlistentry>
@ -36,7 +36,7 @@
   </term>
   <listitem>
    <simpara>
-     <link linkend="reserved.variables.cookies">COOKIE</link> переменные.
+     Переменные <link linkend="reserved.variables.cookies">COOKIE</link>.
    </simpara>
   </listitem>
  </varlistentry>
@ -47,7 +47,7 @@
   </term>
   <listitem>
    <simpara>
-     <link linkend="reserved.variables.environment">ENV</link> переменные.
+     Переменные <link linkend="reserved.variables.environment">ENV</link>.
    </simpara>
   </listitem>
  </varlistentry>
@ -58,7 +58,7 @@
   </term>
   <listitem>
    <simpara>
-     <link linkend="reserved.variables.server">SERVER</link> переменные.
+     Переменные <link linkend="reserved.variables.server">SERVER</link>.
    </simpara>
   </listitem>
  </varlistentry>
@ -69,7 +69,7 @@
   </term>
   <listitem>
    <simpara>
-     <link linkend="reserved.variables.session">SESSION</link> переменные.
+     Переменные <link linkend="reserved.variables.session">SESSION</link>.
     (еще не реализовано)
    </simpara>
   </listitem>
@ -81,7 +81,7 @@
   </term>
   <listitem>
    <simpara>
-     <link linkend="reserved.variables.request">REQUEST</link> переменные.
+     Переменные <link linkend="reserved.variables.request">REQUEST</link>.
     (еще не реализовано)
    </simpara>
   </listitem>
@ -237,7 +237,7 @@
   </term>
   <listitem>
    <simpara>
-     Идентификатор фильтра по умолчанию ("unsafe_raw"). Равнозначен
+     Идентификатор фильтра по умолчанию ("unsafe_raw"). Эквивалентно
     <constant>FILTER_UNSAFE_RAW</constant>.
    </simpara>
   </listitem>
@ -392,7 +392,7 @@
   </term>
   <listitem>
    <simpara>
-     Удалять символы с ASCII кодом, меньшим 32.
+     Удалять символы с ASCII-кодом, меньшим 32.
    </simpara>
   </listitem>
  </varlistentry>
@ -403,7 +403,7 @@
   </term>
   <listitem>
    <simpara>
-     Удалять символы с ASCII кодом, большим 127.
+     Удалять символы с ASCII-кодом, большим 127.
    </simpara>
   </listitem>
  </varlistentry>
@ -414,7 +414,7 @@
   </term>
   <listitem>
    <simpara>
-     Кодировать символы с ASCII кодом, меньшим 32.
+     Кодировать символы с ASCII-кодом, меньшим 32.
    </simpara>
   </listitem>
  </varlistentry>
@ -425,7 +425,7 @@
   </term>
   <listitem>
    <simpara>
-     Кодировать символы с ASCII кодом, большим 127.
+     Кодировать символы с ASCII-кодом, большим 127.
    </simpara>
   </listitem>
  </varlistentry>
@ -480,7 +480,7 @@
   </term>
   <listitem>
    <simpara>
-     Разрешить разделитель (<literal>,</literal>) между группами цифр по 3 в фильтре "number_float".
+     Разрешить разделитель (<literal>,</literal>) в фильтре "number_float".
    </simpara>
   </listitem>
  </varlistentry>
@ -503,7 +503,7 @@
   </term>
   <listitem>
    <simpara>
-     Требовать наличие составляющей "путь" в фильтре "validate_url".
+     Требовать наличие пути в фильтре "validate_url".
    </simpara>
   </listitem>
  </varlistentry>
@ -525,7 +525,7 @@
   </term>
   <listitem>
    <simpara>
-     Разрешить только IPv4 адреса в фильтре "validate_ip".
+     Разрешить только IPv4-адреса в фильтре "validate_ip".
    </simpara>
   </listitem>
  </varlistentry>
@ -536,7 +536,7 @@
   </term>
   <listitem>
    <simpara>
-     Разрешить только IPv6 адреса в фильтре "validate_ip".
+     Разрешить только IPv6-адреса в фильтре "validate_ip".
    </simpara>
   </listitem>
  </varlistentry>
--- a/reference/filter/examples.xml
+++ b/reference/filter/examples.xml
@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 247c617b3d54ac8b8fcd8d82516a476c751ddafd Maintainer: mch Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes -->
 <!-- $Revision$ -->

 <chapter xml:id="filter.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -40,7 +40,7 @@ E-mail адрес 'bogus' указан неверно.
  
  <para>
   <example>
-    <title>Валидация IP адреса, используя функцию <function>filter_var</function></title>
+    <title>Валидация IP-адреса, используя функцию <function>filter_var</function></title>
    <programlisting role="php" xml:id="filter.examples.validation.ip">
 <![CDATA[
 <?php
@ -109,7 +109,7 @@ if (($int_c = filter_var($int_c, FILTER_VALIDATE_INT, $options)) !== FALSE) {
 </section>
 
 <section xml:id="filter.examples.sanitization">
-  <title>Нормализация значения (Sanitizing)</title>
+  <title>Очистка (нормализация)</title>
  <para>
   <example>
    <title>Нормализация и валидация e-mail адресов</title>
--- a/reference/filter/filters.xml
+++ b/reference/filter/filters.xml
@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 8ac7e3e35e5405bd7f07c42401b3e7199c0d0acf Maintainer: shein Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <chapter xml:id="filter.filters" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Типы фильтров</title>
@ -57,8 +57,8 @@
         Проверяет, что значение является корректным e-mail.
        </para>
        <para>
-         В целом, происходит проверка синтаксиса адреса в соответствии с RFC 822, с тем
-         исключением, что не поддерживаются комментарии, схлопывание пробельных
+         В целом, происходит проверка синтаксиса адреса в соответствии с RFC 822, за исключением того,
+         что не поддерживаются комментарии, схлопывание пробельных
         символов и доменные имена без точек.
        </para>
       </entry>
@ -87,7 +87,8 @@
        <constant>FILTER_FLAG_ALLOW_OCTAL</constant>,
        <constant>FILTER_FLAG_ALLOW_HEX</constant>
       </entry>
-       <entry>Проверяет, что значение является корректным целым числом, и, при необходимости, входит в определенный диапазон.</entry>
+       <entry>Проверяет, что значение является корректным целым числом, и, при необходимости,
+        входит в определенный диапазон, при успешной проверке преобразует в целое число.</entry>
      </row>
      <row>
       <entry><constant>FILTER_VALIDATE_IP</constant></entry>
@ -148,7 +149,7 @@
        что URL использует требуемый протокол, например <literal>ssh://</literal> или
        <literal>mailto:</literal>. Обратите внимание, что эта функция считает корректными
        только URL, состоящие из символов ASCII; Интернациональные доменные имена 
-        провалят проверку.
+        не пройдут проверку.
       </entry>
      </row>
     </tbody>
@ -157,7 +158,7 @@
  </para>
  <note>
   <para>
-    С PHP 5.4.11, числа +0 and -0 проходят проверку и как целые и как с плавающей запятой
+    С PHP 5.4.11 числа +0 и -0 проверяются как целые числа, так и числа с плавающей запятой
    (<constant>FILTER_VALIDATE_FLOAT</constant> и
    <constant>FILTER_VALIDATE_INT</constant>). До PHP 5.4.11 они проходили проверку
    только как числа с плавающей запятой (<constant>FILTER_VALIDATE_FLOAT</constant>).
@ -310,7 +311,7 @@
        <constant>FILTER_FLAG_ENCODE_HIGH</constant>,
        <constant>FILTER_FLAG_ENCODE_AMP</constant>
       </entry>
-       <entry>Удаляет тэги, при необходимости удаляет или кодирует специальные символы.</entry>
+       <entry>Удаляет теги, при необходимости удаляет или кодирует специальные символы.</entry>
      </row>
      <row>
       <entry><constant>FILTER_SANITIZE_STRIPPED</constant></entry>
@ -339,7 +340,7 @@
        <constant>FILTER_FLAG_ENCODE_AMP</constant>
       </entry> 
       <entry>Бездействует, при необходимости удаляет или кодирует специальные символы.
-        Этот фильтр так же является синонимом <constant>FILTER_DEFAULT</constant></entry>
+        Этот фильтр является псевдонимом <constant>FILTER_DEFAULT</constant></entry>.
      </row>
     </tbody>
    </tgroup>
@ -510,7 +511,7 @@ filter.default_flags = 0
        <constant>FILTER_SANITIZE_STRING</constant>
       </entry>
       <entry>
-        При установке этого флага одиночные (<literal>'</literal>) и двойные
+        При установке этого флага одинарные (<literal>'</literal>) и двойные
        (<literal>"</literal>) кавычки кодироваться не будут.
       </entry>
      </row>
@ -643,13 +644,12 @@ filter.default_flags = 0
       </entry>
      </row>
      <row>
-       <entry><constant>FILTER_FLAG_PATH_REQUIRED</constant></entry>
+       <entry><constant>FILTER_FLAG_SCHEME_REQUIRED</constant></entry>
       <entry>
        <constant>FILTER_VALIDATE_URL</constant>
       </entry>
       <entry>
-        Включает содержание пути в <acronym>URL</acronym> в качестве необходимого
-        условия.
+        Требует, чтобы <acronym>URL</acronym> содержал часть со схемой.
       </entry>
      </row>
      <row>
@ -658,7 +658,7 @@ filter.default_flags = 0
        <constant>FILTER_VALIDATE_URL</constant>
       </entry>
       <entry>
-        Требует, что бы <acronym>URL</acronym> содержал часть с хостом.
+        Требует, чтобы <acronym>URL</acronym> содержал часть с хостом.
       </entry>
      </row>
      <row>
@ -667,7 +667,7 @@ filter.default_flags = 0
        <constant>FILTER_VALIDATE_URL</constant>
       </entry>
       <entry>
-        Требует, что бы <acronym>URL</acronym> содержал часть с путем.
+        Требует, чтобы <acronym>URL</acronym> содержал часть с путем.
       </entry>
      </row>
      <row>
@ -676,7 +676,7 @@ filter.default_flags = 0
        <constant>FILTER_VALIDATE_URL</constant>
       </entry>
       <entry>
-        Требует, что бы <acronym>URL</acronym> содержал часть со строкой запроса.
+        Требует, чтобы <acronym>URL</acronym> содержал часть со строкой запроса.
       </entry>
      </row>
      <row>
@ -684,7 +684,7 @@ filter.default_flags = 0
       <entry>
       </entry>
       <entry>
-        Требует, чтобы значение было скалярной величиной.
+        Требует, чтобы значение было скалярным.
       </entry>
      </row>
      <row>
@ -700,8 +700,8 @@ filter.default_flags = 0
       <entry>
       </entry>
       <entry>
-        Если значение скалярное, то оно трактуется как массив с одним элементом, 
-        равным этому значению.
+        Если значение скалярное, то оно будет рассматриваться как массив с единственным элементом
+        с этим значением
       </entry>
      </row>
     </tbody>
--- a/reference/filter/ini.xml
+++ b/reference/filter/ini.xml
@ -47,9 +47,9 @@
   </term>
   <listitem>
    <para>
-     Фильтрует все <varname>$_GET</varname>, <varname>$_POST</varname>, 
+     Фильтрует все данные <varname>$_GET</varname>, <varname>$_POST</varname>, 
     <varname>$_COOKIE</varname>,  <varname>$_REQUEST</varname> и 
-     <varname>$_SERVER</varname> данные этим фильтром.
+     <varname>$_SERVER</varname> этим фильтром.
     Исходные данные могут быть получены с помощью <function>filter_input</function>.
    </para>
    <para>