[DOC-CVS] [doc-en] master: Soap: PHP 8.4 resource to Object conversions (#5572)

Author: Jordi Kroon (jordikroon)
Committer: GitHub (web-flow)
Pusher: jordikroon
Date: 2026-05-22T19:27:32+02:00

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

Soap: PHP 8.4 resource to Object conversions (#5572)

* PHP 8.4 Soap resource to Object conversions

Co-authored-by: Louis-Arnaud <[email protected]>

Changed paths:
  A  reference/soap/soap.sdl.xml
  A  reference/soap/soap.url.xml
  M  reference/soap/book.xml
  M  reference/soap/soapclient.xml
  M  reference/soap/versions.xml


Diff:

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..558c6b579939
--- /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 a <literal>soap_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..af5754a1e96e
--- /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 a <literal>soap_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"/>