refactor: Session guide

Author: neznaika0

user_guide_src/source/changelogs/v4.7.0.rst

@@ -72,10 +72,14 @@ Method Signature Changes
 Removed Deprecated Items
 ========================
 
-- **Text Helper:** The deprecated types in ``random_string()`` function: ``basic``, ``md5``, and ``sha1`` has been removed.
 - **BaseModel:** The deprecated method ``transformDataRowToArray()`` has been removed.
-- **CodeIgniter:** The deprecated ``CodeIgniter\CodeIgniter::resolvePlatformExtensions()`` has been removed.
 - **Cache:** The deprecated return type ``false`` for ``CodeIgniter\Cache\CacheInterface::getMetaData()`` has been replaced with ``null`` type.
+- **CodeIgniter:** The deprecated ``CodeIgniter\CodeIgniter::resolvePlatformExtensions()`` has been removed.
+- **Session:** The deprecated properties ``$sessionDriverName``, ``$sessionCookieName``,
+  ``$sessionExpiration``, ``$sessionSavePath``, ``$sessionMatchIP``,
+  ``$sessionTimeToUpdate``, and ``$sessionRegenerateDestroy`` in ``CodeIgniter\Session`` has been removed.
+- **Session:** The deprecated method ``CodeIgniter\Session::stop()`` has been removed.
+- **Text Helper:** The deprecated types in ``random_string()`` function: ``basic``, ``md5``, and ``sha1`` has been removed.
 
 ************
 Enhancements
@@ -141,7 +145,8 @@ Message Changes
 ***************
 
 - Added ``Email.invalidSMTPAuthMethod``, ``Email.failureSMTPAuthMethod``, ``CLI.signals.noPcntlExtension``, ``CLI.signals.noPosixExtension`` and ``CLI.signals.failedSignal``.
-- Deprecated ``Email.failedSMTPLogin`` and ``Image.libPathInvalid``
+- Deprecated ``Email.failedSMTPLogin`` and ``Image.libPathInvalid``.
+- Changed ``Session.missingDatabaseTable``.
 
 *******
 Changes

user_guide_src/source/libraries/sessions.rst

@@ -29,9 +29,7 @@ The ``$config`` parameter is optional - your application configuration.
 If not provided, the services register will instantiate your default
 one.
 
-Once loaded, the Sessions library object will be available using::
-
-    $session
+Once loaded, the Sessions library object will be available using ``$session``.
 
 Alternatively, you can use the helper function that will use the default
 configuration options. This version is a little friendlier to read,
@@ -118,7 +116,8 @@ Retrieving Session Data
 =======================
 
 Any piece of information from the session array is available through the
-``$_SESSION`` superglobal:
+``$_SESSION`` superglobal. For example, to assign a previously stored ``name`` item to the ``$name``
+variable, you will do this:
 
 .. literalinclude:: sessions/004.php
 
@@ -134,12 +133,6 @@ Or even through the session helper method:
 
 .. literalinclude:: sessions/007.php
 
-Where ``item`` is the array key corresponding to the item you wish to fetch.
-For example, to assign a previously stored ``name`` item to the ``$name``
-variable, you will do this:
-
-.. literalinclude:: sessions/008.php
-
 .. note:: The ``get()`` method returns null if the item you are trying
     to access does not exist.
 
@@ -191,7 +184,7 @@ Pushing New Value to Session Data
 =================================
 
 The ``push()`` method is used to push a new value onto a session value that is an array.
-For instance, if the ``hobbies`` key contains an array of hobbies, you can add a new value onto the array like so:
+For instance, if the ``hobbies`` key contains an array of hobbies, you can add a new value or replace the previous value onto the array like so:
 
 .. literalinclude:: sessions/015.php
 
@@ -402,7 +395,7 @@ All session data (including flashdata and tempdata) will be destroyed permanentl
 stop()
 ------
 
-.. deprecated:: 4.3.5
+.. important:: This method was deprecated as of version v4.3.5 and was removed in v4.7.0.
 
 The session class also has the ``stop()`` method.
 
