com doc/ru: Обновлен ие до англи йской верси и: appendices/ini.list.xml language-snippets.e nt
reference/array/functions/extract.xml reference/dateti me/functions/date-default-timezone-set.xml reference/info/f unctions/get-magic-quotes-gpc.xml
reference/session/example s.xml reference/session/ini.xml

Commit: fbd5d3a4a556cea8a90fb9eecbe61a7273e8a372 Author: Sergey Panteleev <sergey@php.net> Sat, 16 Jan 2021 19:32:18 +0300 Parents: 416c37be21970de44aeeb2aa7708045607978654 Branches: master Link: http://git.php.net/?p=doc/ru.git;a=commitdiff;h=fbd5d3a4a556cea8a90fb9eecbe61a7273e8a372 Log: Обновление до английской версии Changed paths: M appendices/ini.list.xml M language-snippets.ent M reference/array/functions/extract.xml M reference/datetime/functions/date-default-timezone-set.xml M reference/info/functions/get-magic-quotes-gpc.xml M reference/session/examples.xml M reference/session/ini.xml

diff --git a/appendices/ini.list.xml b/appendices/ini.list.xml index 4f18f2274..309ceca23 100644 --- a/appendices/ini.list.xml +++ b/appendices/ini.list.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: d278431ef5e561787093a7b2679327a615b09367 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: f3d6ada6156b28791a28efebe2e5c070159c3a94 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: sergey --> <!-- $Revision$ --> <section xml:id="ini.list" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"> @@ -2340,22 +2340,6 @@ </row> <row> <entry> - <link linkend="ini.session.bug-compat-42">session.bug_compat_42</link> - </entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - <entry></entry> - </row> - <row> - <entry> - <link linkend="ini.session.bug-compat-warn">session.bug_compat_warn</link> - </entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - <entry></entry> - </row> - <row> - <entry> <link linkend="ini.session.cache-expire">session.cache_expire</link> </entry> <entry>"180"</entry> diff --git a/language-snippets.ent b/language-snippets.ent index b414fd625..0516a89e4 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: d278431ef5e561787093a7b2679327a615b09367 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: 4317fec7555dd42621f88162cc5068092e5c5cfb Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> @@ -344,6 +344,8 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция была <!ENTITY example.outputs.8 '<para xmlns="http://docbook.org/ns/docbook">Результат выполнения данного примера в PHP 8:</para>'> +<!ENTITY example.outputs.8.similar '<para xmlns="http://docbook.org/ns/docbook">Результат выполнения данного примера в PHP 8 аналогичен:</para>'> + <!ENTITY example.outputs.80 '<para xmlns="http://docbook.org/ns/docbook">Результат выполнения данного примера в PHP 8.0:</para>'> <!ENTITY example.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">Результат выполнения данного примера на diff --git a/reference/array/functions/extract.xml b/reference/array/functions/extract.xml index de2ac4119..b702bc5d3 100644 --- a/reference/array/functions/extract.xml +++ b/reference/array/functions/extract.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: cd943f94a013b74df8765ab8e1a620a916a64a85 Maintainer: shein Status: ready --> +<!-- EN-Revision: 4a7ddddc27271967b616ad3400cfbe2a9b48212b Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.extract" xmlns="http://docbook.org/ns/docbook"> @@ -231,10 +231,7 @@ blue, large, sphere, medium Не используйте функцию <function>extract</function> на непроверенных данных, таких как пользовательский ввод (<varname>$_GET</varname>, <varname>$_FILES</varname> и т.п.). - Если вы сделаете это, например, чтобы временно - запустить старый код, использующий - <link linkend="security.globals">register_globals</link>, - убедитесь, что используете один из флагов <parameter>flags</parameter>, + Если вы сделаете это, убедитесь, что используете один из флагов <parameter>flags</parameter>, не перезаписывающие переменные, такой как <constant>EXTR_SKIP</constant> и имейте в виду, что вы должны извлекать их в том порядке, который определён в @@ -242,90 +239,6 @@ blue, large, sphere, medium внутри <link linkend="ini">&php.ini;</link>. </para> </warning> - <note> - <para> - Если у вас всё ещё включена директива - <link linkend="security.globals">register_globals</link> - и вы используете <function>extract</function> с массивом - <varname>$_FILES</varname> и флагом - <constant>EXTR_SKIP</constant>, результат может вас удивить. - </para> - <warning> - <para> - Это нерекомендуемая практика и документирована здесь только - для полноты картины. Использование - <link linkend="security.globals">register_globals</link> считается - устаревшим и вызов <function>extract</function> на непроверенных - данных, таких как <varname>$_FILES</varname>, как уже было сказано - выше, потенциальный риск безопасности. Если вы столкнулись с - данным случаем, это означает что вы используете как минимум - две плохие практики кодирования. - </para> - </warning> - <programlisting role="php"> -<![CDATA[ -<?php - -/* Предположим, что $testfile это имя поля для загрузки файла - и что директива register_globals включена. */ - -var_dump($testfile); -extract($_FILES, EXTR_SKIP); -var_dump($testfile); -var_dump($testfile['tmp_name']); - -?> -]]> - </programlisting> - <simpara> - Вы можете ожидать что-нибудь вроде следующего: - </simpara> - <screen> -<![CDATA[ -string(14) "/tmp/phpgCCPX8" -array(5) { - ["name"]=> - string(10) "somefile.txt" - ["type"]=> - string(24) "application/octet-stream" - ["tmp_name"]=> - string(14) "/tmp/phpgCCPX8" - ["error"]=> - int(0) - ["size"]=> - int(4208) -} -string(14) "/tmp/phpgCCPX8" -]]> - </screen> - <simpara> - Однако, вместо этого вы увидите что-нибудь вроде этого: - </simpara> - <screen> -<![CDATA[ -string(14) "/tmp/phpgCCPX8" -string(14) "/tmp/phpgCCPX8" -string(1) "/" -]]> - </screen> - <para> - Это происходит потому, что так как включена директива - <link linkend="security.globals">register_globals</link>, - переменная <varname>$testfile</varname> уже существует - в глобальной области видимости в момент вызова - <function>extract</function>. А так как указан параметр - <constant>EXTR_SKIP</constant>, <varname>$testfile</varname> - не будет перезаписана содержимым массива - <constant>$_FILES</constant>, поэтому - <varname>$testfile</varname> останется строкой. - Так как <link linkend="language.types.string.substr">к строкам - можно обращаться с помощью синтаксиса массивов</link> - и нечисловая строка <literal>tmp_name</literal> интерпретируется - как <literal>0</literal>, PHP воспринимает - <varname>$testfile['tmp_name']</varname> как - <varname>$testfile[0]</varname>. - </para> - </note> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; diff --git a/reference/datetime/functions/date-default-timezone-set.xml b/reference/datetime/functions/date-default-timezone-set.xml index 36537b5f6..ddc3e45c1 100644 --- a/reference/datetime/functions/date-default-timezone-set.xml +++ b/reference/datetime/functions/date-default-timezone-set.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 34188f8256bdc6f0e6e1965c2be94247997165b6 Maintainer: tmn Status: ready --> +<!-- EN-Revision: 0a10abc50524fcbb21807b5e6ebffb3b86d45907 Maintainer: tmn Status: ready --> <!-- Reviewed: yes Maintainer: lex --> <!-- $Revision$ --> <refentry xml:id="function.date-default-timezone-set" xmlns="http://docbook.org/ns/docbook"> @@ -20,15 +20,6 @@ <function>date_default_timezone_set</function> устанавливает временную зону по умолчанию для всех функций даты/времени в скрипте. </para> - <note> - <para> - Начиная с версии PHP 5.1.0 (когда функции даты/времени были переписаны), - вызов любой функции даты/времени генерирует <constant>E_NOTICE</constant>, - если временная зона имеет неверное значение, и/или - <constant>E_WARNING</constant>, если используются системные параметры или - переменная окружения <varname>TZ</varname>. - </para> - </note> <para> Вместо использования этой функции, вы можете воспользоваться INI-настройкой <link linkend="ini.date.timezone">date.timezone</link> для установки diff --git a/reference/info/functions/get-magic-quotes-gpc.xml b/reference/info/functions/get-magic-quotes-gpc.xml index 65385f19e..a31fb9324 100644 --- a/reference/info/functions/get-magic-quotes-gpc.xml +++ b/reference/info/functions/get-magic-quotes-gpc.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 3e15d2894fb35432d2a111db36fe8ba8ebc62024 Maintainer: tmn Status: ready --> +<!-- EN-Revision: f029b664b8728bd5cbb697cb9a4409aea07cb36c Maintainer: tmn Status: ready --> <!-- Reviewed: yes Maintainer: lex --> <!-- $Revision$ --> <refentry xml:id="function.get-magic-quotes-gpc" xmlns="http://docbook.org/ns/docbook"> @@ -21,24 +21,14 @@ <void/> </methodsynopsis> <para> - Возвращает текущее значение настройки <link - linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> - </para> - <para> - Следует иметь в виду, что значение <link linkend="ini.magic-quotes-gpc"> - magic_quotes_gpc</link> нельзя изменить во время выполнения. - </para> - <para> - За дополнительной информацией обращайтесь в - <link linkend="security.magicquotes">раздел безопасности</link>. + Всегда возвращает &false;. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Возвращает 0, если magic_quotes_gpc выключен, 1 в противном случае. - С версии PHP 5.4.0 всегда возвращает &false;. + Всегда возвращает &false;. </para> </refsect1> @@ -66,38 +56,6 @@ </para> </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>Пример использования <function>get_magic_quotes_gpc</function></title> - <programlisting role="php"> -<![CDATA[ -<?php -// Если магические кавычки включены -echo $_POST['lastname']; // O\'reilly -echo addslashes($_POST['lastname']); // O\\\'reilly - -// Работает во всех версиях -if (get_magic_quotes_gpc()) { - $lastname = stripslashes($_POST['lastname']); -} -else { - $lastname = $_POST['lastname']; -} - -// при использовании MySQL -$lastname = mysql_real_escape_string($lastname); - -echo $lastname; // O\'reilly -$sql = "INSERT INTO lastnames (lastname) VALUES ('$lastname')"; -?> -]]> - </programlisting> - </example> - </para> - </refsect1> - <refsect1 role="seealso"> &reftitle.seealso; <para> @@ -111,7 +69,6 @@ $sql = "INSERT INTO lastnames (lastname) VALUES ('$lastname')"; </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/session/examples.xml b/reference/session/examples.xml index 9681b943d..f4e130339 100644 --- a/reference/session/examples.xml +++ b/reference/session/examples.xml @@ -1,8 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 95bdd6883b5dde9504701777ba81b3c5f15df52b Maintainer: aur Status: ready --> +<!-- EN-Revision: 4a7ddddc27271967b616ad3400cfbe2a9b48212b Maintainer: aur Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> - <appendix xml:id="session.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.examples; <section xml:id="session.examples.basic"> @@ -87,13 +86,6 @@ unset($_SESSION['count']); существует реального способа восстановления ссылки к другой переменной. </para> </warning> - <warning> - <para> - register_globals переопределяет переменные в глобальной области видимости, имена - которых совпадают с переменными сессии. Подробнее смотрите - <link linkend="security.globals">Использование глобальных переменных (Register Globals)</link>. - </para> - </warning> <note> <para> Сессии, использующие файлы (по умолчанию в PHP), блокируют файл сессии diff --git a/reference/session/ini.xml b/reference/session/ini.xml index 17fc05fa0..758769b1a 100644 --- a/reference/session/ini.xml +++ b/reference/session/ini.xml @@ -1,8 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: sergey Status: ready --> +<!-- EN-Revision: f3d6ada6156b28791a28efebe2e5c070159c3a94 Maintainer: sergey Status: ready --> <!-- Reviewed: no --> - <section xml:id="session.configuration" xmlns="http://docbook.org/ns/docbook"> &reftitle.runtime; &extension.runtime; @@ -241,18 +240,6 @@ <entry>PHP_INI_ALL</entry> <entry>Удалена в PHP 7.1.0</entry> </row> - <row> - <entry><link linkend="ini.session.bug-compat-42">session.bug_compat_42</link></entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - <entry>Удалена в PHP 5.4.0.</entry> - </row> - <row> - <entry><link linkend="ini.session.bug-compat-warn">session.bug_compat_warn</link></entry> - <entry>"1"</entry> - <entry>PHP_INI_ALL</entry> - <entry>Удалена в PHP 5.4.0.</entry> - </row> </tbody> </tgroup> </table> @@ -792,55 +779,6 @@ </listitem> </varlistentry> - <varlistentry xml:id="ini.session.bug-compat-42"> - <term> - <parameter>session.bug_compat_42</parameter> - <type>bool</type> - </term> - <listitem> - <simpara> - PHP версии 4.2.3 и более ранние имеют недокументированную особенность/ошибку, - позволяющую инициализировать переменную сессии как - глобальную при отключённой директиве - <link linkend="ini.register-globals">register_globals</link>. - PHP 4.3.0 и более поздние предупреждают, если используется эта особенность и - включена опция <link linkend="ini.session.bug-compat-warn"> - session.bug_compat_warn</link>. Эта особенность/ошибка - может быть отключена при отключении данной директивы. - </simpara> - <note> - <simpara> - Удалено в PHP 5.4.0. - </simpara> - </note> - </listitem> - </varlistentry> - - <varlistentry xml:id="ini.session.bug-compat-warn"> - <term> - <parameter>session.bug_compat_warn</parameter> - <type>bool</type> - </term> - <listitem> - <simpara> - PHP версии 4.2.3 и более ранние имеют недокументированную особенность/ошибку, - позволяющую инициализировать переменную сессии как - глобальную, при отключённой директиве - <link linkend="ini.register-globals">register_globals</link>. - PHP 4.3.0 и более поздние предупреждают, если используется эта особенность - при помощи включения директив - <link linkend="ini.session.bug-compat-42">session.bug_compat_42</link> - и <link linkend="ini.session.bug-compat-warn"> - session.bug_compat_warn</link>. - </simpara> - <note> - <simpara> - Удалено в PHP 5.4.0. - </simpara> - </note> - </listitem> - </varlistentry> - <varlistentry xml:id="ini.session.sid-length"> <term> <parameter>session.sid_length</parameter>