[DOC-CVS] [doc-en] master: Document key_length param deprecation in openssl_pkey_derive (#5032)

Author: Jakub Zelenka (bukka)
Committer: GitHub (web-flow)
Pusher: bukka
Date: 2025-12-09T18:16:52+01:00

Commit: https://github.com/php/doc-en/commit/af71bd1bd3bb0604c7bb3d2ff12019480c842843
Raw diff: https://github.com/php/doc-en/commit/af71bd1bd3bb0604c7bb3d2ff12019480c842843.diff

Document key_length param deprecation in openssl_pkey_derive (#5032)

Changed paths:
  M  reference/openssl/functions/openssl-pkey-derive.xml


Diff:

diff --git a/reference/openssl/functions/openssl-pkey-derive.xml b/reference/openssl/functions/openssl-pkey-derive.xml
index 6b1c6cecdeed..24188aeb4065 100644
--- a/reference/openssl/functions/openssl-pkey-derive.xml
+++ b/reference/openssl/functions/openssl-pkey-derive.xml
@@ -50,9 +50,9 @@
      </para>
      <caution>
       <simpara>
-       This parameter should not be used, as it does not work as expected. It never returns a secret
-       longer than the size of the prime. If the desired length is smaller than the size of the
-       prime, it truncates the length only for ECDH keys but fails for DH keys.
+       This parameter is deprecated and should not be used, as it does not work as expected. It
+       never returns a secret longer than the size of the prime. If the desired length is smaller
+       than the size of the prime, it truncates the length only for ECDH keys but fails for DH keys.
       </simpara>
      </caution>
     </listitem>
@@ -67,6 +67,28 @@
   </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.5.0</entry>
+      <entry>
+       The parameter <parameter>key_length</parameter> is now deprecated.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>