[doc-en] master: gmp_random_seed(): update example for PHP 8 (#5965)

Author: qodelicious (qodelicious) Committer: GitHub (web-flow) Pusher: lacatoire Date: 2026-10-19T10:18:19+02:00 Commit: https://github.com/php/doc-en/commit/ea41e5c4e5b73512b59c76f6a45ea146a97667a9 Raw diff: https://github.com/php/doc-en/commit/ea41e5c4e5b73512b59c76f6a45ea146a97667a9.diff gmp_random_seed(): update example for PHP 8 (#5965) The example called gmp_random(), which was removed in PHP 8.0.0, and showed the warning and false return that gmp_random_seed() no longer produces. Use gmp_random_bits()/gmp_random_range() and catch the ValueError instead, and drop gmp_random() from the related functions. Fixes #1387 Changed paths: M reference/gmp/functions/gmp-random-seed.xml Diff: diff --git a/reference/gmp/functions/gmp-random-seed.xml b/reference/gmp/functions/gmp-random-seed.xml index 707bd85298d4..1efacd4915fc 100644 --- a/reference/gmp/functions/gmp-random-seed.xml +++ b/reference/gmp/functions/gmp-random-seed.xml @@ -21,11 +21,10 @@ <varlistentry> <term><parameter>seed</parameter></term> <listitem> - <para> - The seed to be set for the <function>gmp_random</function>, - <function>gmp_random_bits</function>, and + <simpara> + The seed to be set for the <function>gmp_random_bits</function> and <function>gmp_random_range</function> functions. - </para> + </simpara> &gmp.parameter; </listitem> @@ -84,25 +83,27 @@ // set the seed gmp_random_seed(100); -var_dump(gmp_strval(gmp_random(1))); +var_dump(gmp_strval(gmp_random_bits(10))); // set the seed to something else gmp_random_seed(gmp_init(-100)); -var_dump(gmp_strval(gmp_random_bits(10))); +var_dump(gmp_strval(gmp_random_range(0, 100))); // set the seed to something invalid -var_dump(gmp_random_seed('not a number')); +try { + gmp_random_seed('not a number'); +} catch (\ValueError $e) { + echo $e->getMessage(), PHP_EOL; +} ]]> </programlisting> &example.outputs; <screen> <![CDATA[ -string(20) "15370156633245019617" -string(3) "683" - -Warning: gmp_random_seed(): Unable to convert variable to GMP - string is not an integer in %s on line %d -bool(false) +string(3) "800" +string(2) "32" +gmp_random_seed(): Argument #1 ($seed) is not an integer string ]]> </screen> </example> @@ -113,7 +114,6 @@ bool(false) &reftitle.seealso; <simplelist> <member><function>gmp_init</function></member> - <member><function>gmp_random</function></member> <member><function>gmp_random_bits</function></member> <member><function>gmp_random_range</function></member> </simplelist>