refactor(Request): Implement getServerName() method with PSR-7 support and fallback to Yii2, including comprehensive tests.

src/http/Request.php

@@ -524,6 +524,32 @@ public function getScriptUrl(): string
         return parent::getScriptUrl();
     }
 
+    /**
+     * Retrieves the server name for the current request, supporting PSR-7 and Yii2 fallback.
+     *
+     * Returns the server name as determined by the PSR-7 adapter if present.
+     *
+     * If no adapter is set, falls back to the parent implementation.
+     *
+     * This method enables seamless access to the server name in both PSR-7 and Yii2 environments, supporting
+     * interoperability with modern HTTP stacks and legacy workflows.
+     *
+     * @return string|null Server name for the current request, or null if not available.
+     *
+     * Usage example:
+     * ```php
+     * $serverName = $request->getServerName();
+     * ```
+     */
+    public function getServerName(): string|null
+    {
+        if ($this->adapter !== null) {
+            return $this->getServerParam('SERVER_NAME');
+        }
+
+        return parent::getServerName();
+    }
+
     /**
      * Retrieves a server parameter value as a string or `null`.
      *

tests/TestCase.php

@@ -20,6 +20,11 @@
 
 abstract class TestCase extends \PHPUnit\Framework\TestCase
 {
+    /**
+     * A secret key used for cookie validation in tests.
+     */
+    protected const COOKIE_VALIDATION_KEY = 'wefJDF8sfdsfSDefwqdxj9oq';
+
     /**
      * @phpstan-var array<mixed, mixed>
      */
@@ -185,7 +190,7 @@ protected function webApplication(array $config = []): void
                     ],
                     'components' => [
                         'request' => [
-                            'cookieValidationKey' => 'wefJDF8sfdsfSDefwqdxj9oq',
+                            'cookieValidationKey' => self::COOKIE_VALIDATION_KEY,
                             'isConsoleRequest' => false,
                             'scriptFile' => __DIR__ . '/index.php',
                             'scriptUrl' => '/index.php',

tests/adapter/ResponseAdapterTest.php

@@ -535,7 +535,6 @@ public function testFormatCookieWithDateTimeImmutableExpire(): void
                 'components' => [
                     'request' => [
                         'enableCookieValidation' => true,
-                        'cookieValidationKey' => 'test-validation-key-32-characters',
                     ],
                 ],
             ],
@@ -798,7 +797,6 @@ public function testFormatCookieWithExpireAtCurrentTime(): void
                 'components' => [
                     'request' => [
                         'enableCookieValidation' => true,
-                        'cookieValidationKey' => 'test-validation-key-32-characters',
                     ],
                 ],
             ],
@@ -908,7 +906,7 @@ public function testFormatCookieWithExpireSetToOne(): void
                 'components' => [
                     'request' => [
                         'enableCookieValidation' => true,
-                        'cookieValidationKey' => 'test-validation-key-32-characters',
+                        'cookieValidationKey' => self::COOKIE_VALIDATION_KEY,
                     ],
                 ],
             ],
@@ -1078,7 +1076,6 @@ public function testFormatCookieWithStringExpire(): void
                 'components' => [
                     'request' => [
                         'enableCookieValidation' => true,
-                        'cookieValidationKey' => 'test-validation-key-32-characters',
                     ],
                 ],
             ],
@@ -1154,7 +1151,6 @@ public function testFormatCookieWithStringExpireOne(): void
                 'components' => [
                     'request' => [
                         'enableCookieValidation' => true,
-                        'cookieValidationKey' => 'test-validation-key-32-characters',
                     ],
                 ],
             ],
@@ -1212,7 +1208,6 @@ public function testFormatCookieWithValidationDisabled(): void
                 'components' => [
                     'request' => [
                         'enableCookieValidation' => false,
-                        'cookieValidationKey' => 'some-key',
                     ],
                 ],
             ],
@@ -1323,7 +1318,6 @@ public function testFormatCookieWithValidationEnabled(): void
                 'components' => [
                     'request' => [
                         'enableCookieValidation' => true,
-                        'cookieValidationKey' => 'test-validation-key-32-characters',
                     ],
                 ],
             ],
@@ -1383,7 +1377,6 @@ public function testFormatCookieWithValidationEnabledFutureExpiration(): void
                 'components' => [
                     'request' => [
                         'enableCookieValidation' => true,
-                        'cookieValidationKey' => 'test-validation-key-32-characters',
                     ],
                 ],
             ],
@@ -1573,7 +1566,6 @@ public function testHashCookieValueIncludingName(): void
                 'components' => [
                     'request' => [
                         'enableCookieValidation' => true,
-                        'cookieValidationKey' => 'test-validation-key-32-characters',
                     ],
                 ],
             ],