From a4d5706a5412bdd0ee0fb9e477a396a6fc739c9e Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Tue, 1 Sep 2026 10:11:21 +0200
Subject: [PATCH] [Sync-En] ext/ldap: document the PHP 8.5 deprecations and
 ValueError

---
 reference/ldap/constants.xml                  | 22 +++++-----------
 .../ldap/functions/ldap-connect-wallet.xml    | 26 +++++++++++++++++--
 reference/ldap/functions/ldap-connect.xml     | 10 ++++++-
 reference/ldap/functions/ldap-get-option.xml  |  5 ++--
 reference/ldap/functions/ldap-set-option.xml  |  9 ++++++-
 5 files changed, 51 insertions(+), 21 deletions(-)

diff --git a/reference/ldap/constants.xml b/reference/ldap/constants.xml
index a96a85f76f..31c8c669b3 100644
--- a/reference/ldap/constants.xml
+++ b/reference/ldap/constants.xml
@@ -1,7 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 10e6a2b042104bd7481b6c21ddbfda594683e3c4 Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: no Maintainer: Marqitos -->
+<!-- EN-Revision: c048a5adc2726c0e5b68c5d7d8751e9854b6f637 Maintainer: PhilDaiguille Status: ready -->
 
 <appendix xml:id="ldap.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.constants;
@@ -424,10 +422,8 @@
     (<type>int</type>)
    </term>
    <listitem>
-    <simpara>
-     Modo de autenticación SSL - No se requiere autenticación. (solo
-     para Oracle LDAP)
-    </simpara>
+    <simpara>Modo de autenticación SSL - No se requiere autenticación. (solo para Oracle LDAP)</simpara>
+    <warning><simpara>Obsoleto a partir de PHP 8.5.0.</simpara></warning>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gslc-ssl-oneway-auth">
@@ -436,10 +432,8 @@
     (<type>int</type>)
    </term>
    <listitem>
-    <simpara>
-     Modo de autenticación SSL - Solo se requiere autenticación del servidor. (solo
-     para Oracle LDAP)
-    </simpara>
+    <simpara>Modo de autenticación SSL - Solo se requiere autenticación del servidor. (solo para Oracle LDAP)</simpara>
+    <warning><simpara>Obsoleto a partir de PHP 8.5.0.</simpara></warning>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.gslc-ssl-twoway-auth">
@@ -448,10 +442,8 @@
     (<type>int</type>)
    </term>
    <listitem>
-    <simpara>
-     Modo de autenticación SSL - Se requiere autenticación del servidor y del cliente. (solo
-     para Oracle LDAP)
-    </simpara>
+    <simpara>Modo de autenticación SSL - Se requiere autenticación del servidor y del cliente. (solo para Oracle LDAP)</simpara>
+    <warning><simpara>Obsoleto a partir de PHP 8.5.0.</simpara></warning>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ldap-exop-start-tls">
diff --git a/reference/ldap/functions/ldap-connect-wallet.xml b/reference/ldap/functions/ldap-connect-wallet.xml
index 768840a3a2..1a92112773 100644
--- a/reference/ldap/functions/ldap-connect-wallet.xml
+++ b/reference/ldap/functions/ldap-connect-wallet.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ce98b568f85353c4bf263133f09c4db9294833f9 Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: yes Maintainer: Marqitos -->
+<!-- EN-Revision: c048a5adc2726c0e5b68c5d7d8751e9854b6f637 Maintainer: PhilDaiguille Status: ready -->
 <refentry xml:id="function.ldap-connect-wallet" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>ldap_connect_wallet</refname>
@@ -74,6 +73,29 @@
   </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>
+       Esta función ha quedado obsoleta. El soporte de Oracle LDAP
+       (Oracle Instant Client) está obsoleto en PHP 8.5.0.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
diff --git a/reference/ldap/functions/ldap-connect.xml b/reference/ldap/functions/ldap-connect.xml
index b04ef545b0..54cf9e3b92 100644
--- a/reference/ldap/functions/ldap-connect.xml
+++ b/reference/ldap/functions/ldap-connect.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 87d63aa1a3fc86d64dc994332042fdd2c13bf3d8 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: c048a5adc2726c0e5b68c5d7d8751e9854b6f637 Maintainer: PhilDaiguille Status: ready -->
 <refentry xml:id="function.ldap-connect" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>ldap_connect</refname>
@@ -115,6 +115,14 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.5.0</entry>
+      <entry>
+       Llamar a <function>ldap_connect</function> con argumentos de wallet de
+       Oracle está obsoleto. El soporte de Oracle LDAP (Oracle Instant Client)
+       está obsoleto a partir de PHP 8.5.0.
+      </entry>
+     </row>
      <row>
       <entry>8.4.0</entry>
       <entry>
diff --git a/reference/ldap/functions/ldap-get-option.xml b/reference/ldap/functions/ldap-get-option.xml
index 2826f0fe1d..5e47186a52 100644
--- a/reference/ldap/functions/ldap-get-option.xml
+++ b/reference/ldap/functions/ldap-get-option.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 5b3a84935252a553528cb81b3dacb88647b57c7b Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: c048a5adc2726c0e5b68c5d7d8751e9854b6f637 Maintainer: PhilDaiguille Status: ready -->
 <refentry xml:id="function.ldap-get-option" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>ldap_get_option</refname>
@@ -254,6 +253,8 @@
       <entry>8.5.0</entry>
       <entry>
        <parameter>ldap</parameter> ahora acepta &null;.
+       Ahora se lanza un <exceptionname>ValueError</exceptionname> cuando se
+       proporciona una <parameter>option</parameter> inválida.
       </entry>
      </row>
      &ldap.changelog.ldap-object;
diff --git a/reference/ldap/functions/ldap-set-option.xml b/reference/ldap/functions/ldap-set-option.xml
index 14be953222..75088b6213 100644
--- a/reference/ldap/functions/ldap-set-option.xml
+++ b/reference/ldap/functions/ldap-set-option.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 87d63aa1a3fc86d64dc994332042fdd2c13bf3d8 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: c048a5adc2726c0e5b68c5d7d8751e9854b6f637 Maintainer: PhilDaiguille Status: ready -->
 <refentry xml:id="function.ldap-set-option" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ldap_set_option</refname>
@@ -259,6 +259,13 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.5.0</entry>
+      <entry>
+       Ahora se lanza un <exceptionname>ValueError</exceptionname> cuando se
+       proporciona una <parameter>option</parameter> inválida.
+      </entry>
+     </row>
      &ldap.changelog.ldap-object;
     </tbody>
    </tgroup>