Skip to content

Commit 703c273

Browse files
committed
docs: add changelog and upgrade
1 parent 12385ed commit 703c273

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
@@ -90,6 +90,13 @@ environment, this behavior has been fixed so that error details are displayed if
9090
With this fix, the error details are now displayed under the same conditions for
9191
both HTML requests and non-HTML requests.
9292

93+
Session ID (SID)
94+
----------------
95+
96+
Now ``Session`` library forces to use the PHP default 32 character SIDs, with 4
97+
bits of entropy per character.
98+
See :ref:`Upgrading Guide <upgrade-460-sid-change>` for details.
99+
93100
.. _v460-interface-changes:
94101

95102
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)