diff --git a/reference/random/functions/lcg-value.xml b/reference/random/functions/lcg-value.xml
index 317235bab81c..15d320b14fde 100644
--- a/reference/random/functions/lcg-value.xml
+++ b/reference/random/functions/lcg-value.xml
@@ -5,6 +5,11 @@
   <refname>lcg_value</refname>
   <refpurpose>Combined linear congruential generator</refpurpose>
  </refnamediv>
+
+ <refsynopsisdiv>
+  &warn.deprecated.function-8-4-0;
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
    <methodsynopsis>
@@ -46,6 +51,29 @@
    A pseudo random float value between 0.0 and 1.0, inclusive.
   </para>
  </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       This function has been deprecated.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
diff --git a/reference/random/versions.xml b/reference/random/versions.xml
index 2ac129bdb294..eee9c8aadf65 100644
--- a/reference/random/versions.xml
+++ b/reference/random/versions.xml
@@ -2,7 +2,7 @@
 <!-- Do NOT translate this file -->
 <versions>
  <!-- Functions -->
- <function name="lcg_value" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
+ <function name="lcg_value" from="PHP 4, PHP 5, PHP 7, PHP 8" deprecated="PHP 8.4.0"/>
  <function name="mt_srand" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="srand" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="rand" from="PHP 4, PHP 5, PHP 7, PHP 8"/>