Add compatibility with PHP 8.4

Author: natanfelles

src/SaveHandler.php

@@ -195,11 +195,15 @@ protected function getKeySuffix() : string
      * @param string $id The session id
      *
      * @see https://www.php.net/manual/en/sessionupdatetimestamphandlerinterface.validateid.php
+     * @see https://wiki.php.net/rfc/deprecations_php_8_4#sessionsid_length_and_sessionsid_bits_per_character
      *
      * @return bool Returns TRUE if the id is valid, otherwise FALSE
      */
     public function validateId($id) : bool
     {
+        if (\PHP_VERSION_ID >= 80400) {
+            return (bool) \preg_match('#\A[0-9a-f]{32}\z#', $id);
+        }
         $bits = \ini_get('session.sid_bits_per_character') ?: 5;
         $length = \ini_get('session.sid_length') ?: 40;
         $bitsRegex = [

src/Session.php

@@ -82,8 +82,6 @@ protected function setOptions(array $custom) : void
         $default = [
             'name' => 'session_id',
             'serialize_handler' => $serializer,
-            'sid_bits_per_character' => 6,
-            'sid_length' => 48,
             'cookie_domain' => '',
             'cookie_httponly' => 1,
             'cookie_lifetime' => 7200,
@@ -99,6 +97,10 @@ protected function setOptions(array $custom) : void
             'auto_regenerate_maxlifetime' => 0,
             'auto_regenerate_destroy' => true,
         ];
+        if (\PHP_VERSION_ID < 80400) {
+            $default['sid_bits_per_character'] = 6;
+            $default['sid_length'] = 48;
+        }
         $this->options = $custom
             ? \array_replace($default, $custom)
             : $default;

tests/SaveHandlers/AbstractHandler.php

@@ -44,12 +44,31 @@ protected function replaceConfig(array $config) : void
         $this->config = \array_replace_recursive($this->config, $config);
     }
 
+    /**
+     * @see https://wiki.php.net/rfc/deprecations_php_8_4#sessionsid_length_and_sessionsid_bits_per_character
+     */
     public function testValidateId() : void
     {
+        // Ids with PHP lower than 8.4:
         $id6 = '62my7tSXcbIrOZ-WHsEXhpwUoG,afmBQNGaSBkFN';
         $id5 = 'iimuf8lvdectatt5jtkve15831funl8rg5cg6okp';
         $id4 = '96aa2c863140e0e714a603cf44b0afc9a0632592';
         $this->session->stop();
+        /*
+         * Since PHP 8.4 session.sid_bits_per_character and session.sid_length
+         * are deprecated.
+         *
+         * - The default value for session.sid_bits_per_character is 4 (0-9, a-f).
+         * - The default value for session.sid_length is 32 character.
+         */
+        if (\PHP_VERSION_ID >= 80400) {
+            self::assertFalse($this->handler->validateId($id6));
+            self::assertFalse($this->handler->validateId($id5));
+            self::assertFalse($this->handler->validateId($id4));
+            $idPhp84 = '96aa2c863140e0e714a603cf44b0afc9';
+            self::assertTrue($this->handler->validateId($idPhp84));
+            return;
+        }
         \ini_set('session.sid_bits_per_character', '6');
         \ini_set('session.sid_length', '40');
         self::assertTrue($this->handler->validateId($id6));