@@ -453,7 +446,7 @@ Preference                     Default                                      Opti
 **cookieName**          ci_session                                   [A-Za-z\_-] characters only                       The name used for the session cookie.
 **expiration**          7200 (2 hours)                               Time in seconds (integer)                         The number of seconds you would like the session to last.
                                                                                                                        If you would like a non-expiring session (until browser is closed) set the value to zero: 0
-**savePath**            null                                         None                                              Specifies the storage location, depends on the driver being used.
+**savePath**            WRITEPATH . 'session'                        None                                              Specifies the storage location, depends on the driver being used.
 **matchIP**             false                                        true/false (boolean)                              Whether to validate the user's IP address when reading the session cookie.
                                                                                                                        Note that some ISPs dynamically changes the IP, so if you want a non-expiring session you
                                                                                                                        will likely set this to false.
@@ -552,6 +545,10 @@ Instead, you should do something like this, depending on your environment:
     chmod 0700 /<path to your application directory>/writable/sessions/
     chown www-data /<path to your application directory>/writable/sessions/
 
+Since the built-in mechanism does not have automatic cleaning of expired sessions,
+you will notice that the *saveDir* directory may overflow with files.
+To solve this problem, you will need to configure the **cron** or **Task Scheduler** to delete outdated files.
+
 Bonus Tip
 ---------
 
@@ -608,10 +605,10 @@ And then of course, create the database table.
 For MySQL::
 
     CREATE TABLE IF NOT EXISTS `ci_sessions` (
-        `id` varchar(128) NOT null,
-        `ip_address` varchar(45) NOT null,
-        `timestamp` timestamp DEFAULT CURRENT_TIMESTAMP NOT null,
-        `data` blob NOT null,
+        `id` varchar(128) NOT NULL,
+        `ip_address` varchar(45) NOT NULL,
+        `timestamp` timestamp DEFAULT CURRENT_TIMESTAMP NOT NULL,
+        `data` blob NOT NULL,
         KEY `ci_sessions_timestamp` (`timestamp`)
     );
 

user_guide_src/source/libraries/sessions/004.php

@@ -1,3 +1,3 @@
 <?php
 
-$item = $_SESSION['item'];
+$name = $_SESSION['name'];

user_guide_src/source/libraries/sessions/005.php

@@ -1,3 +1,3 @@
 <?php
 
-$item = $session->get('item');
+$name = $session->get('name');

user_guide_src/source/libraries/sessions/006.php

@@ -1,3 +1,3 @@
 <?php
 
-$item = $session->item;
+$name = $session->name;

user_guide_src/source/libraries/sessions/007.php

@@ -1,3 +1,3 @@
 <?php
 
-$item = session('item');
+$name = session('name');

user_guide_src/source/libraries/sessions/008.php

@@ -1,3 +1,26 @@
 <?php
 
-$session->push('hobbies', ['sport' => 'tennis']);
+/**
+ * [hobbies] => Array
+ *     (
+ *         [music] => rock
+ *         [sport] => running
+ *     )
+ */
+$session->set('hobbies', [
+    'music' => 'rock',
+    'sport' => 'running',
+]);
+
+/**
+ * [hobbies] => Array
+ *     (
+ *         [food] =>  cooking
+ *         [music] => rock
+ *         [sport] => tennis
+ *     )
+ */
+$session->push('hobbies', [
+    'food'  => 'cooking',
+    'sport' => 'tennis',
+]);

user_guide_src/source/libraries/sessions/015.php

@@ -3,12 +3,12 @@
 namespace Config;
 
 use CodeIgniter\Config\BaseConfig;
-use CodeIgniter\Session\Handlers\FileHandler;
+use CodeIgniter\Session\Handlers\DatabaseHandler;
 
 class Session extends BaseConfig
 {
     // ...
-    public string $driver = 'CodeIgniter\Session\Handlers\DatabaseHandler';
+    public string $driver = DatabaseHandler::class;
 
     // ...
     public string $savePath = 'ci_sessions';

user_guide_src/source/libraries/sessions/039.php

@@ -3,7 +3,7 @@
 namespace Config;
 
 use CodeIgniter\Config\BaseConfig;
-use CodeIgniter\Session\Handlers\FileHandler;
+use CodeIgniter\Session\Handlers\DatabaseHandler;
 
 class Session extends BaseConfig
 {