[doc-en] master: Document remaining PHP 8.5 changes for DOM, POSIX, Reflection, Sockets and SOAP (#6022)

Author: Louis-Arnaud (lacatoire) Committer: GitHub (web-flow) Pusher: lacatoire Date: 2026-11-01T21:41:44+01:00 Commit: https://github.com/php/doc-en/commit/2a12c0448cbc9941bb4817adf537c27139e8bbe7 Raw diff: https://github.com/php/doc-en/commit/2a12c0448cbc9941bb4817adf537c27139e8bbe7.diff Document remaining PHP 8.5 changes for DOM, POSIX, Reflection, Sockets and SOAP (#6022) Changed paths: M reference/dom/dom/dom-element.xml M reference/posix/constants.xml M reference/posix/functions/posix-sysconf.xml M reference/reflection/reflectionattribute/newinstance.xml M reference/soap/soapclient/gettypes.xml M reference/sockets/functions/socket-bind.xml Diff: diff --git a/reference/dom/dom/dom-element.xml b/reference/dom/dom/dom-element.xml index eac33f218a80..8038cf02d277 100644 --- a/reference/dom/dom/dom-element.xml +++ b/reference/dom/dom/dom-element.xml @@ -261,7 +261,8 @@ <row> <entry>8.5.0</entry> <entry> - Added the <methodname>Dom\Element::getElementsByClassName</methodname> method. + Added the <methodname>Dom\Element::getElementsByClassName</methodname> + and <methodname>Dom\Element::insertAdjacentHTML</methodname> methods. </entry> </row> </tbody> diff --git a/reference/posix/constants.xml b/reference/posix/constants.xml index 8cba6df61120..d091756530b7 100644 --- a/reference/posix/constants.xml +++ b/reference/posix/constants.xml @@ -597,6 +597,18 @@ </simpara> </listitem> </varlistentry> + <varlistentry xml:id="constant.posix-sc-open-max"> + <term> + <constant>POSIX_SC_OPEN_MAX</constant> + (<type>int</type>) + </term> + <listitem> + <simpara> + The maximum number of files that a process can have open at any time. + Available as of PHP 8.5.0. + </simpara> + </listitem> + </varlistentry> </variablelist> </section> </appendix> diff --git a/reference/posix/functions/posix-sysconf.xml b/reference/posix/functions/posix-sysconf.xml index 43df9fa0344a..bbba0f7773b5 100644 --- a/reference/posix/functions/posix-sysconf.xml +++ b/reference/posix/functions/posix-sysconf.xml @@ -23,12 +23,13 @@ <varlistentry> <term><parameter>conf_id</parameter></term> <listitem> - <para> + <simpara> Identifier of the variable with the following constants <constant>POSIX_SC_ARG_MAX</constant>, <constant>POSIX_SC_PAGESIZE</constant>, <constant>POSIX_SC_NPROCESSORS_CONF</constant>, <constant>POSIX_SC_NPROCESSORS_ONLN</constant>, - <constant>POSIX_SC_CHILD_MAX</constant>, <constant>POSIX_SC_CLK_TCK</constant> - </para> + <constant>POSIX_SC_CHILD_MAX</constant>, <constant>POSIX_SC_CLK_TCK</constant>, + <constant>POSIX_SC_OPEN_MAX</constant> + </simpara> </listitem> </varlistentry> </variablelist> diff --git a/reference/reflection/reflectionattribute/newinstance.xml b/reference/reflection/reflectionattribute/newinstance.xml index 6c0fc9f54a09..3af067b1d399 100644 --- a/reference/reflection/reflectionattribute/newinstance.xml +++ b/reference/reflection/reflectionattribute/newinstance.xml @@ -29,6 +29,40 @@ </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <simpara> + Throws an <exceptionname>Error</exceptionname> if the attribute is applied + to a target it cannot be used on. For internal attributes, this happens + here instead of at compile time when the declaration uses + <link linkend="class.delayedtargetvalidation">#[\DelayedTargetValidation]</link>. + </simpara> + </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> + Now throws an <exceptionname>Error</exceptionname> for an internal + attribute applied to an invalid target when the target validation was + delayed with <link linkend="class.delayedtargetvalidation">#[\DelayedTargetValidation]</link>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file Local variables: diff --git a/reference/soap/soapclient/gettypes.xml b/reference/soap/soapclient/gettypes.xml index 55d1878e0ac3..a38ff56d6b12 100644 --- a/reference/soap/soapclient/gettypes.xml +++ b/reference/soap/soapclient/gettypes.xml @@ -28,6 +28,33 @@ <para> The <type>array</type> of SOAP types, detailing all structures and types. </para> + <simpara> + A type restricted to a set of enumerated values is listed with those values + in braces, for example <literal>string enumItem {test1, test2}</literal>. + </simpara> + </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> + Enumerated values are now included in the description of the types + that define them. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </refsect1> <refsect1 role="examples"> diff --git a/reference/sockets/functions/socket-bind.xml b/reference/sockets/functions/socket-bind.xml index 0d93bd9252bc..7fa415194507 100644 --- a/reference/sockets/functions/socket-bind.xml +++ b/reference/sockets/functions/socket-bind.xml @@ -47,6 +47,11 @@ <parameter>address</parameter> is the path of a Unix-domain socket (e.g. <filename>/tmp/my.sock</filename>). </para> + <simpara> + If the socket is of the <constant>AF_PACKET</constant> family, the + <parameter>address</parameter> is the name of a network interface + (e.g. <literal>eth0</literal>). + </simpara> </listitem> </varlistentry> <varlistentry> @@ -86,6 +91,12 @@ </row> </thead> <tbody> + <row> + <entry>8.5.0</entry> + <entry> + Now supports binding <constant>AF_PACKET</constant> family sockets. + </entry> + </row> <row> <entry>8.5.0</entry> <entry>