fix: throw exception for unsupported DB drivers in session (#9574)

Author: michalsn

system/Config/Services.php

@@ -683,6 +683,11 @@ public static function session(?SessionConfig $config = null, bool $getShared =
                 $driverName = MySQLiHandler::class;
             } elseif ($driverPlatform === 'Postgre') {
                 $driverName = PostgreHandler::class;
+            } else {
+                throw new InvalidArgumentException(sprintf(
+                    'Invalid session database handler "%s" provided. Only "MySQLi" and "Postgre" are supported.',
+                    $driverPlatform,
+                ));
             }
         }
 

tests/system/Config/ServicesTest.php

@@ -36,6 +36,7 @@
 use CodeIgniter\Router\RouteCollection;
 use CodeIgniter\Router\Router;
 use CodeIgniter\Security\Security;
+use CodeIgniter\Session\Handlers\DatabaseHandler;
 use CodeIgniter\Session\Session;
 use CodeIgniter\Test\CIUnitTestCase;
 use CodeIgniter\Test\Mock\MockResponse;
@@ -46,6 +47,7 @@
 use CodeIgniter\View\Cell;
 use CodeIgniter\View\Parser;
 use Config\App;
+use Config\Database as DatabaseConfig;
 use Config\Exceptions;
 use Config\Security as SecurityConfig;
 use Config\Session as ConfigSession;
@@ -275,6 +277,25 @@ public function testNewSessionWithInvalidHandler(string $driver): void
         Services::session($config, false);
     }
 
+    #[PreserveGlobalState(false)]
+    #[RunInSeparateProcess]
+    public function testNewSessionWithInvalidDatabaseHandler(): void
+    {
+        $driver = config(DatabaseConfig::class)->tests['DBDriver'];
+
+        if (in_array($driver, ['MySQLi', 'Postgre'], true)) {
+            $this->markTestSkipped('This test case does not work with MySQLi and Postgre');
+        }
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage(sprintf('Invalid session database handler "%s" provided. Only "MySQLi" and "Postgre" are supported.', $driver));
+
+        $config = new ConfigSession();
+
+        $config->driver = DatabaseHandler::class;
+        Services::session($config, false);
+    }
+
     /**
      * @return iterable<string, array{0: string}>
      */

user_guide_src/source/changelogs/v4.6.2.rst

@@ -37,6 +37,7 @@ Bugs Fixed
 
 - **Database:** Fixed a bug where ``when()`` and ``whenNot()`` in ``ConditionalTrait`` incorrectly evaluated certain falsy values (such as ``[]``, ``0``, ``0.0``, and ``'0'``) as truthy, causing callbacks to be executed unexpectedly. These methods now cast the condition to a boolean using ``(bool)`` to ensure consistent behavior with PHP's native truthiness.
 - **Security:** Fixed a bug where the ``sanitize_filename()`` function from the Security helper would throw an error when used in CLI requests.
+- **Session:** Fixed a bug where using the ``DatabaseHandler`` with an unsupported database driver (such as ``SQLSRV``, ``OCI8``, or ``SQLite3``) did not throw an appropriate error.
 
 See the repo's
 `CHANGELOG.md <https://github.com/codeigniter4/CodeIgniter4/blob/develop/CHANGELOG.md>`_