com doc/ru: Обновлен ие до англи йской верси и: language/oop5/variance.xml reference/errorfun
c/functions/set-error-handler.xml reference/filesystem/func tions/basename.xml reference/ftp/functions/ftp-mdtm.xml
reference/ftp/functions/ftp-mkdir.xml
| From: | Sergey Panteleev | Date: | Sat, 20 Feb 2021 06:51:26 +0000 |
| Subject: | com doc/ru: Обновлен ие до англи йской верси и: language/oop5/variance.xml reference/errorfun c/functions/set-error-handler.xml reference/filesystem/func tions/basename.xml reference/ftp/functions/ftp-mdtm.xml reference/ftp/functions/ftp-mkdir.xml |
||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-8811@lists.php.net to get a copy of this message | ||
Commit: bc16ef73e397bb1a9e955ce6ca80ec2626c1876b
Author: Sergey Panteleev <sergey@php.net> Sat, 20 Feb 2021 09:49:51 +0300
Parents: f56d8a0d55221adf436f31869ad3353cb84b6896
Branches: master
Link: http://git.php.net/?p=doc/ru.git;a=commitdiff;h=bc16ef73e397bb1a9e955ce6ca80ec2626c1876b
Log:
Обновление до английской версии
Changed paths:
M language/oop5/variance.xml
M reference/errorfunc/functions/set-error-handler.xml
M reference/filesystem/functions/basename.xml
M reference/ftp/functions/ftp-mdtm.xml
M reference/ftp/functions/ftp-mkdir.xml
diff --git a/language/oop5/variance.xml b/language/oop5/variance.xml index 03c6c1a76..8721db20f 100644 --- a/language/oop5/variance.xml +++ b/language/oop5/variance.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 84b2eca1809fb0b2a7315cefb8810ca96fbeebb6 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: 871df69f47f578c79cad7889f7e27d4b737baf4d Maintainer: rjhdby Status: ready --> <!-- Reviewed: no --> <sect1 xml:id="language.oop5.variance" xmlns="http://docbook.org/ns/docbook"> <title>Ковариантность и контравариантность</title> @@ -17,6 +17,29 @@ специфичным в дочернем методе, чем его родительский метод. </para> + <para> + Объявление типа считается более конкретным в следующем случае: + <itemizedlist> + <listitem> + <simpara> + Удалён тип union + </simpara> + </listitem> + <listitem> + <simpara> + Тип класса изменяется на тип дочернего класса + </simpara> + </listitem> + <listitem> + <simpara> + Число с плавающей точкой (<type>float</type>) изменено на целое число (<type>int</type>) + </simpara> + </listitem> + </itemizedlist> + + В противном случае класс типа считается менее конкретным. + </para> + <sect2 xml:id="language.oop5.variance.covariance"> <title>Ковариантность</title> diff --git a/reference/errorfunc/functions/set-error-handler.xml b/reference/errorfunc/functions/set-error-handler.xml index 380871f19..a2368cb17 100644 --- a/reference/errorfunc/functions/set-error-handler.xml +++ b/reference/errorfunc/functions/set-error-handler.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 71c12b158398eec7f65644d489749230984d43f6 Maintainer: tmn Status: ready --> +<!-- EN-Revision: 12b1d4704ea448b55ec155619be1e50c0e67e9f9 Maintainer: tmn Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.set-error-handler" xmlns="http://docbook.org/ns/docbook"> @@ -33,13 +33,17 @@ никакие типы ошибок, определённые в <parameter>error_types</parameter>, пока callback-функция не вернёт &false;. Пользовательский обработчик будет вызываться при любой ошибке, независимо от настроек, заданных функцией - <function>error_reporting</function>. Однако, вы можете прочитать текущее - значение <link linkend="ini.error-reporting">error_reporting</link> и - задать в обработчике соответствующие действия. В частности, это значение - будет равно 0, если выражение, вызвавшее ошибку, начинается с - <link linkend="language.operators.errorcontrol">оператора контроля - ошибок @</link>. + <link linkend="ini.error-reporting">error_reporting</link>. </para> + + <warning> + <para> + До PHP 8.0.0 значение <parameter>errno</parameter> всегда было + <literal>0</literal>, если выражение, вызвавшее диагностику, было добавлено + с помощью <link linkend="language.operators.errorcontrol">оператора управления ошибками @</link>. + </para> + </warning> + <para> Также важно помнить, что на совести обработчика лежит вызов функции <function>die</function> в случае необходимости. Если происходит возврат @@ -199,6 +203,14 @@ <row> <entry>8.0.0</entry> <entry> + <parameter>errno</parameter> больше не <literal>0</literal>, когда + выражение было подавлено с помощью + <link linkend="language.operators.errorcontrol">оператора управления ошибками @</link> + </entry> + </row> + <row> + <entry>8.0.0</entry> + <entry> Параметр <parameter>errcontext</parameter> был удалён и больше не передаётся в пользовательскую функцию обработки ошибок. </entry> diff --git a/reference/filesystem/functions/basename.xml b/reference/filesystem/functions/basename.xml index 8f773e031..70c352ad0 100644 --- a/reference/filesystem/functions/basename.xml +++ b/reference/filesystem/functions/basename.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: shein Status: ready --> +<!-- EN-Revision: 88c1f8d6c9fecf352c5ce152a6f758ed013fc2c0 Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.basename" xmlns="http://docbook.org/ns/docbook"> @@ -33,6 +33,8 @@ для корректной обработки пути с многобайтными символами должна быть установлена соответствующая локаль с помощью функции <function>setlocale</function>. + Если <parameter>path</parameter> содержит символы, недопустимые для + текущей локали, поведение <function>basename</function> не определено. </para> </caution> </refsect1> diff --git a/reference/ftp/functions/ftp-mdtm.xml b/reference/ftp/functions/ftp-mdtm.xml index b0188a5a6..39510cd72 100644 --- a/reference/ftp/functions/ftp-mdtm.xml +++ b/reference/ftp/functions/ftp-mdtm.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 18680fd1681731888c6fb7c530cfdb712f53e954 Maintainer: blindman Status: ready --> +<!-- EN-Revision: def2d256ef5806ca6e7b59e05b8ee312e3703a0f Maintainer: blindman Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.ftp-mdtm" xmlns="http://docbook.org/ns/docbook"> @@ -55,8 +55,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Возвращает время последней модификации виде временной метки Unix или -1 в - случае ошибки. + Возвращает время последней модификации виде <emphasis>локальной</emphasis> временной метки Unix или -1 в + случае возникновения ошибки. </para> </refsect1> <refsect1 role="examples"> diff --git a/reference/ftp/functions/ftp-mkdir.xml b/reference/ftp/functions/ftp-mkdir.xml index e3028d240..3e003dd88 100644 --- a/reference/ftp/functions/ftp-mkdir.xml +++ b/reference/ftp/functions/ftp-mkdir.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 18680fd1681731888c6fb7c530cfdb712f53e954 Maintainer: blindman Status: ready --> +<!-- EN-Revision: 7786b06044cb6ab7c471f895057fe6070f3344d9 Maintainer: blindman Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.ftp-mkdir" xmlns="http://docbook.org/ns/docbook"> @@ -48,6 +48,15 @@ в противном случае. </para> </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + <simpara> + Выдаёт ошибку уровня <constant>E_WARNING</constant>, если каталог + уже существует или соответствующие права доступа препятствуют созданию каталога. + </simpara> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para>
diff --git a/language/oop5/variance.xml b/language/oop5/variance.xml index 03c6c1a76..8721db20f 100644 --- a/language/oop5/variance.xml +++ b/language/oop5/variance.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 84b2eca1809fb0b2a7315cefb8810ca96fbeebb6 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: 871df69f47f578c79cad7889f7e27d4b737baf4d Maintainer: rjhdby Status: ready --> <!-- Reviewed: no --> <sect1 xml:id="language.oop5.variance" xmlns="http://docbook.org/ns/docbook"> <title>Ковариантность и контравариантность</title> @@ -17,6 +17,29 @@ специфичным в дочернем методе, чем его родительский метод. </para> + <para> + Объявление типа считается более конкретным в следующем случае: + <itemizedlist> + <listitem> + <simpara> + Удалён тип union + </simpara> + </listitem> + <listitem> + <simpara> + Тип класса изменяется на тип дочернего класса + </simpara> + </listitem> + <listitem> + <simpara> + Число с плавающей точкой (<type>float</type>) изменено на целое число (<type>int</type>) + </simpara> + </listitem> + </itemizedlist> + + В противном случае класс типа считается менее конкретным. + </para> + <sect2 xml:id="language.oop5.variance.covariance"> <title>Ковариантность</title> diff --git a/reference/errorfunc/functions/set-error-handler.xml b/reference/errorfunc/functions/set-error-handler.xml index 380871f19..a2368cb17 100644 --- a/reference/errorfunc/functions/set-error-handler.xml +++ b/reference/errorfunc/functions/set-error-handler.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 71c12b158398eec7f65644d489749230984d43f6 Maintainer: tmn Status: ready --> +<!-- EN-Revision: 12b1d4704ea448b55ec155619be1e50c0e67e9f9 Maintainer: tmn Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.set-error-handler" xmlns="http://docbook.org/ns/docbook"> @@ -33,13 +33,17 @@ никакие типы ошибок, определённые в <parameter>error_types</parameter>, пока callback-функция не вернёт &false;. Пользовательский обработчик будет вызываться при любой ошибке, независимо от настроек, заданных функцией - <function>error_reporting</function>. Однако, вы можете прочитать текущее - значение <link linkend="ini.error-reporting">error_reporting</link> и - задать в обработчике соответствующие действия. В частности, это значение - будет равно 0, если выражение, вызвавшее ошибку, начинается с - <link linkend="language.operators.errorcontrol">оператора контроля - ошибок @</link>. + <link linkend="ini.error-reporting">error_reporting</link>. </para> + + <warning> + <para> + До PHP 8.0.0 значение <parameter>errno</parameter> всегда было + <literal>0</literal>, если выражение, вызвавшее диагностику, было добавлено + с помощью <link linkend="language.operators.errorcontrol">оператора управления ошибками @</link>. + </para> + </warning> + <para> Также важно помнить, что на совести обработчика лежит вызов функции <function>die</function> в случае необходимости. Если происходит возврат @@ -199,6 +203,14 @@ <row> <entry>8.0.0</entry> <entry> + <parameter>errno</parameter> больше не <literal>0</literal>, когда + выражение было подавлено с помощью + <link linkend="language.operators.errorcontrol">оператора управления ошибками @</link> + </entry> + </row> + <row> + <entry>8.0.0</entry> + <entry> Параметр <parameter>errcontext</parameter> был удалён и больше не передаётся в пользовательскую функцию обработки ошибок. </entry> diff --git a/reference/filesystem/functions/basename.xml b/reference/filesystem/functions/basename.xml index 8f773e031..70c352ad0 100644 --- a/reference/filesystem/functions/basename.xml +++ b/reference/filesystem/functions/basename.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: shein Status: ready --> +<!-- EN-Revision: 88c1f8d6c9fecf352c5ce152a6f758ed013fc2c0 Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.basename" xmlns="http://docbook.org/ns/docbook"> @@ -33,6 +33,8 @@ для корректной обработки пути с многобайтными символами должна быть установлена соответствующая локаль с помощью функции <function>setlocale</function>. + Если <parameter>path</parameter> содержит символы, недопустимые для + текущей локали, поведение <function>basename</function> не определено. </para> </caution> </refsect1> diff --git a/reference/ftp/functions/ftp-mdtm.xml b/reference/ftp/functions/ftp-mdtm.xml index b0188a5a6..39510cd72 100644 --- a/reference/ftp/functions/ftp-mdtm.xml +++ b/reference/ftp/functions/ftp-mdtm.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 18680fd1681731888c6fb7c530cfdb712f53e954 Maintainer: blindman Status: ready --> +<!-- EN-Revision: def2d256ef5806ca6e7b59e05b8ee312e3703a0f Maintainer: blindman Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.ftp-mdtm" xmlns="http://docbook.org/ns/docbook"> @@ -55,8 +55,8 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Возвращает время последней модификации виде временной метки Unix или -1 в - случае ошибки. + Возвращает время последней модификации виде <emphasis>локальной</emphasis> временной метки Unix или -1 в + случае возникновения ошибки. </para> </refsect1> <refsect1 role="examples"> diff --git a/reference/ftp/functions/ftp-mkdir.xml b/reference/ftp/functions/ftp-mkdir.xml index e3028d240..3e003dd88 100644 --- a/reference/ftp/functions/ftp-mkdir.xml +++ b/reference/ftp/functions/ftp-mkdir.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 18680fd1681731888c6fb7c530cfdb712f53e954 Maintainer: blindman Status: ready --> +<!-- EN-Revision: 7786b06044cb6ab7c471f895057fe6070f3344d9 Maintainer: blindman Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.ftp-mkdir" xmlns="http://docbook.org/ns/docbook"> @@ -48,6 +48,15 @@ в противном случае. </para> </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + <simpara> + Выдаёт ошибку уровня <constant>E_WARNING</constant>, если каталог + уже существует или соответствующие права доступа препятствуют созданию каталога. + </simpara> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para>