+ * Use one of the following constants to specify the implementation of the algorithm to use. + *
+ * @return void + */ + function mt_srand( + int $seed = 0, + #[PhpStormStubsElementAvailable(from: '7.1')] int $mode = MT_RAND_MT19937 + ): void {} + + /** + * Seed the random number generator + *Note: As of PHP 7.1.0, {@see srand()} has been made + * an alias of {@see mt_srand()}. + *
+ * @link https://php.net/manual/en/function.srand.php + * @param int $seed+ * Optional seed value + *
+ * @param int $mode [optional]+ * Use one of the following constants to specify the implementation of the algorithm to use. + *
+ * @return void + */ + function srand( + int $seed = 0, + #[PhpStormStubsElementAvailable(from: '7.1')] int $mode = MT_RAND_MT19937 + ): void {} + + /** + * Generate a random integer + * @link https://php.net/manual/en/function.rand.php + * @param int $min + * @param int $max [optional] + * @return int A pseudo random value between min + * (or 0) and max (or getrandmax, inclusive). + */ + function rand(int $min = null, int $max): int {} + + /** + * Generate a random value via the Mersenne Twister Random Number Generator + * @link https://php.net/manual/en/function.mt-rand.php + * @param int $min+ * Optional lowest value to be returned (default: 0) + *
+ * @param int $max [optional]+ * Optional highest value to be returned (default: mt_getrandmax()) + *
+ * @return int A random integer value between min (or 0) + * and max (or mt_getrandmax, inclusive) + */ + function mt_rand(int $min = null, int $max): int {} + + /** + * Show largest possible random value + * @link https://php.net/manual/en/function.mt-getrandmax.php + * @return int the maximum random value returned by mt_rand + */ + #[Pure] + function mt_getrandmax(): int {} + + /** + * Show largest possible random value + * @link https://php.net/manual/en/function.getrandmax.php + * @return int The largest possible random value returned by rand + */ + #[Pure] + function getrandmax(): int {} + + /** + * Generates cryptographically secure pseudo-random bytes + * @link https://php.net/manual/en/function.random-bytes.php + * @param int $length The length of the random string that should be returned in bytes. + * @return string Returns a string containing the requested number of cryptographically secure random bytes. + * @since 7.0 + * @throws Exception if an appropriate source of randomness cannot be found. + */ + function random_bytes(int $length): string {} + + /** + * Generates cryptographically secure pseudo-random integers + * @link https://php.net/manual/en/function.random-int.php + * @param int $min The lowest value to be returned, which must be PHP_INT_MIN or higher. + * @param int $max The highest value to be returned, which must be less than or equal to PHP_INT_MAX. + * @return int Returns a cryptographically secure random integer in the range min to max, inclusive. + * @since 7.0 + * @throws Exception if an appropriate source of randomness cannot be found. + */ + function random_int(int $min, int $max): int {} +} + +namespace Random\Engine +{ + /** + * @since 8.2 + */ + final class Mt19937 implements \Random\Engine + { + public function __construct(int|null $seed = null, int $mode = MT_RAND_MT19937) {} + + public function generate(): string {} + + public function __serialize(): array {} + + public function __unserialize(array $data): void {} + + public function __debugInfo(): array {} + } + + /** + * @since 8.2 + */ + final class PcgOneseq128XslRr64 implements \Random\Engine + { + public function __construct(string|int|null $seed = null, string|int $sequence = 0) {} + + public function generate(): string {} + + public function jump(int $advance): void {} + + public function __serialize(): array {} + + public function __unserialize(array $data): void {} + + public function __debugInfo(): array {} + } + + /** + * @since 8.2 + */ + final class Xoshiro256StarStar implements \Random\Engine + { + public function __construct(string|int|null $seed = null) {} + + public function generate(): string {} + + public function jump(): void {} + + public function jumpLong(): void {} + + public function __serialize(): array {} + + public function __unserialize(array $data): void {} + + public function __debugInfo(): array {} + } + + /** + * @since 8.2 + */ + final class Secure implements \Random\CryptoSafeEngine + { + public function generate(): string {} + } +} + +namespace Random +{ + /** + * @since 8.2 + */ + interface Engine + { + public function generate(): string; + } + /** + * @since 8.2 + */ + interface CryptoSafeEngine extends Engine {} + + /** + * @since 8.2 + */ + final class Randomizer + { + public readonly Engine $engine; + + public function __construct(?Engine $engine = null) {} + + public function getInt(int $min = UNKNOWN, int $max = UNKNOWN): int {} + + public function getBytes(int $length): string {} + + public function shuffleArray(array $array): array {} + + public function shuffleBytes(string $bytes): string {} + + public function pickArrayKeys(array $array, int $num): array {} + + public function __serialize(): array {} + + public function __unserialize(array $data): void {} + } +} diff --git a/sockets/sockets.php b/sockets/sockets.php index 73cb44387..212b8a24e 100644 --- a/sockets/sockets.php +++ b/sockets/sockets.php @@ -2312,6 +2312,20 @@ function socket_wsaprotocol_info_release($info_id) {} */ define('TCP_KEEPCNT', 6); +/** + * Socket_set_option for the socket_send* functions. + * It avoids copy b/w userland and kernel for both TCP and UDP protocols. + * @since 8.2 + */ +define('SO_ZEROCOPY', 60); + +/** + * Socket_set_option for the socket_send* functions. + * It avoids copy b/w userland and kernel for both TCP and UDP protocols. + * @since 8.2 + */ +define('MSG_ZEROCOPY', 67108864); + /** * @since 8.0 */ diff --git a/standard/CSPRNG.php b/standard/CSPRNG.php deleted file mode 100644 index 069a9fa03..000000000 --- a/standard/CSPRNG.php +++ /dev/null @@ -1,21 +0,0 @@ - 'string'], default: '')] + #[PhpStormStubsElementAvailable(to: '8.0')] public $path; + /** + * @var string The directory that was opened. + */ + #[PhpStormStubsElementAvailable(from: '8.1')] + public readonly string $path; + /** * @var resource Can be used with other directory functions such as {@see readdir()}, {@see rewinddir()} and {@see closedir()}. */ - #[LanguageLevelTypeAware(['8.1' => 'mixed'], default: '')] + #[PhpStormStubsElementAvailable(to: '8.0')] public $handle; + /** + * @var resource Can be used with other directory functions such as {@see readdir()}, {@see rewinddir()} and {@see closedir()}. + */ + #[PhpStormStubsElementAvailable(from: '8.1')] + public readonly mixed $handle; + /** * Close directory handle. * Same as closedir(), only dir_handle defaults to $this. diff --git a/standard/standard_2.php b/standard/standard_2.php index 6d8ef8993..1f04e40ff 100644 --- a/standard/standard_2.php +++ b/standard/standard_2.php @@ -930,81 +930,6 @@ function proc_get_status($process) {} */ function proc_nice(int $priority): bool {} -/** - * Generate a random integer - * @link https://php.net/manual/en/function.rand.php - * @param int $min - * @param int $max [optional] - * @return int A pseudo random value between min - * (or 0) and max (or getrandmax, inclusive). - */ -function rand(int $min = null, int $max): int {} - -/** - * Seed the random number generator - *Note: As of PHP 7.1.0, {@see srand()} has been made - * an alias of {@see mt_srand()}. - *
- * @link https://php.net/manual/en/function.srand.php - * @param int $seed- * Optional seed value - *
- * @param int $mode [optional]- * Use one of the following constants to specify the implementation of the algorithm to use. - *
- * @return void - */ -function srand( - int $seed = 0, - #[PhpStormStubsElementAvailable(from: '7.1')] int $mode = MT_RAND_MT19937 -): void {} - -/** - * Show largest possible random value - * @link https://php.net/manual/en/function.getrandmax.php - * @return int The largest possible random value returned by rand - */ -#[Pure] -function getrandmax(): int {} - -/** - * Generate a random value via the Mersenne Twister Random Number Generator - * @link https://php.net/manual/en/function.mt-rand.php - * @param int $min- * Optional lowest value to be returned (default: 0) - *
- * @param int $max [optional]- * Optional highest value to be returned (default: mt_getrandmax()) - *
- * @return int A random integer value between min (or 0) - * and max (or mt_getrandmax, inclusive) - */ -function mt_rand(int $min = null, int $max): int {} - -/** - * Seeds the Mersenne Twister Random Number Generator - * @link https://php.net/manual/en/function.mt-srand.php - * @param int $seed- * An optional seed value - *
- * @param int $mode [optional]- * Use one of the following constants to specify the implementation of the algorithm to use. - *
- * @return void - */ -function mt_srand( - int $seed = 0, - #[PhpStormStubsElementAvailable(from: '7.1')] int $mode = MT_RAND_MT19937 -): void {} - -/** - * Show largest possible random value - * @link https://php.net/manual/en/function.mt-getrandmax.php - * @return int the maximum random value returned by mt_rand - */ -#[Pure] -function mt_getrandmax(): int {} - /** * Get port number associated with an Internet service and protocol * @link https://php.net/manual/en/function.getservbyname.php diff --git a/standard/standard_8.php b/standard/standard_8.php index fc3682dbf..3f9f1a6e1 100644 --- a/standard/standard_8.php +++ b/standard/standard_8.php @@ -124,13 +124,6 @@ function stream_set_chunk_size($stream, int $size) {} #[Deprecated(since: '5.3')] function define_syslog_variables() {} -/** - * Combined linear congruential generator - * @link https://php.net/manual/en/function.lcg-value.php - * @return float A pseudo random float value in the range of (0, 1) - */ -function lcg_value(): float {} - /** * Calculate the metaphone key of a string * @link https://php.net/manual/en/function.metaphone.php diff --git a/tests/DockerImages/8.2/Dockerfile b/tests/DockerImages/8.2/Dockerfile index 2bb53fb15..cf16647d8 100644 --- a/tests/DockerImages/8.2/Dockerfile +++ b/tests/DockerImages/8.2/Dockerfile @@ -1,4 +1,4 @@ -FROM php:8.2.0alpha3-zts-alpine +FROM php:8.2.0beta1-zts-alpine RUN set -eux; \ apk add --no-cache --virtual .build-deps \ diff --git a/tests/Model/PHPProperty.php b/tests/Model/PHPProperty.php index 0a8313fe5..1b467a4c1 100644 --- a/tests/Model/PHPProperty.php +++ b/tests/Model/PHPProperty.php @@ -49,8 +49,8 @@ public function readObjectFromReflection($reflectionObject) if (method_exists($reflectionObject, 'getType')) { $this->typesFromSignature = self::getReflectionTypeAsArray($reflectionObject->getType()); } - if (property_exists($reflectionObject, 'isReadonly')) { - $this->isReadonly = $reflectionObject->isReadonly; + if (method_exists($reflectionObject, 'isReadonly')) { + $this->isReadonly = $reflectionObject->isReadOnly(); } return $this; } diff --git a/tests/TestData/Providers/Stubs/PhpCoreStubsProvider.php b/tests/TestData/Providers/Stubs/PhpCoreStubsProvider.php index d2d59ad6d..bbddad73a 100644 --- a/tests/TestData/Providers/Stubs/PhpCoreStubsProvider.php +++ b/tests/TestData/Providers/Stubs/PhpCoreStubsProvider.php @@ -16,6 +16,7 @@ class PhpCoreStubsProvider 'hash', 'meta', 'pcre', + 'random', 'Phar', 'Reflection', 'regex',