Deprecate support for deprecated PHP session options

Author: mbabker

composer.json

@@ -15,6 +15,7 @@
         "ratchet/rfc6455": "^0.3.1",
         "react/event-loop": "^1.3",
         "react/socket": "^1.11",
+        "symfony/deprecation-contracts": "^2.5 || ^3.0",
         "symfony/http-foundation": "^6.4 || ^7.1",
         "symfony/routing": "^6.4 || ^7.1"
     },

src/Session/Storage/ReadOnlyNativeSessionStorage.php

@@ -187,7 +187,7 @@ public function isStarted(): bool
      *
      * @see NativeSessionStorage::setOptions()
      *
-     * @note The options list is based on the supported options as of Symfony 6.1.0
+     * @note The options list is based on the supported options as of Symfony 7.2.0
      */
     public function setOptions(array $options): void
     {
@@ -202,6 +202,10 @@ public function setOptions(array $options): void
         ]);
 
         foreach ($options as $key => $value) {
+            if (\in_array($key, ['referer_check', 'use_only_cookies', 'use_trans_sid', 'trans_sid_hosts', 'trans_sid_tags', 'sid_length', 'sid_bits_per_character'], true)) {
+                trigger_deprecation('babdev/websocket-server', '0.1', 'The "%s" option for the read-only native session storage is deprecated as of PHP 8.4 and support will be removed before the 1.0 release.', $key);
+            }
+
             if (isset($validOptions[$key])) {
                 if ('cookie_secure' === $key && 'auto' === $value) {
                     continue;