From ad68a77003b36f1507eb1029162ec19001bd58f1 Mon Sep 17 00:00:00 2001
From: Jordi Kroon <jkroon@onyourmarks.agency>
Date: Thu, 21 May 2026 21:21:23 +0200
Subject: [PATCH 1/2] PHP 8.4 Soap resource to Object conversions

---
 reference/soap/book.xml       |  3 +-
 reference/soap/soap.sdl.xml   | 57 +++++++++++++++++++++++++++++++++++
 reference/soap/soap.url.xml   | 57 +++++++++++++++++++++++++++++++++++
 reference/soap/soapclient.xml |  4 +--
 reference/soap/versions.xml   |  4 +++
 5 files changed, 122 insertions(+), 3 deletions(-)
 create mode 100644 reference/soap/soap.sdl.xml
 create mode 100644 reference/soap/soap.url.xml

diff --git a/reference/soap/book.xml b/reference/soap/book.xml
index bcac66101402..a50bc6802587 100644
--- a/reference/soap/book.xml
+++ b/reference/soap/book.xml
@@ -18,7 +18,6 @@
 
  &reference.soap.setup;
  &reference.soap.constants;
- <!-- &reference.soap.examples; -->
  &reference.soap.reference;
 
  &reference.soap.soapclient;
@@ -28,6 +27,8 @@
  &reference.soap.soapparam;
  &reference.soap.soapvar;
 
+ &reference.soap.soap.sdl;
+ &reference.soap.soap.url;
 
 </book>
 
