Skip to content

[Sync EN] ext/soap: document PHP 8.4 changes (#5735) #1013

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
julionc merged 2 commits into from
Aug 21, 2026
Merged

[Sync EN] ext/soap: document PHP 8.4 changes (#5735) #1013

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0a87e18
[Sync EN] ext/soap: document PHP 8.4 changes (#5735)
lacatoire Aug 19, 2026
f2e6e11
Align xi:include with doc-en
lacatoire Aug 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 13 additions & 10 deletions reference/soap/soapclient.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 89205c88a79fcaad39fd043ed5ef695cd7bf813e Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: d20d66d9c76ff98dceb853aeb86794fe9d657669 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.soapclient" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

Expand Down Expand Up @@ -74,7 +74,7 @@
</fieldsynopsis>
<fieldsynopsis>
<modifier>private</modifier>
<type class="union"><type>resource</type><type>null</type></type>
<type class="union"><type>array</type><type>null</type></type>
<varname linkend="soapclient.props.typemap">typemap</varname>
<initializer>null</initializer>
</fieldsynopsis>
Expand Down Expand Up @@ -246,12 +246,8 @@
</fieldsynopsis>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.soapclient')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='SoapClient'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.soapclient')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='SoapClient'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.soapclient')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='SoapClient'])"/>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.soapclient')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='SoapClient'])"/>
</classsynopsis>
<!-- }}} -->
</section>
Expand Down Expand Up @@ -493,8 +489,15 @@
<varlistentry xml:id="soapclient.props.typemap">
<term><varname>typemap</varname></term>
<listitem>
<para>
</para>
<simpara>
Un array de correspondencias de tipos utilizadas para las conversiones
personalizadas de tipos XML a PHP, o &null; si no hay ninguna
correspondencia de tipos configurada.
A partir de PHP 8.4.0, esta propiedad es de tipo <type>array</type>;
anteriormente era de tipo <type>resource</type>.
El código que utiliza <function>is_resource</function> para comprobar esta
propiedad debe ser actualizado en consecuencia.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="soapclient.props.uri">
Expand Down
9 changes: 8 additions & 1 deletion reference/soap/soapclient/construct.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f309e78f9439ae5d063a284cefb4b375233aa785 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: d20d66d9c76ff98dceb853aeb86794fe9d657669 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: Marqitos -->
<refentry xml:id="soapclient.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand Down Expand Up @@ -367,6 +367,13 @@
pero los métodos mágicos <link linkend="object.set">__set()</link> y
<link linkend="object.get">__get()</link> para las propiedades individuales sí lo serán.
</para>
<simpara>
A partir de PHP 8.4.0, las claves también pueden ser especificadas usando la
notación de Clark, en la forma <literal>{namespace}type</literal>, para asociar
un tipo de un espacio de nombres XML específico, por ejemplo
<literal>'{http://example.com}foo'</literal>. Esto es útil cuando el mismo
nombre de tipo está definido en más de un espacio de nombres.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="soapclient.construct.options.typemap">
Expand Down
10 changes: 7 additions & 3 deletions reference/soap/soapserver/construct.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: fe4e8b87d18f17394e7177917c498774b062448c Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: d20d66d9c76ff98dceb853aeb86794fe9d657669 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="soapserver.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand Down Expand Up @@ -42,12 +42,16 @@
un juego de caracteres de codificación interna (<literal>encoding</literal>)
y una URI actor (<literal>actor</literal>).
</para>
<para>
<simpara>
La opción <literal>classmap</literal> puede ser utilizada para ligar
algunos tipos WSDL a clases PHP. Esta opción debe ser un
array con los tipos WSDL como claves y los nombres de las clases PHP
como valores.
</para>
A partir de PHP 8.4.0, las claves también pueden ser especificadas usando la
notación de Clark, en la forma <literal>{namespace}type</literal>, para asociar
un tipo de un espacio de nombres XML específico, por ejemplo
<literal>'{http://example.com}foo'</literal>.
</simpara>
<para>
La opción <literal>typemap</literal> es un array cuyas claves son
<literal>type_name</literal>, <literal>type_ns</literal> (URI del espacio de nombres),
Expand Down
30 changes: 29 additions & 1 deletion reference/soap/soapserver/setpersistence.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 89ae180a851621c308f0ea4604ff2e919aa57a7f Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: d20d66d9c76ff98dceb853aeb86794fe9d657669 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="soapserver.setpersistence" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand Down Expand Up @@ -73,6 +73,34 @@
</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>
<constant>SOAP_PERSISTENCE_SESSION</constant> ahora funciona cuando la extensión
session está compilada como módulo compartido; anteriormente fallaba
silenciosamente.
<methodname>SoapServer::setPersistence</methodname> ahora también lanza un
<exceptionname>Error</exceptionname> cuando se solicita
<constant>SOAP_PERSISTENCE_SESSION</constant> mientras que la extensión session
no está disponible.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down
11 changes: 10 additions & 1 deletion reference/soap/soapvar/construct.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: fe4e8b87d18f17394e7177917c498774b062448c Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: d20d66d9c76ff98dceb853aeb86794fe9d657669 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="soapvar.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand Down Expand Up @@ -90,6 +90,15 @@
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Una instancia de <classname>DateTimeInterface</classname> utilizada como valor
de un elemento <literal>xsd:dateTime</literal>, o de un tipo de fecha y hora
similar, ahora es serializada en su representación ISO 8601, en lugar de ser
serializada como una cadena vacía.
</entry>
</row>
<row>
<entry>8.0.3</entry>
<entry>
Expand Down