Skip to content

Commit

Permalink
Update session-id.xml уточнил перевод, исправил инфостиль
Browse files Browse the repository at this point in the history
  • Loading branch information
mmalferov committed Aug 6, 2024
1 parent 8a71f34 commit cc0b552
Showing 1 changed file with 25 additions and 23 deletions.
48 changes: 25 additions & 23 deletions reference/session/functions/session-id.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<refentry xml:id="function.session-id" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>session_id</refname>
<refpurpose>Получает и/или устанавливает идентификатор текущей сессии</refpurpose>
<refpurpose>Получает и (или) устанавливает идентификатор текущей сессии</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
Expand All @@ -14,14 +14,14 @@
<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> используется для получения или установки
идентификатора текущей сессии.
Функция <function>session_id</function> получает или устанавливает
идентификатор текущей сессии.
</para>
<para>
Константа <constant>SID</constant> также может быть использована
для получения текущего имени и идентификатора сессии в виде строки,
подходящей для добавления в URL-адреса. Смотрите также <link linkend="ref.session">Работа
с сессиями</link>.
Текущее имя и идентификатор сессии в виде строки,
которую можно добавлять в URL-адреса, также получают через константу <constant>SID</constant>.
Дополнительную информацию об обработке сессий
даёт раздел «<link linkend="ref.session">Функции для работы с сессиями</link>».
</para>
</refsect1>

Expand All @@ -33,20 +33,22 @@
<term><parameter>id</parameter></term>
<listitem>
<para>
Если указан параметр <parameter>id</parameter> и он не равен &null;, то он заменит идентификатор
текущий сессии. Для этого <function>session_id</function> следует вызывать
до <function>session_start</function>. В зависимости от обработчика сессии,
не все символы возможно использовать в идентификаторе
сессии. Например, файловый обработчик сессии поддерживает только символы из
диапазона <literal>a-z A-Z 0-9 , (запятая)</literal> и <literal>- (минус)</literal>!
Аргумент, который передали в параметр <parameter>id</parameter>,
заменит идентификатор текущий сессии, если значение аргумента не равно &null;.
Для этого функцию <function>session_id</function> вызывают
перед вызовом функции <function>session_start</function>. Набор символов, которые
разрешается указывать в идентификаторе сессии, зависит от обработчика сессии.
Например, обработчик файлов сессий поддерживает только символы
из диапазона <literal>[a-zA-Z0-9,-]</literal>.
</para>
<note>
<simpara>
При использовании сессионных cookie, указание <parameter>id</parameter>
для <function>session_id</function> приводит к тому, что при вызове
<function>session_start</function> всегда будут отправлены новые cookie,
независимо от того, совпадает ли идентификатор текущей сессии с вновь
установленным.
Функция <function>session_start</function> будет отправлять новый блок данных cookie
при каждом вызове,
если в файле конфигурации включили сессионные cookies и вызвали функцию <function>session_id</function>
с параметром <parameter>id</parameter>,
независимо от того, совпадает ли идентификатор текущей сессии с тем, который
устанавливает функция.
</simpara>
</note>
</listitem>
Expand All @@ -58,10 +60,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<function>session_id</function> возвращает идентификатор текущей сессии
или пустую строку (<literal>""</literal>), если нет текущей сессии
(идентификатор текущей сессии не существует).
В случае неудачи возвращает &false;.
Функция <function>session_id</function> возвращает идентификатор текущей сессии
или пустую строку <literal>""</literal>, если текущей сессии нет —
идентификатор текущей сессии не существует.
Функция возвращает &false;, если возникла ошибка.
</para>
</refsect1>

Expand All @@ -79,7 +81,7 @@
<row>
<entry>8.0.0</entry>
<entry>
<parameter>id</parameter> теперь может быть &null;.
Параметр <parameter>id</parameter> теперь принимает значение &null;.
</entry>
</row>
</tbody>
Expand Down

0 comments on commit cc0b552

Please sign in to comment.