From b0318ec488a064e300be0ba1e44ed1e855e6984a Mon Sep 17 00:00:00 2001
From: qodelicious <162776175+qodelicious@users.noreply.github.com>
Date: Mon, 19 Oct 2026 00:13:20 +0000
Subject: [PATCH] gmp_random_seed(): update example for PHP 8

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
---
 reference/gmp/functions/gmp-random-seed.xml | 26 ++++++++++-----------
 1 file changed, 13 insertions(+), 13 deletions(-)

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>