svn: /phpdoc/ru/trunk/ appendices/migration80/incompatible.xml language/functions.xml reference/session/functions/session-cache-expire.xml reference/session/functions/session-cache-limiter.xml reference/session/functions/session-create-id.xml reference/session/functions/session-encode.xml reference/session/functions/session-gc.xml reference/session/functions/session-id.xml reference/session/functions/session-module-name.xml reference/session/functions/session-name.xml reference/session/functions
[email protected] (Andrey Gromov) Mon, 30 Nov 2020 22:48:36 +0000
| Newsgroups | php.doc.ru |
|---|---|
| Message-ID | <[email protected]> |
rjhdby Mon, 30 Nov 2020 22:48:36 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=351795
Log:
upd
Changed paths:
U phpdoc/ru/trunk/appendices/migration80/incompatible.xml
U phpdoc/ru/trunk/language/functions.xml
U phpdoc/ru/trunk/reference/session/functions/session-cache-expire.xml
U phpdoc/ru/trunk/reference/session/functions/session-cache-limiter.xml
U phpdoc/ru/trunk/reference/session/functions/session-create-id.xml
U phpdoc/ru/trunk/reference/session/functions/session-encode.xml
U phpdoc/ru/trunk/reference/session/functions/session-gc.xml
U phpdoc/ru/trunk/reference/session/functions/session-id.xml
U phpdoc/ru/trunk/reference/session/functions/session-module-name.xml
U phpdoc/ru/trunk/reference/session/functions/session-name.xml
U phpdoc/ru/trunk/reference/session/functions/session-save-path.xml
U phpdoc/ru/trunk/reference/session/functions/session-set-cookie-params.xml
U phpdoc/ru/trunk/reference/session/functions/session-start.xml
U phpdoc/ru/trunk/reference/session/functions/session-status.xml
U phpdoc/ru/trunk/reference/session/sessionhandler/destroy.xml
U phpdoc/ru/trunk/reference/session/sessionhandler/gc.xml
U phpdoc/ru/trunk/reference/session/sessionhandler/open.xml
U phpdoc/ru/trunk/reference/session/sessionhandler/read.xml
U phpdoc/ru/trunk/reference/session/sessionhandler/write.xml
U phpdoc/ru/trunk/reference/session/sessionidinterface/create-sid.xml
U phpdoc/ru/trunk/reference/tidy/tidy.xml
U phpdoc/ru/trunk/reference/tidy/tidynode/getparent.xml
svn-diffs-351795.txt
(text/x-diff, 64.1 KB)
Modified: phpdoc/ru/trunk/appendices/migration80/incompatible.xml
===================================================================
--- phpdoc/ru/trunk/appendices/migration80/incompatible.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/appendices/migration80/incompatible.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 351647 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 351791 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<sect1 xml:id="migration80.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -721,8 +721,8 @@
<listitem>
<para>
<function>xml_parser_create</function> и <function>xml_parser_create_ns</function> теперь возвращают
- объект <classname>XmlParser</classname> вместо ресурса (&resource;).
- Функция <function>xml_parser_free</function> больше не имеет смысла, вместо этого экземпляр XmlParser
+ объект <classname>XMLParser</classname> вместо ресурса (&resource;).
+ Функция <function>xml_parser_free</function> больше не имеет смысла, вместо этого экземпляр XMLParser
автоматически уничтожается, если на него больше не ссылаются.
</para>
</listitem>
@@ -1291,6 +1291,13 @@
</listitem>
<listitem>
<para>
+ <methodname>SplFileObject::seek</methodname> не всегда перемещает на начало
+ строки. now always seeks to the beginning of the line.
+ Ранее, позиция <literal>=1</literal> перемещала к началу следующе строки.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
<methodname>SplHeap::compare</methodname> теперь указывает сигнатуру метода. Наследующие классы,
реализующие этот метод, теперь должны будут использовать совместимую сигнатуру метода.
</para>
Modified: phpdoc/ru/trunk/language/functions.xml
===================================================================
--- phpdoc/ru/trunk/language/functions.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/language/functions.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 351365 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 351733 Maintainer: sergey Status: ready -->
<!-- Reviewed: yes -->
<chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook">
@@ -205,6 +205,31 @@
</programlisting>
</example>
</para>
+ <para>
+ Начиная с PHP 8.0.0, список аргументов функции может содержать завершающую
+ запятую, которая будет проигнорирована. Это полезно в случае, когда список аргументов
+ очень длинный, либо если имена переменных длинны, что подталкивает к их
+ вертикальному расположению.
+ </para>
+ <example>
+ <title>Function Argument List with trailing Comma</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function takes_many_args(
+ $first_arg,
+ $second_arg,
+ $a_very_long_argument_name,
+ $arg_with_default = 5,
+ $again = 'a default string', // Эта завершающая запятая допустима только начиная с 8.0.0.
+)
+{
+ // ...
+}
+?>
+]]>
+ </programlisting>
+ </example>
<sect2 xml:id="functions.arguments.by-reference">
<title>Передача аргументов по ссылке</title>
@@ -405,14 +430,14 @@
echo sum(1, 2, 3, 4);
?>
]]>
- </programlisting>
- &example.outputs;
- <screen>
+ </programlisting>
+ &example.outputs;
+ <screen>
<![CDATA[
10
]]>
- </screen>
- </example>
+ </screen>
+ </example>
</para>
<para>
@@ -435,15 +460,15 @@
echo add(...$a);
?>
]]>
- </programlisting>
- &example.outputs;
- <screen>
+ </programlisting>
+ &example.outputs;
+ <screen>
<![CDATA[
3
3
]]>
- </screen>
- </example>
+ </screen>
+ </example>
</para>
<para>
@@ -480,15 +505,15 @@
echo total_intervals('d', null);
?>
]]>
- </programlisting>
- &example.outputs;
- <screen>
+ </programlisting>
+ &example.outputs;
+ <screen>
<![CDATA[
3 days
Catchable fatal error: Argument 2 passed to total_intervals() must be an instance of DateInterval, null given, called in - on line 14 and defined in - on line 2
]]>
- </screen>
- </example>
+ </screen>
+ </example>
</para>
<para>
@@ -771,16 +796,16 @@
</para>
<sect2 role="seealso">
- &reftitle.seealso;
- <para>
- <simplelist>
- <member><function>is_callable</function></member>
- <member><function>call_user_func</function></member>
- <member><function>function_exists</function></member>
- <member><link linkend="language.variables.variable">переменные переменные</link></member>
- </simplelist>
- </para>
- </sect2>
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>is_callable</function></member>
+ <member><function>call_user_func</function></member>
+ <member><function>function_exists</function></member>
+ <member><link linkend="language.variables.variable">переменные переменные</link></member>
+ </simplelist>
+ </para>
+ </sect2>
</sect1>
<sect1 xml:id="functions.internal">
@@ -830,18 +855,18 @@
на него нельзя полагаться.
</simpara>
</note>
-
+
<sect2 role="seealso">
- &reftitle.seealso;
- <para>
- <simplelist>
- <member><function>function_exists</function></member>
- <member><link linkend="funcref">справочник функций</link></member>
- <member><function>get_extension_funcs</function></member>
- <member><function>dl</function></member>
- </simplelist>
- </para>
- </sect2>
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>function_exists</function></member>
+ <member><link linkend="funcref">справочник функций</link></member>
+ <member><function>get_extension_funcs</function></member>
+ <member><function>dl</function></member>
+ </simplelist>
+ </para>
+ </sect2>
</sect1>
<sect1 xml:id="functions.anonymous">
@@ -968,6 +993,10 @@
]]>
</screen>
</example>
+ <para>
+ Начиная с PHP 8.0.0, список наследуюмых переменных может завершаться запятой,
+ которая будет проигнорирована.
+ </para>
<simpara>
Наследование переменных из
родительской области видимости <emphasis>не</emphasis> то же
@@ -1227,14 +1256,14 @@
var_export($fn1(3));
?>
]]>
- </programlisting>
- &example.outputs;
- <screen>
+ </programlisting>
+ &example.outputs;
+ <screen>
<![CDATA[
4
]]>
- </screen>
- </example>
+ </screen>
+ </example>
</para>
<simpara>
Это также работает во вложенных стрелочных функций:
@@ -1252,8 +1281,8 @@
var_export($fn(5)(10));
?>
]]>
- </programlisting>
- </example>
+ </programlisting>
+ </example>
</para>
<simpara>
Подобно анонимным функциям,
@@ -1278,8 +1307,8 @@
?>
]]>
- </programlisting>
- </example>
+ </programlisting>
+ </example>
</para>
<simpara>
Стрелочные функции используют привязку переменных по значению.
@@ -1304,8 +1333,8 @@
?>
]]>
- </programlisting>
- </example>
+ </programlisting>
+ </example>
</para>
<sect2 role="changelog">
Modified: phpdoc/ru/trunk/reference/session/functions/session-cache-expire.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/functions/session-cache-expire.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/functions/session-cache-expire.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 350930 Maintainer: lex Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: lex Status: ready -->
<!-- Reviewed: yes Maintainer: sergey -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id='function.session-cache-expire'>
+<refentry xml:id="function.session-cache-expire" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>session_cache_expire</refname>
<refpurpose>Получает и/или устанавливает срок действия текущего кеша</refpurpose>
@@ -12,8 +12,8 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>int</type><methodname>session_cache_expire</methodname>
- <methodparam choice="opt"><type>string</type><parameter>new_cache_expire</parameter></methodparam>
+ <type class="union"><type>int</type><type>false</type></type><methodname>session_cache_expire</methodname>
+ <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>value</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>session_cache_expire</function> возвращает текущее значение настройки
@@ -27,22 +27,22 @@
каждого запроса (и до вызова <function>session_start</function>).
</para>
</refsect1>
-
+
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
- <term><parameter>new_cache_expire</parameter></term>
+ <term><parameter>value</parameter></term>
<listitem>
<para>
- Если <parameter>new_cache_expire</parameter> задан, текущее время
- жизни заменяется на <parameter>new_cache_expire</parameter>.
+ Если <parameter>value</parameter> задан и не равен &null;, текущее время
+ жизни заменяется на <parameter>value</parameter>.
</para>
<para>
<note>
<simpara>
- Настройка <parameter>new_cache_expire</parameter> имеет значение только, если
+ Настройка <parameter>value</parameter> имеет значение только, если
для <literal>session.cache_limiter</literal> установлено значение,
<emphasis>отличное</emphasis> от <literal>nocache</literal>.
</simpara>
@@ -53,15 +53,38 @@
</variablelist>
</para>
</refsect1>
-
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает текущую настройку <literal>session.cache_expire</literal>.
- Возвращаемое значение должно рассматриваться в минутах, по умолчанию - 180.
+ Возвращаемое значение должно рассматриваться в минутах, по умолчанию - 180.
+ В случае, если изменить значение не удалось, возвращается &false;.
</para>
</refsect1>
-
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>value</parameter> может принимать значение &null;.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -92,7 +115,7 @@
</example>
</para>
</refsect1>
-
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -103,7 +126,7 @@
</simplelist>
</para>
</refsect1>
-
+
</refentry>
<!-- Keep this comment at the end of the file
Modified: phpdoc/ru/trunk/reference/session/functions/session-cache-limiter.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/functions/session-cache-limiter.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/functions/session-cache-limiter.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 334605 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-cache-limiter">
+<refentry xml:id="function.session-cache-limiter" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>session_cache_limiter</refname>
<refpurpose>Получить и/или установить текущий режим кеширования</refpurpose>
@@ -11,8 +11,8 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>session_cache_limiter</methodname>
- <methodparam choice="opt"><type>string</type><parameter>cache_limiter</parameter></methodparam>
+ <type class="union"><type>string</type><type>false</type></type><methodname>session_cache_limiter</methodname>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>value</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>session_cache_limiter</function> возвращает имя текущего режима кеширования.
@@ -49,10 +49,10 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>cache_limiter</parameter></term>
+ <term><parameter>value</parameter></term>
<listitem>
<para>
- Если <parameter>cache_limiter</parameter> указан, имя
+ Если <parameter>value</parameter> указан и не равен &null;, имя
текущего режима кеширования изменяется на новое значение.
</para>
<table>
@@ -125,9 +125,32 @@
&reftitle.returnvalues;
<para>
Возвращает имя текущего режима кеширования.
+ В случае, если изменить значение не удалось, возвращается &false;.
</para>
</refsect1>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>value</parameter> может принимать значение &null;.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<para>
Modified: phpdoc/ru/trunk/reference/session/functions/session-create-id.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/functions/session-create-id.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/functions/session-create-id.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 346848 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-create-id">
+<refentry xml:id="function.session-create-id" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>session_create_id</refname>
<refpurpose>Создаёт новый идентификатор сессии</refpurpose>
@@ -11,8 +11,8 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>session_create_id</methodname>
- <methodparam choice="opt"><type>string</type><parameter>prefix</parameter></methodparam>
+ <type class="union"><type>string</type><type>false</type></type><methodname>session_create_id</methodname>
+ <methodparam choice="opt"><type>string</type><parameter>prefix</parameter><initializer>""</initializer></methodparam>
</methodsynopsis>
<para>
<function>session_create_id</function> используется для создания нового идентификатора текущей сессии. Возвращает идентификатор сессии, который не подвержен коллизиям.
@@ -56,6 +56,7 @@
<function>session_create_id</function> возвращает новый, не подверженный
коллизиям, идентификатор текущей сессии. Если используется при неактивной
сессии, проверка на коллизии пропускается.
+ В случае неудачи возвращается &false;.
</para>
</refsect1>
Modified: phpdoc/ru/trunk/reference/session/functions/session-encode.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/functions/session-encode.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/functions/session-encode.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 339181 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-encode">
+<refentry xml:id="function.session-encode" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>session_encode</refname>
<refpurpose>Кодирует данные текущей сессии в формате строки сессии</refpurpose>
@@ -11,7 +11,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>session_encode</methodname>
+ <type class="union"><type>string</type><type>false</type></type><methodname>session_encode</methodname>
<void/>
</methodsynopsis>
<para>
@@ -28,7 +28,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Возвращает сериализованные данные текущей сессии.
+ Возвращает сериализованные данные текущей сессии, &return.falseforfailure;.
</para>
</refsect1>
Modified: phpdoc/ru/trunk/reference/session/functions/session-gc.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/functions/session-gc.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/functions/session-gc.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 342892 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-gc">
+<refentry xml:id="function.session-gc" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>session_gc</refname>
<refpurpose>Выполняет сборку мусора данных сессии</refpurpose>
@@ -11,7 +11,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>int</type><methodname>session_gc</methodname>
+ <type class="union"><type>int</type><type>false</type></type><methodname>session_gc</methodname>
<void />
</methodsynopsis>
<para>
Modified: phpdoc/ru/trunk/reference/session/functions/session-id.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/functions/session-id.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/functions/session-id.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 334621 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-id">
+<refentry xml:id="function.session-id" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>session_id</refname>
<refpurpose>Получает и/или устанавливает идентификатор текущей сессии</refpurpose>
@@ -11,8 +11,8 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>session_id</methodname>
- <methodparam choice="opt"><type>string</type><parameter>id</parameter></methodparam>
+ <type class="union"><type>string</type><type>false</type></type><methodname>session_id</methodname>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>id</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>session_id</function> используется для получения или установки
@@ -25,7 +25,7 @@
с сессиями</link>.
</para>
</refsect1>
-
+
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@@ -32,30 +32,30 @@
<variablelist>
<varlistentry>
<term><parameter>id</parameter></term>
- <listitem>
- <para>
- Если указан параметр <parameter>id</parameter>, то он заменит идентификатор
- текущий сессии. Для этого <function>session_id</function> следует вызывать
- до <function>session_start</function>. В зависимости от обработчика сессии,
- не все символы возможно использовать в идентификаторе
- сессии. Например, файловый обработчик сессии поддерживает только символы из
- диапазона <literal>a-z A-Z 0-9 , (запятая)</literal> и <literal>- (минус)</literal>!
- </para>
- <note>
- <simpara>
- При использовании сессионных cookie, указание <parameter>id</parameter>
- для <function>session_id</function> приводит к тому, что при вызове
- <function>session_start</function> всегда будут отправлены новые cookie,
- независимо от того, совпадает ли идентификатор текущей сессии с вновь
- установленным.
- </simpara>
- </note>
- </listitem>
- </varlistentry>
+ <listitem>
+ <para>
+ Если указан параметр <parameter>id</parameter> и он не равен &null;, то он заменит идентификатор
+ текущий сессии. Для этого <function>session_id</function> следует вызывать
+ до <function>session_start</function>. В зависимости от обработчика сессии,
+ не все символы возможно использовать в идентификаторе
+ сессии. Например, файловый обработчик сессии поддерживает только символы из
+ диапазона <literal>a-z A-Z 0-9 , (запятая)</literal> и <literal>- (минус)</literal>!
+ </para>
+ <note>
+ <simpara>
+ При использовании сессионных cookie, указание <parameter>id</parameter>
+ для <function>session_id</function> приводит к тому, что при вызове
+ <function>session_start</function> всегда будут отправлены новые cookie,
+ независимо от того, совпадает ли идентификатор текущей сессии с вновь
+ установленным.
+ </simpara>
+ </note>
+ </listitem>
+ </varlistentry>
</variablelist>
</para>
</refsect1>
-
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
@@ -62,10 +62,33 @@
<function>session_id</function> возвращает идентификатор текущей сессии
или пустую строку (<literal>""</literal>), если нет текущей сессии
(идентификатор текущей сессии не существует).
+ В случае неудачи возвращает &false;.
</para>
</refsect1>
-
-<refsect1 role="seealso">
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>id</parameter> теперь может быть &null;.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
+
+ <refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
Modified: phpdoc/ru/trunk/reference/session/functions/session-module-name.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/functions/session-module-name.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/functions/session-module-name.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 347994 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: mch Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-module-name">
+<refentry xml:id="function.session-module-name" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>session_module_name</refname>
<refpurpose>Возвращает и/или устанавливает модуль текущей сессии</refpurpose>
@@ -11,8 +11,8 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>session_module_name</methodname>
- <methodparam choice="opt"><type>string</type><parameter>module</parameter></methodparam>
+ <type class="union"><type>string</type><type>false</type></type><methodname>session_module_name</methodname>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>module</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>session_module_name</function> возвращает название текущего
@@ -29,7 +29,7 @@
<term><parameter>module</parameter></term>
<listitem>
<para>
- Если указан параметр <parameter>module</parameter>, данный модуль будет
+ Если указан параметр <parameter>module</parameter> и не равен &null;, данный модуль будет
использован вместо текущего.
Передача значения <literal>"user"</literal> в этот параметр запрещена. Вместо этого
должна вызываться функция <function>session_set_save_handler</function> для установки
@@ -44,31 +44,37 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Возвращает название текущего модуля сессии.
+ Возвращает название текущего модуля сессии, &return.falseforfailure;.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
- <informaltable>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>&Version;</entry>
- <entry>&Description;</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>7.2.0</entry>
- <entry>
- В данный момент запрещено устанавливать имя модуля на значение
- <literal>"user"</literal>. Ранее это игнорировалось.
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>module</parameter> теперь может быть &null;.
+ </entry>
+ </row>
+ <row>
+ <entry>7.2.0</entry>
+ <entry>
+ В данный момент запрещено устанавливать имя модуля на значение
+ <literal>"user"</literal>. Ранее это игнорировалось.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
</refsect1>
</refentry>
Modified: phpdoc/ru/trunk/reference/session/functions/session-name.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/functions/session-name.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/functions/session-name.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 345196 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351762 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-name">
+<refentry xml:id="function.session-name" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>session_name</refname>
<refpurpose>Получить или установить имя текущей сессии</refpurpose>
@@ -12,8 +12,8 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>session_name</methodname>
- <methodparam choice="opt"><type>string</type><parameter>name</parameter></methodparam>
+ <type class="union"><type>string</type><type>false</type></type><methodname>session_name</methodname>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>name</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>session_name</function> возвращает имя текущей
@@ -49,7 +49,7 @@
используется в cookie и URL (например, <literal> PHPSESSID </literal>). Оно
должно содержать только буквенно-цифровые символы, и должен быть коротким и
понятными (например, для пользователей с включенным предупреждением cookie).
- Если задан параметр <parameter>name</parameter>, имя текущей
+ Если задан параметр <parameter>name</parameter> и он не равен &null;, имя текущей
сессии поменяется на него.
</para>
<para>
@@ -71,7 +71,7 @@
&reftitle.returnvalues;
<para>
Возвращает имя текущей сессии. Если задан параметр <parameter>name</parameter>, имя
- текущей сессии поменяется и будет возвращено <emphasis>старое</emphasis>.
+ текущей сессии поменяется и будет возвращено <emphasis>старое</emphasis>, &return.falseforfailure;.
</para>
</refsect1>
@@ -109,6 +109,12 @@
</thead>
<tbody>
<row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>module</parameter> теперь может быть &null;.
+ </entry>
+ </row>
+ <row>
<entry>7.2.0</entry>
<entry>
<function>session_name</function> проверяет статус сессии,
Modified: phpdoc/ru/trunk/reference/session/functions/session-save-path.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/functions/session-save-path.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/functions/session-save-path.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-save-path">
+<refentry xml:id="function.session-save-path" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>session_save_path</refname>
<refpurpose>Получает и/или устанавливает путь сохранения сессии</refpurpose>
@@ -12,8 +12,8 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>session_save_path</methodname>
- <methodparam choice="opt"><type>string</type><parameter>path</parameter></methodparam>
+ <type class="union"><type>string</type><type>false</type></type><methodname>session_save_path</methodname>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>path</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>session_save_path</function> возвращает путь текущей директории,
@@ -29,7 +29,7 @@
<term><parameter>path</parameter></term>
<listitem>
<para>
- Путь для данных сессии. Если указан, то путь, куда сохраняются данные,
+ Путь для данных сессии. Если указан и не равен &null;, то путь, куда сохраняются данные,
будет изменён. Для этой цели <function>session_save_path</function>
следует вызывать перед <function>session_start</function>.
</para>
@@ -51,10 +51,32 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- Возвращает путь текущей директории, используемой для хранения данных сессии.
+ Возвращает путь текущей директории, используемой для хранения данных сессии, &return.falseforfailure;.
</para>
</refsect1>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>path</parameter> теперь может быть &null;.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
Modified: phpdoc/ru/trunk/reference/session/functions/session-set-cookie-params.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/functions/session-set-cookie-params.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/functions/session-set-cookie-params.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 350654 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-set-cookie-params">
+<refentry xml:id="function.session-set-cookie-params" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>session_set_cookie_params</refname>
<refpurpose>Устанавливает параметры сессионной cookie</refpurpose>
@@ -11,14 +11,18 @@
<refsect1 role="description">
&reftitle.description;
- <methodsynopsis role="procedural">
+ <methodsynopsis>
<type>bool</type><methodname>session_set_cookie_params</methodname>
- <methodparam><type>int</type><parameter>lifetime</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>path</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>domain</parameter></methodparam>
- <methodparam choice="opt"><type>bool</type><parameter>secure</parameter><initializer>&false;</initializer></methodparam>
- <methodparam choice="opt"><type>bool</type><parameter>httponly</parameter><initializer>&false;</initializer></methodparam>
+ <methodparam><type>int</type><parameter>lifetime_or_options</parameter></methodparam>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>path</parameter><initializer>&null;</initializer></methodparam>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>domain</parameter><initializer>&null;</initializer></methodparam>
+ <methodparam choice="opt"><type class="union"><type>bool</type><type>null</type></type><parameter>secure</parameter><initializer>&null;</initializer></methodparam>
+ <methodparam choice="opt"><type class="union"><type>bool</type><type>null</type></type><parameter>httponly</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
+ <methodsynopsis>
+ <type>bool</type><methodname>session_set_cookie_params</methodname>
+ <methodparam><type>array</type><parameter>lifetime_or_options</parameter></methodparam>
+ </methodsynopsis>
<methodsynopsis role="procedural">
<type>bool</type><methodname>session_set_cookie_params</methodname>
<methodparam><type>array</type><parameter>options</parameter></methodparam>
@@ -40,12 +44,22 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>lifetime</parameter></term>
+ <term><parameter>lifetime_or_options</parameter></term>
<listitem>
<para>
- <link linkend="ini.session.cookie-lifetime">Время жизни</link>
- сессионной cookie в секундах.
+ Если использовать первую сигнатуры, <link linkend="ini.session.cookie-lifetime">время жизни</link> сессионной куки, заданное в секундах.
</para>
+ <para>
+ Если использовать вторую сигнатуру, то
+ ассоциативный массив (<type>array</type>), который может иметь любое из ключей
+ <literal>lifetime</literal>, <literal>path</literal>, <literal>domain</literal>,
+ <literal>secure</literal>, <literal>httponly</literal> и <literal>samesite</literal>.
+ Значения имеют тот же смысл, как описано в параметрах с соответсвующим именем.
+ Значение элемента <literal>samesite</literal> должно быть либо <literal>Lax</literal>, либо <literal>Strict</literal>.
+ Если какая-либо из допустимых опций не указана, ее значения по умолчанию
+ совпадают с значениями по умолчанию для явных параметров.
+ Если элемент <literal>samesite</literal> не указан, cookie-атрибут SameSite не установлен.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
@@ -87,21 +101,6 @@
</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term><parameter>options</parameter></term>
- <listitem>
- <para>
- Ассоциативный массив (<type>array</type>), который может иметь любое из ключей
- <literal>lifetime</literal>, <literal>path</literal>, <literal>domain</literal>,
- <literal>secure</literal>, <literal>httponly</literal> и <literal>samesite</literal>.
- Значения имеют тот же смысл, как описано в параметрах с соответсвующим именем.
- Значение элемента <literal>samesite</literal> должно быть либо <literal>Lax</literal>, либо <literal>Strict</literal>.
- Если какая-либо из допустимых опций не указана, ее значения по умолчанию
- совпадают с значениями по умолчанию для явных параметров.
- Если элемент <literal>samesite</literal> не указан, cookie-атрибут SameSite не установлен.
- </para>
- </listitem>
- </varlistentry>
</variablelist>
</para>
</refsect1>
@@ -126,9 +125,16 @@
</thead>
<tbody>
<row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>path</parameter>, <parameter>domain</parameter>,
+ <parameter>secure</parameter> и <parameter>httponly</parameter> теперь могут быть &null;.
+ </entry>
+ </row>
+ <row>
<entry>7.3.0</entry>
<entry>
- Добавлена альтернативная подпись, поддерживающая массив опций <parameter>options</parameter>.
+ Добавлена альтернативная подпись, поддерживающая массив опций <parameter>lifetime_or_options</parameter>.
Эта подпись поддерживает также настройку cookie-атрибута SameSite.
</entry>
</row>
Modified: phpdoc/ru/trunk/reference/session/functions/session-start.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/functions/session-start.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/functions/session-start.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 350655 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-start">
+<refentry xml:id="function.session-start" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>session_start</refname>
<refpurpose>Стартует новую сессию, либо возобновляет существующую</refpurpose>
@@ -12,7 +12,7 @@
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>session_start</methodname>
- <methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>array()</initializer></methodparam>
+ <methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam>
</methodsynopsis>
<para>
Функция <function>session_start</function> создает сессию, либо возобновляет
Modified: phpdoc/ru/trunk/reference/session/functions/session-status.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/functions/session-status.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/functions/session-status.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 320272 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: mch Status: ready -->
<!-- Reviewed: yes Maintainer: lex -->
<refentry xml:id="function.session-status" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -8,18 +8,18 @@
<refname>session_status</refname>
<refpurpose>Возвращает состояние текущей сессии</refpurpose>
</refnamediv>
-
+
<refsect1 role="description"><!-- {{{ -->
&reftitle.description;
- <methodsynopsis role="procedural">
+ <methodsynopsis>
<type>int</type><methodname>session_status</methodname>
- <void />
+ <void/>
</methodsynopsis>
<para>
Функция <function>session_status</function> возвращает состояние текущей сессии.
</para>
</refsect1><!-- }}} -->
-
+
<refsect1 role="returnvalues"><!-- {{{ -->
&reftitle.returnvalues;
<para>
@@ -43,7 +43,7 @@
<member><function>session_start</function></member>
</simplelist>
</refsect1><!-- }}} -->
-
+
</refentry>
<!-- Keep this comment at the end of the file
Modified: phpdoc/ru/trunk/reference/session/sessionhandler/destroy.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/sessionhandler/destroy.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/sessionhandler/destroy.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 349708 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xml:id="sessionhandler.destroy" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -7,12 +7,12 @@
<refname>SessionHandler::destroy</refname>
<refpurpose>Уничтожает сессию</refpurpose>
</refnamediv>
-
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <modifier>public</modifier> <type>bool</type><methodname>SessionHandler::destroy</methodname>
- <methodparam><type>string</type><parameter>session_id</parameter></methodparam>
+ <modifier>public</modifier> <type>bool</type><methodname>SessionHandler::destroy</methodname>
+ <methodparam><type>string</type><parameter>id</parameter></methodparam>
</methodsynopsis>
<para>
Уничтожает сессию. Вызвается изнутри PHP посредством функции
@@ -35,13 +35,13 @@
Для дополнительной информации см. руководство по функции <function>SessionHandlerInterface::destroy</function>.
</para>
</refsect1>
-
+
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
- <term><parameter>session_id</parameter></term>
+ <term><parameter>id</parameter></term>
<listitem>
<para>
Идентификатор уничтожаемой сессии.
@@ -51,7 +51,7 @@
</variablelist>
</para>
</refsect1>
-
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
@@ -58,8 +58,8 @@
&returns.session.storage.retval;
</para>
</refsect1>
-
-
+
+
</refentry>
<!-- Keep this comment at the end of the file
Modified: phpdoc/ru/trunk/reference/session/sessionhandler/gc.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/sessionhandler/gc.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/sessionhandler/gc.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 349708 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xml:id="sessionhandler.gc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -7,12 +7,12 @@
<refname>SessionHandler::gc</refname>
<refpurpose>Очищает старые сессии</refpurpose>
</refnamediv>
-
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <modifier>public</modifier> <type>int</type><methodname>SessionHandler::gc</methodname>
- <methodparam><type>int</type><parameter>maxlifetime</parameter></methodparam>
+ <modifier>public</modifier> <type class="union"><type>int</type><type>bool</type></type><methodname>SessionHandler::gc</methodname>
+ <methodparam><type>int</type><parameter>max_lifetime</parameter></methodparam>
</methodsynopsis>
<para>
Очищает сессии с истекшим сроком жизни. Вызывается случайным образом изнутри PHP
@@ -37,29 +37,51 @@
см. документацию по методу <function>SessionHandlerInterface::gc</function>.
</para>
</refsect1>
-
+
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
- <term><parameter>maxlifetime</parameter></term>
+ <term><parameter>max_lifetime</parameter></term>
<listitem>
<para>
- Сессии, которые не были обновлены в течение последних <parameter>maxlifetime</parameter> секунд удаляются.
+ Сессии, которые не были обновлены в течение последних <parameter>max_lifetime</parameter> секунд удаляются.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
-
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- &returns.session.storage.retval;
+ В случае успеха возвращает количество удалённых сессий, &return.falseforfailure;.
+ Обратите внимание, что это значение возвращается внутррь PHP для обработки.
</para>
</refsect1>
-
-
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>7.1.0</entry>
+ <entry>
+ До этой версии, в случае успеха эта функция возвращала &true;.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
+
</refentry>
<!-- Keep this comment at the end of the file
Modified: phpdoc/ru/trunk/reference/session/sessionhandler/open.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/sessionhandler/open.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/sessionhandler/open.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 349708 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xml:id="sessionhandler.open" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -7,13 +7,13 @@
<refname>SessionHandler::open</refname>
<refpurpose>Инициализирует сессию</refpurpose>
</refnamediv>
-
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>bool</type><methodname>SessionHandler::open</methodname>
- <methodparam><type>string</type><parameter>save_path</parameter></methodparam>
- <methodparam><type>string</type><parameter>session_name</parameter></methodparam>
+ <methodparam><type>string</type><parameter>path</parameter></methodparam>
+ <methodparam><type>string</type><parameter>name</parameter></methodparam>
</methodsynopsis>
<para>
Создает новую сессию или повторно инициализирует существующую. Вызывается изнутри
@@ -34,12 +34,12 @@
см. документацию по методу <function>SessionHandlerInterface::open</function>.
</para>
</refsect1>
-
+
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
- <term><parameter>save_path</parameter></term>
+ <term><parameter>path</parameter></term>
<listitem>
<para>
Путь по которому сохраняется/восстанавливается сессия.
@@ -47,7 +47,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>session_name</parameter></term>
+ <term><parameter>name</parameter></term>
<listitem>
<para>
Название сессии.
@@ -56,7 +56,7 @@
</varlistentry>
</variablelist>
</refsect1>
-
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
@@ -63,7 +63,7 @@
&returns.session.storage.retval;
</para>
</refsect1>
-
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -74,8 +74,8 @@
</simplelist>
</para>
</refsect1>
-
-
+
+
</refentry>
<!-- Keep this comment at the end of the file
Modified: phpdoc/ru/trunk/reference/session/sessionhandler/read.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/sessionhandler/read.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/sessionhandler/read.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 349708 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="sessionhandler.read" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -13,7 +13,7 @@
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>string</type><methodname>SessionHandler::read</methodname>
- <methodparam><type>string</type><parameter>session_id</parameter></methodparam>
+ <methodparam><type>string</type><parameter>id</parameter></methodparam>
</methodsynopsis>
<para>
Считывает данные сессии из хранилища и возвращает результат обратно в PHP для
@@ -42,7 +42,7 @@
&reftitle.parameters;
<variablelist>
<varlistentry>
- <term><parameter>session_id</parameter></term>
+ <term><parameter>id</parameter></term>
<listitem>
<para>
Идентификатор сессии, из которой необходимо считать данные.
Modified: phpdoc/ru/trunk/reference/session/sessionhandler/write.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/sessionhandler/write.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/sessionhandler/write.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 349708 Maintainer: lex Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: lex Status: ready -->
<!-- Reviewed: yes Maintainer: sergey -->
<refentry xml:id="sessionhandler.write" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -8,13 +8,13 @@
<refname>SessionHandler::write</refname>
<refpurpose>Записывает данные сессии</refpurpose>
</refnamediv>
-
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>bool</type><methodname>SessionHandler::write</methodname>
- <methodparam><type>string</type><parameter>session_id</parameter></methodparam>
- <methodparam><type>string</type><parameter>session_data</parameter></methodparam>
+ <methodparam><type>string</type><parameter>id</parameter></methodparam>
+ <methodparam><type>string</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
Записывает данные сессии в хранилище. Обычно вызывается при завершении скрипта, функцией
@@ -30,14 +30,14 @@
<para>
Для дополнительной информации смотрите документацию по методу <function>SessionHandlerInterface::write</function>.
</para>
-
+
</refsect1>
-
+
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
- <term><parameter>session_id</parameter></term>
+ <term><parameter>id</parameter></term>
<listitem>
<para>
Идентификатор сессии.
@@ -45,7 +45,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>session_data</parameter></term>
+ <term><parameter>data</parameter></term>
<listitem>
<para>
Зашифрованные данные сессии. Эти данные являются результатом того, что PHP внутренне шифрует суперглобальную переменную <varname>$_SESSION</varname> в сериализированную
@@ -55,7 +55,7 @@
</varlistentry>
</variablelist>
</refsect1>
-
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
@@ -62,7 +62,7 @@
&returns.session.storage.retval;
</para>
</refsect1>
-
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -73,8 +73,8 @@
</simplelist>
</para>
</refsect1>
-
-
+
+
</refentry>
<!-- Keep this comment at the end of the file
Modified: phpdoc/ru/trunk/reference/session/sessionidinterface/create-sid.xml
===================================================================
--- phpdoc/ru/trunk/reference/session/sessionidinterface/create-sid.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/session/sessionidinterface/create-sid.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 350221 Maintainer: lex Status: ready -->
+<!-- EN-Revision: 351750 Maintainer: lex Status: ready -->
<!-- Reviewed: yes Maintainer: sergey -->
<refentry xml:id="sessionidinterface.create-sid" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -8,12 +8,12 @@
<refname>SessionIdInterface::create_sid</refname>
<refpurpose>Создать идентификатор сессии</refpurpose>
</refnamediv>
-
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>abstract</modifier> <modifier>public</modifier> <type>string</type><methodname>SessionIdInterface::create_sid</methodname>
- <void />
+ <void/>
</methodsynopsis>
<para>
Создает новый идентификатор сессии. Функция автоматически выполняется, когда необходимо создать
@@ -20,12 +20,12 @@
новый идентификатор сессии.
</para>
</refsect1>
-
+
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
-
+
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
@@ -33,7 +33,7 @@
Обратите внимание, что это значение возвращается внутри PHP для обработки.
</para>
</refsect1>
-
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -42,7 +42,7 @@
</simplelist>
</para>
</refsect1>
-
+
</refentry>
<!-- Keep this comment at the end of the file
Modified: phpdoc/ru/trunk/reference/tidy/tidy.xml
===================================================================
--- phpdoc/ru/trunk/reference/tidy/tidy.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/tidy/tidy.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 322012 Maintainer: aur Status: ready -->
+<!-- EN-Revision: 351752 Maintainer: aur Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.tidy" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -7,8 +7,8 @@
<titleabbrev>tidy</titleabbrev>
<partintro>
-
-<!-- {{{ tidy intro -->
+
+ <!-- {{{ tidy intro -->
<section xml:id="tidy.intro">
&reftitle.intro;
<para>
@@ -15,34 +15,37 @@
HTML-узел в HTML-файле, обнаруженный Tidy.
</para>
</section>
-<!-- }}} -->
-
+ <!-- }}} -->
+
<section xml:id="tidy.synopsis">
&reftitle.classsynopsis;
-
-<!-- {{{ Synopsis -->
+
+ <!-- {{{ Synopsis -->
<classsynopsis>
<ooclass><classname>tidy</classname></ooclass>
-
-<!-- {{{ Class synopsis -->
+
+ <!-- {{{ Class synopsis -->
<classsynopsisinfo>
<ooclass>
<classname>tidy</classname>
</ooclass>
</classsynopsisinfo>
-<!-- }}} -->
+ <!-- }}} -->
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.tidy')/db:refentry/db:refsect1[@role='description']/descendant::db:fieldsynopsis[1])" />
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.tidy')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])">
+ <xi:fallback />
+ </xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.tidy')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')][1])" />
</classsynopsis>
-<!-- }}} -->
-
+ <!-- }}} -->
+
</section>
-
-<!--
+
+ <!--
<para>
<informaltable>
<tgroup cols="2">
@@ -64,11 +67,11 @@
</para>
-->
</partintro>
-
+
&reference.tidy.entities.tidy;
+
+</phpdoc:classref>
-</phpdoc:classref>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ru/trunk/reference/tidy/tidynode/getparent.xml
===================================================================
--- phpdoc/ru/trunk/reference/tidy/tidynode/getparent.xml 2020-11-30 22:27:10 UTC (rev 351794)
+++ phpdoc/ru/trunk/reference/tidy/tidynode/getparent.xml 2020-11-30 22:48:36 UTC (rev 351795)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 345872 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 351754 Maintainer: mch Status: ready -->
<!-- $Revision$ -->
<!-- Reviewed: yes Maintainer: sergey -->
<refentry xml:id="tidynode.getparent" xmlns="http://docbook.org/ns/docbook">
@@ -7,11 +7,11 @@
<refname>tidyNode::getParent</refname>
<refpurpose>Возвращает родительский узел текущего узла</refpurpose>
</refnamediv>
-
+
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <modifier>public</modifier> <type>tidyNode</type><methodname>tidyNode::getParent</methodname>
+ <modifier>public</modifier> <type class="union"><type>tidyNode</type><type>null</type></type><methodname>tidyNode::getParent</methodname>
<void/>
</methodsynopsis>
<para>
@@ -18,7 +18,15 @@
Возвращает родительский узел текущего узла.
</para>
</refsect1>
-
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Возвращает объект <type>tidyNode</type>, если узел имеет родителя,
+ в противном случае возвращает &null;.
+ </para>
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -62,15 +70,7 @@
</example>
</para>
</refsect1>
-
- <refsect1 role="returnvalues">
- &reftitle.returnvalues;
- <para>
- Возвращает объект <type>tidyNode</type>, если узел имеет родителя,
- в противном случае возвращает &null;.
- </para>
- </refsect1>
-
+
</refentry>
<!-- Keep this comment at the end of the file