Skip to content

Commit 5879417

Browse files
committed
docs: add changelog and upgrade
1 parent 5fc2915 commit 5879417

File tree

2 files changed

+28
-0
lines changed

2 files changed

+28
-0
lines changed

user_guide_src/source/changelogs/v4.6.0.rst

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,13 @@ Time::setTimestamp()
7777
``Time::setTimestamp()`` behavior has been fixed.
7878
See :ref:`Upgrading Guide <upgrade-460-time-set-timestamp>` for details.
7979

80+
Session ID (SID)
81+
----------------
82+
83+
Now ``Session`` library forces to use the PHP default 32 character SIDs, with 4
84+
bits of entropy per character.
85+
See :ref:`Upgrading Guide <upgrade-460-sid-change>` for details.
86+
8087
.. _v460-interface-changes:
8188

8289
Interface Changes

user_guide_src/source/installation/upgrade_460.rst

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,27 @@ The following is an example of code that will no longer work:
126126

127127
.. literalinclude:: upgrade_460/001.php
128128

129+
.. _upgrade-460-sid-change:
130+
131+
Session ID (SID) Change
132+
=======================
133+
134+
Now :doc:`../libraries/sessions` forces to use the PHP default 32 character SIDs,
135+
with 4 bits of entropy per character. This change is to match the behavior of
136+
PHP 9.
137+
138+
In other words, the following settings are always used:
139+
140+
.. code-block:: ini
141+
142+
session.sid_bits_per_character = 4
143+
session.sid_length = 32
144+
145+
In previous versions, the PHP ini settings was respected. So this change may
146+
change your SID length.
147+
148+
If you cannot accept this change, customize the Session library.
149+
129150
Interface Changes
130151
=================
131152

0 commit comments

Comments
 (0)