Polyfill the random extension's interfaces and Secure engine

Author: TimWolla

README.md

@@ -65,6 +65,9 @@ Polyfills are provided for:
 - the `AllowDynamicProperties` attribute introduced in PHP 8.2;
 - the `SensitiveParameter` attribute introduced in PHP 8.2;
 - the `SensitiveParameterValue` class introduced in PHP 8.2;
+- the `Random\Engine` interface introduced in PHP 8.2;
+- the `Random\CryptoSafeEngine` interface introduced in PHP 8.2;
+- the `Random\Engine\Secure` class introduced in PHP 8.2;
 - the `json_validate` function introduced in PHP 8.3;
 
 It is strongly recommended to upgrade your PHP version and/or install the missing

src/Php82/README.md

@@ -6,6 +6,9 @@ This component provides features added to PHP 8.2 core:
 - [`AllowDynamicProperties`](https://wiki.php.net/rfc/deprecate_dynamic_properties)
 - [`SensitiveParameter`](https://wiki.php.net/rfc/redact_parameters_in_back_traces)
 - [`SensitiveParameterValue`](https://wiki.php.net/rfc/redact_parameters_in_back_traces)
+- [`Random\Engine`](https://wiki.php.net/rfc/rng_extension)
+- [`Random\Engine\CryptoSafeEngine`](https://wiki.php.net/rfc/rng_extension)
+- [`Random\Engine\Secure`](https://wiki.php.net/rfc/rng_extension)
 
 More information can be found in the
 [main Polyfill README](https://github.com/symfony/polyfill/blob/main/README.md).

src/Php82/Random/Engine/Secure.php

@@ -0,0 +1,39 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Polyfill\Php82\Random\Engine;
+
+/**
+ * @author Tim Düsterhus <[email protected]>
+ *
+ * @internal
+ */
+class Secure
+{
+    public function __construct()
+    {
+    }
+
+    public function generate(): string
+    {
+        return \random_bytes(\PHP_INT_SIZE);
+    }
+
+    public function __sleep(): array
+    {
+        throw new \Exception("Serialization of 'Random\\Engine\\Secure' is not allowed");
+    }
+
+    public function __wakeup(): void
+    {
+        throw new \Exception("Unserialization of 'Random\\Engine\\Secure' is not allowed");
+    }
+}

src/Php82/Resources/stubs/Random/BrokenRandomEngineError.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Random;
+
+if (\PHP_VERSION_ID < 80200) {
+    class BrokenRandomEngineError extends RandomError
+    {
+    }
+}

src/Php82/Resources/stubs/Random/CryptoSafeEngine.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Random;
+
+if (\PHP_VERSION_ID < 80200) {
+    interface CryptoSafeEngine extends Engine
+    {
+    }
+}

src/Php82/Resources/stubs/Random/Engine.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Random;
+
+if (\PHP_VERSION_ID < 80200) {
+    interface Engine
+    {
+        public function generate(): string;
+    }
+}

src/Php82/Resources/stubs/Random/Engine/Secure.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Random\Engine;
+
+use \Symfony\Polyfill\Php82 as p;
+
+if (\PHP_VERSION_ID < 80200) {
+    final class Secure extends p\Random\Engine\Secure implements \Random\CryptoSafeEngine
+    {
+    }
+}

src/Php82/Resources/stubs/Random/RandomError.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Random;
+
+if (\PHP_VERSION_ID < 80200) {
+    class RandomError extends \Error
+    {
+    }
+}

src/Php82/Resources/stubs/Random/RandomException.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Random;
+
+if (\PHP_VERSION_ID < 80200) {
+    class RandomException extends \Exception
+    {
+    }
+}

tests/Php82/RandomSecureEngineTest.php

@@ -0,0 +1,46 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Polyfill\Tests\Php82;
+
+use PHPUnit\Framework\TestCase;
+use Symfony\Polyfill\Php82\Random\Engine\Secure as SecureEnginePolyfill;
+
+/**
+ * @author Tim Düsterhus <[email protected]>
+ */
+class RandomSecureEngineTest extends TestCase
+{
+    public function secureEngineProvider()
+    {
+        yield [new SecureEnginePolyfill()];
+        yield [new \Random\Engine\Secure()];
+    }
+
+    /**
+     * @dataProvider secureEngineProvider
+     */
+    public function testGenerateLength($v)
+    {
+        $this->assertSame(\PHP_INT_SIZE, strlen($v->generate()));
+    }
+
+    /**
+     * @dataProvider secureEngineProvider
+     */
+    public function testSerializeIsNotAllowed($v)
+    {
+        $this->expectException(\Exception::class);
+        $this->expectExceptionMessage("Serialization of 'Random\\Engine\\Secure' is not allowed");
+
+        serialize($v);
+    }
+}