svn: /phpdoc/ru/trunk/ language/control-structures.xml language-snippets.ent reference/bc/book.xml reference/dom/domxpath/query.xml reference/filesystem/functions/chgrp.xml reference/filesystem/functions/chown.xml reference/image/functions/imagecreatefromgd.xml reference/image/functions/imagecreatefromgd2.xml reference/image/functions/imagecreatefromgd2part.xml reference/image/functions/imagegd.xml reference/image/functions/imagegd2.xml reference/spl/spldoublylinkedlist.xml reference/strings/fun
[email protected] (Sergey Panteleev)
| Newsgroups | php.doc.ru |
|---|---|
| Message-ID | <[email protected]> |
sergey Fri, 06 Mar 2020 04:30:20 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=349335
Log:
docs(ru): Updated to English revision
Changed paths:
U phpdoc/ru/trunk/language/control-structures.xml
U phpdoc/ru/trunk/language-snippets.ent
U phpdoc/ru/trunk/reference/bc/book.xml
U phpdoc/ru/trunk/reference/dom/domxpath/query.xml
U phpdoc/ru/trunk/reference/filesystem/functions/chgrp.xml
U phpdoc/ru/trunk/reference/filesystem/functions/chown.xml
U phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd.xml
U phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2.xml
U phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2part.xml
U phpdoc/ru/trunk/reference/image/functions/imagegd.xml
U phpdoc/ru/trunk/reference/image/functions/imagegd2.xml
U phpdoc/ru/trunk/reference/spl/spldoublylinkedlist.xml
U phpdoc/ru/trunk/reference/strings/functions/strip-tags.xml
U phpdoc/ru/trunk/reference/zip/ziparchive/getstatusstring.xml
U phpdoc/ru/trunk/reference/zip/ziparchive.xml
svn-diffs-349335.txt
(text/x-diff, 17.6 KB)
Modified: phpdoc/ru/trunk/language/control-structures.xml
===================================================================
--- phpdoc/ru/trunk/language/control-structures.xml 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/language/control-structures.xml 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 288721 Maintainer: shafff Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 349319 Maintainer: shafff Status: ready -->
+<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<chapter xml:id="language.control-structures" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -17,6 +17,23 @@
Блок инструкций также сам по себе является инструкцией.
В этом разделе описываются различные типы инструкций.
</simpara>
+
+ <sect2 role="seealso">
+ &reftitle.seealso;
+ <para>
+ Ниже также рассматриваются языковые конструкции, даже если они
+ упоминаются в функциях руководства.
+ </para>
+ <para>
+ <simplelist>
+ <member><function>list</function></member>
+ <member><function>array</function></member>
+ <member><function>echo</function></member>
+ <member><function>eval</function></member>
+ </simplelist>
+ </para>
+ </sect2>
+
</sect1>
&language.control-structures.if;
Modified: phpdoc/ru/trunk/language-snippets.ent
===================================================================
--- phpdoc/ru/trunk/language-snippets.ent 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/language-snippets.ent 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 349148 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 349322 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
@@ -562,6 +562,8 @@
<entry>7.0.0</entry><entry>Поддержка T1Lib удалена из PHP и эта функция, соответственно, тоже.</entry>
</row>'>
+<!ENTITY gd.deprecated.gd-formats '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Форматы изображений GD и GD2 являются проприетарными форматами изображений libgd. Они должны рассматриваться как <emphasis>устаревшие</emphasis> и должны использоваться только для целей разработки и тестирования.</simpara></warning>'>
+
<!-- DBM notes -->
<!ENTITY dbm.dbm-identifier.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
Modified: phpdoc/ru/trunk/reference/bc/book.xml
===================================================================
--- phpdoc/ru/trunk/reference/bc/book.xml 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/bc/book.xml 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 347753 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 349317 Maintainer: tmn Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
@@ -12,8 +12,7 @@
<preface xml:id="intro.bc">
&reftitle.intro;
<para>
- Для вычислений с произвольной точностью PHP предоставляет двоичный
- калькулятор, который поддерживает числа любого размера и точности, вплоть до
+ Для вычислений с произвольной точностью PHP предоставляет BCMath, который поддерживает числа любого размера и точности, вплоть до
<literal>2147483647</literal> (или <literal>0x7FFFFFFF</literal>) десятичных знаков,
если хватит памяти, представленных в виде строк.
</para>
Modified: phpdoc/ru/trunk/reference/dom/domxpath/query.xml
===================================================================
--- phpdoc/ru/trunk/reference/dom/domxpath/query.xml 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/dom/domxpath/query.xml 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 344109 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 349324 Maintainer: tmn Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="domxpath.query" xmlns="http://docbook.org/ns/docbook">
Modified: phpdoc/ru/trunk/reference/filesystem/functions/chgrp.xml
===================================================================
--- phpdoc/ru/trunk/reference/filesystem/functions/chgrp.xml 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/filesystem/functions/chgrp.xml 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 308663 Maintainer: shein Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 349320 Maintainer: shein Status: ready -->
+<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.chgrp">
<refnamediv>
@@ -82,6 +82,11 @@
&reftitle.notes;
¬e.no-remote;
¬e.sm.uidcheck;
+ <note>
+ <simpara>
+ В Windows функция молча завершается ошибкой при применении к обычному файлу.
+ </simpara>
+ </note>
</refsect1>
<refsect1 role="seealso">
Modified: phpdoc/ru/trunk/reference/filesystem/functions/chown.xml
===================================================================
--- phpdoc/ru/trunk/reference/filesystem/functions/chown.xml 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/filesystem/functions/chown.xml 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 336238 Maintainer: shein Status: ready -->
-<!-- Reviewed: yes -->
+<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.chown">
<refnamediv>
@@ -101,6 +101,11 @@
&reftitle.notes;
¬e.no-remote;
¬e.sm.uidcheck;
+ <note>
+ <simpara>
+ В Windows функция молча завершается ошибкой при применении к обычному файлу.
+ </simpara>
+ </note>
</refsect1>
<refsect1 role="seealso">
Modified: phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd.xml
===================================================================
--- phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd.xml 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd.xml 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 336340 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 349322 Maintainer: tmn Status: ready -->
<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<refentry xml:id='function.imagecreatefromgd' xmlns="http://docbook.org/ns/docbook">
@@ -67,6 +67,12 @@
</example>
</para>
</refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ &gd.deprecated.gd-formats;
+ </refsect1>
+
</refentry>
<!-- Keep this comment at the end of the file
Modified: phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2.xml
===================================================================
--- phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2.xml 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2.xml 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 339875 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 349322 Maintainer: tmn Status: ready -->
<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<refentry xml:id='function.imagecreatefromgd2' xmlns="http://docbook.org/ns/docbook">
@@ -66,6 +66,11 @@
</example>
</para>
</refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ &gd.deprecated.gd-formats;
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Modified: phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2part.xml
===================================================================
--- phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2part.xml 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/image/functions/imagecreatefromgd2part.xml 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 339875 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 349322 Maintainer: tmn Status: ready -->
<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<refentry xml:id='function.imagecreatefromgd2part' xmlns="http://docbook.org/ns/docbook">
@@ -101,6 +101,11 @@
</example>
</para>
</refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ &gd.deprecated.gd-formats;
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Modified: phpdoc/ru/trunk/reference/image/functions/imagegd.xml
===================================================================
--- phpdoc/ru/trunk/reference/image/functions/imagegd.xml 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/image/functions/imagegd.xml 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 344720 Maintainer: aur Status: ready -->
+<!-- EN-Revision: 349322 Maintainer: aur Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xml:id='function.imagegd' xmlns="http://docbook.org/ns/docbook">
@@ -126,6 +126,7 @@
Заметим, что формат GD используется только в GD-совместимых приложениях.
</para>
</note>
+ &gd.deprecated.gd-formats;
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
Modified: phpdoc/ru/trunk/reference/image/functions/imagegd2.xml
===================================================================
--- phpdoc/ru/trunk/reference/image/functions/imagegd2.xml 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/image/functions/imagegd2.xml 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 344720 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 349322 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<!-- $Revision$ -->
<refentry xml:id='function.imagegd2' xmlns="http://docbook.org/ns/docbook">
@@ -140,6 +140,7 @@
GD2-совместимых приложениях.
</para>
</note>
+ &gd.deprecated.gd-formats;
</refsect1>
<refsect1 role="seealso">
Modified: phpdoc/ru/trunk/reference/spl/spldoublylinkedlist.xml
===================================================================
--- phpdoc/ru/trunk/reference/spl/spldoublylinkedlist.xml 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/spl/spldoublylinkedlist.xml 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 347439 Maintainer: northcat Status: ready -->
+<!-- EN-Revision: 349321 Maintainer: northcat Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
<phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.spldoublylinkedlist" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс SplDoublyLinkedList</title>
@@ -43,6 +43,10 @@
<interfacename>Countable</interfacename>
</oointerface>
+ <oointerface>
+ <interfacename>Serializable</interfacename>
+ </oointerface>
+
</classsynopsisinfo>
<!-- }}} -->
Modified: phpdoc/ru/trunk/reference/strings/functions/strip-tags.xml
===================================================================
--- phpdoc/ru/trunk/reference/strings/functions/strip-tags.xml 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/strings/functions/strip-tags.xml 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 348925 Maintainer: shein Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 349323 Maintainer: shein Status: ready -->
+<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strip-tags">
<refnamediv>
@@ -13,10 +13,10 @@
<methodsynopsis>
<type>string</type><methodname>strip_tags</methodname>
<methodparam><type>string</type><parameter>str</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>allowable_tags</parameter></methodparam>
+ <methodparam choice="opt"><type>mixed</type><parameter>allowable_tags</parameter></methodparam>
</methodsynopsis>
<para>
- Эта функция пытается возвратить строку, из которой
+ функция пытается возвратить строку, из которой
удалены все NULL-байты, HTML- и PHP-теги. Для удаления тегов используется тот же механизм,
что и в функции <function>fgetss</function>.
</para>
@@ -40,6 +40,8 @@
<para>
Второй необязательный параметр может быть использован для
указания тегов, которые не нужно удалять.
+ Они указываются как строка (&string;) или как массив (&array;) с PHP 7.4.0.
+ Смотрите пример ниже относительно формата этого параметра.
</para>
<note>
<para>
@@ -92,6 +94,12 @@
</thead>
<tbody>
<row>
+ <entry>7.4.0</entry>
+ <entry>
+ <parameter>allowable_tags</parameter> теперь альтернативно принимает массив (&array;).
+ </entry>
+ </row>
+ <row>
<entry>5.3.4</entry>
<entry>
<function>strip_tags</function> игнорирует самозакрывающиеся теги XHTML
@@ -118,6 +126,9 @@
// Разрешаем <p> и <a>
echo strip_tags($text, '<p><a>');
+
+// Начиная с PHP 7.4.0, строка выше может быть записана как:
+// echo strip_tags($text, ['p', 'a']);
?>
]]>
</programlisting>
Modified: phpdoc/ru/trunk/reference/zip/ziparchive/getstatusstring.xml
===================================================================
--- phpdoc/ru/trunk/reference/zip/ziparchive/getstatusstring.xml 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/zip/ziparchive/getstatusstring.xml 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 322115 Maintainer: aur Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 349314 Maintainer: aur Status: ready -->
+<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<refentry xml:id="ziparchive.getstatusstring" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -29,6 +29,30 @@
Возвращает строку (<type>string</type>) с сообщением о статусе при успехе&return.falseforfailure;.
</para>
</refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>8.0.0 / 1.18.0</entry>
+ <entry>
+ Метод можно вызвать в закрытом архиве.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Modified: phpdoc/ru/trunk/reference/zip/ziparchive.xml
===================================================================
--- phpdoc/ru/trunk/reference/zip/ziparchive.xml 2020-03-06 04:07:18 UTC (rev 349334)
+++ phpdoc/ru/trunk/reference/zip/ziparchive.xml 2020-03-06 04:30:20 UTC (rev 349335)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 349304 Maintainer: daniil Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: 349311 Maintainer: daniil Status: ready -->
+<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.ziparchive" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс <classname>ZipArchive</classname></title>
@@ -65,13 +65,15 @@
<varlistentry xml:id="ziparchive.props.status">
<term><varname>status</varname></term>
<listitem>
- <para>Статус Zip-архива</para>
+ <para>Статус Zip-архива.
+ Доступно для закрытого архива, начиная с PHP 8.0.0 и PECL zip 1.18.0.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ziparchive.props.statussys">
<term><varname>statusSys</varname></term>
<listitem>
- <para>Системный статус Zip-архива</para>
+ <para>Системный статус Zip-архива.
+ Доступно для закрытого архива, начиная с PHP 8.0.0 и PECL zip 1.18.0.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ziparchive.props.numfiles">