diff --git a/reference/soap/soap.sdl.xml b/reference/soap/soap.sdl.xml
new file mode 100644
index 000000000000..b6beb0fb3cb5
--- /dev/null
+++ b/reference/soap/soap.sdl.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<reference xmlns="http://docbook.org/ns/docbook" xml:id="class.soap-sdl" role="class">
+ <title>The Soap\Sdl class</title>
+ <titleabbrev>Soap\Sdl</titleabbrev>
+
+ <partintro>
+
+  <!-- {{{ Soap\Sdl intro -->
+  <section xml:id="soap-sdl.intro">
+   &reftitle.intro;
+   <simpara>
+    A fully opaque class which replaces an <literal>sdl</literal> resource as of PHP 8.4.0.
+   </simpara>
+  </section>
+  <!-- }}} -->
+
+  <section xml:id="soap-sdl.synopsis">
+   &reftitle.classsynopsis;
+
+   <!-- {{{ Synopsis -->
+   <packagesynopsis>
+    <package>Soap</package>
+
+    <classsynopsis class="class">
+     <ooclass>
+      <modifier>final</modifier>
+      <classname>Sdl</classname>
+     </ooclass>
+    </classsynopsis>
+   </packagesynopsis>
+   <!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+</reference>
+ <!-- Keep this comment at the end of the file
+  Local variables:
+  mode: sgml
+  sgml-omittag:t
+  sgml-shorttag:t
+  sgml-minimize-attributes:nil
+  sgml-always-quote-attributes:t
+  sgml-indent-step:1
+  sgml-indent-data:t
+  indent-tabs-mode:nil
+  sgml-parent-document:nil
+  sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+  sgml-exposed-tags:nil
+  sgml-local-catalogs:nil
+  sgml-local-ecat-files:nil
+  End:
+  vim600: syn=xml fen fdm=syntax fdl=2 si
+  vim: et tw=78 syn=sgml
+  vi: ts=1 sw=1
+  -->
diff --git a/reference/soap/soap.url.xml b/reference/soap/soap.url.xml
new file mode 100644
index 000000000000..78c245de8d92
--- /dev/null
+++ b/reference/soap/soap.url.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<reference xmlns="http://docbook.org/ns/docbook" xml:id="class.soap-url" role="class">
+ <title>The Soap\Url class</title>
+ <titleabbrev>Soap\Url</titleabbrev>
+
+ <partintro>
+
+  <!-- {{{ Soap\Url intro -->
+  <section xml:id="soap-url.intro">
+   &reftitle.intro;
+   <simpara>
+    A fully opaque class which replaces an <literal>url</literal> resource as of PHP 8.4.0.
+   </simpara>
+  </section>
+  <!-- }}} -->
+
+  <section xml:id="soap-url.synopsis">
+   &reftitle.classsynopsis;
+
+   <!-- {{{ Synopsis -->
+   <packagesynopsis>
+    <package>Soap</package>
+
+    <classsynopsis class="class">
+     <ooclass>
+      <modifier>final</modifier>
+      <classname>Url</classname>
+     </ooclass>
+    </classsynopsis>
+   </packagesynopsis>
+   <!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+</reference>
+ <!-- Keep this comment at the end of the file
+  Local variables:
+  mode: sgml
+  sgml-omittag:t
+  sgml-shorttag:t
+  sgml-minimize-attributes:nil
+  sgml-always-quote-attributes:t
+  sgml-indent-step:1
+  sgml-indent-data:t
+  indent-tabs-mode:nil
+  sgml-parent-document:nil
+  sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+  sgml-exposed-tags:nil
+  sgml-local-catalogs:nil
+  sgml-local-ecat-files:nil
+  End:
+  vim600: syn=xml fen fdm=syntax fdl=2 si
+  vim: et tw=78 syn=sgml
+  vi: ts=1 sw=1
+  -->
diff --git a/reference/soap/soapclient.xml b/reference/soap/soapclient.xml
index 52437e97bd0d..5c04379497d1 100644
--- a/reference/soap/soapclient.xml
+++ b/reference/soap/soapclient.xml
@@ -66,7 +66,7 @@
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>private</modifier>
-     <type class="union"><type>resource</type><type>null</type></type>
+     <type class="union"><type>Soap\Sdl</type><type>null</type></type>
      <varname linkend="soapclient.props.sdl">sdl</varname>
      <initializer>null</initializer>
     </fieldsynopsis>
@@ -84,7 +84,7 @@
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>private</modifier>
-     <type class="union"><type>resource</type><type>null</type></type>
+     <type class="union"><type>Soap\Url</type><type>null</type></type>
      <varname linkend="soapclient.props.httpurl">httpurl</varname>
      <initializer>null</initializer>
     </fieldsynopsis>
diff --git a/reference/soap/versions.xml b/reference/soap/versions.xml
index 251eaef12cac..40946866edc4 100644
--- a/reference/soap/versions.xml
+++ b/reference/soap/versions.xml
@@ -7,7 +7,11 @@
  <!-- Functions -->
  <function name="use_soap_error_handler" from="PHP 5, PHP 7, PHP 8"/>
  <function name="is_soap_fault" from="PHP 5, PHP 7, PHP 8"/>
+
  <!-- Methods -->
+ <function name="soap\sdl" from="PHP 8 &gt;= 8.4.0"/>
+
+ <function name="soap\url" from="PHP 8 &gt;= 8.4.0"/>
 
  <function name="soapclient" from="PHP 5, PHP 7, PHP 8"/>
  <function name="soapclient::__construct" from="PHP 5, PHP 7, PHP 8"/>

From 80d4e11f22e25294d932daa2c9d9e0ece7a9cbc0 Mon Sep 17 00:00:00 2001
From: Jordi Kroon <jordikroon@me.com>
Date: Fri, 22 May 2026 19:26:18 +0200
Subject: [PATCH 2/2] Apply suggestions from code review

Co-authored-by: Louis-Arnaud <la.catoire@gmail.com>
---
 reference/soap/soap.sdl.xml | 2 +-
 reference/soap/soap.url.xml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/soap/soap.sdl.xml b/reference/soap/soap.sdl.xml
index b6beb0fb3cb5..558c6b579939 100644
--- a/reference/soap/soap.sdl.xml
+++ b/reference/soap/soap.sdl.xml
@@ -9,7 +9,7 @@
   <section xml:id="soap-sdl.intro">
    &reftitle.intro;
    <simpara>
-    A fully opaque class which replaces an <literal>sdl</literal> resource as of PHP 8.4.0.
+    A fully opaque class which replaces a <literal>soap_sdl</literal> &resource; as of PHP 8.4.0.
    </simpara>
   </section>
   <!-- }}} -->
diff --git a/reference/soap/soap.url.xml b/reference/soap/soap.url.xml
index 78c245de8d92..af5754a1e96e 100644
--- a/reference/soap/soap.url.xml
+++ b/reference/soap/soap.url.xml
@@ -9,7 +9,7 @@
   <section xml:id="soap-url.intro">
    &reftitle.intro;
    <simpara>
-    A fully opaque class which replaces an <literal>url</literal> resource as of PHP 8.4.0.
+    A fully opaque class which replaces a <literal>soap_url</literal> &resource; as of PHP 8.4.0.
    </simpara>
   </section>
   <!-- }}} -->