Skip to content

Commit 3bbd391

Browse files
kenjisMGatner
authored andcommitted
docs: add changelog and upgrading
1 parent 933bb06 commit 3bbd391

File tree

2 files changed

+28
-0
lines changed

2 files changed

+28
-0
lines changed

user_guide_src/source/changelogs/v4.2.11.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,11 +13,15 @@ SECURITY
1313
********
1414

1515
- *Attackers may spoof IP address when using proxy* was fixed. See the `Security advisory GHSA-ghw3-5qvm-3mqc <https://github.com/codeigniter4/CodeIgniter4/security/advisories/GHSA-ghw3-5qvm-3mqc>`_ for more information.
16+
- *Potential Session Handlers Vulnerability* was fixed. See the `Security advisory GHSA-6cq5-8cj7-g558 <https://github.com/codeigniter4/CodeIgniter4/security/advisories/GHSA-6cq5-8cj7-g558>`_ for more information.
1617

1718
BREAKING
1819
********
1920

2021
- The ``Config\App::$proxyIPs`` value format has been changed. See :ref:`Upgrading Guide <upgrade-4211-proxyips>`.
22+
- The key of the session data record for :ref:`sessoins-databasehandler-driver`,
23+
:ref:`sessoins-memcachedhandler-driver` and :ref:`sessoins-redishandler-driver`
24+
has changed. See :ref:`Upgrading Guide <upgrade-4211-session-key>`.
2125

2226
Bugs Fixed
2327
**********

user_guide_src/source/installation/upgrade_4211.rst

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,29 @@ The config value format has been changed. Now you must set your proxy IP address
2929

3030
``ConfigException`` will be thrown for old format config value.
3131

32+
.. _upgrade-4211-session-key:
33+
34+
Session Handler Key Changes
35+
===========================
36+
37+
The key of the session data record for :ref:`sessoins-databasehandler-driver`,
38+
:ref:`sessoins-memcachedhandler-driver` and :ref:`sessoins-redishandler-driver`
39+
has changed. Therefore, any existing session data will be invalidated after
40+
the upgrade if you are using these session handlers.
41+
42+
- When using ``DatabaseHandler``, the ``id`` column value in the session table
43+
now contains the session cookie name (``Config\App::$sessionCookieName``).
44+
- When using ``MemcachedHandler`` or ``RedisHandler``, the key value contains
45+
the session cookie name (``Config\App::$sessionCookieName``).
46+
47+
There is maximum length for the ``id`` column and Memcached key (250 bytes).
48+
If the following values exceed those maximum length, the session will not work properly.
49+
50+
- the session cookie name, delimiter, and session id (32 characters by default)
51+
when using ``DatabaseHandler``
52+
- the prefix (``ci_session``), session cookie name, delimiters, and session id
53+
when using ``MemcachedHandler``
54+
3255
Project Files
3356
*************
3457

@@ -46,3 +69,4 @@ many will be simple comments or formatting that have no effect on the runtime:
4669
* app/Config/Toolbar.php
4770
* app/Views/welcome_message.php
4871
* composer.json
72+

0 commit comments

Comments
 (0)