[DOC-CVS] [doc-en] master: Clarify purpose of $data in updateTimestamp() (#4753)

[email protected] (Lt Columbo via GitHub)
Newsgroups php.doc.cvs
Message-ID <[email protected]>
Author: Lt Columbo (lt-columbo)
Committer: GitHub (web-flow)
Pusher: lacatoire
Date: 2026-08-19T09:03:15+02:00

Commit: https://github.com/php/doc-en/commit/8ea3e0884dcec1efce3afac0e3deef0ab4506770
Raw diff: https://github.com/php/doc-en/commit/8ea3e0884dcec1efce3afac0e3deef0ab4506770.diff

Clarify purpose of $data in updateTimestamp() (#4753)

* Clarify purpose of $data in updateTimestamp()

The current documentation only says "$data — The session data" without context.

This update explains that $data contains the serialized session and may be used 
to conditionally update the session expiry. It also clarifies that most 
implementations can ignore it.

* Use simpara for the paragraph touched by this change

---------

Co-authored-by: lacatoire <[email protected]>

Changed paths:
  M  reference/session/sessionupdatetimestamphandlerinterface/updatetimestamp.xml


Diff:

diff --git a/reference/session/sessionupdatetimestamphandlerinterface/updatetimestamp.xml b/reference/session/sessionupdatetimestamphandlerinterface/updatetimestamp.xml
index 7a3245b4c6d6..04cd045a9c2f 100644
--- a/reference/session/sessionupdatetimestamphandlerinterface/updatetimestamp.xml
+++ b/reference/session/sessionupdatetimestamphandlerinterface/updatetimestamp.xml
@@ -33,9 +33,9 @@
    <varlistentry>
     <term><parameter>data</parameter></term>
     <listitem>
-     <para>
-      The session data.
-     </para>
+     <simpara>
+      The session data. The serialized session data may be used to determine whether the session data has changed and therefore should be updated.
+     </simpara>
     </listitem>
    </varlistentry>
   </variablelist>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.