[DOC-CVS] [doc-en] master: Sockets: add changelog entries for PHP 8.5 changes (#5535)
[email protected] (Louis-Arnaud via GitHub) Mon, 11 May 2026 18:03:08 +0000
| Newsgroups | php.doc.cvs |
|---|---|
| Message-ID | <[email protected]> |
Author: Louis-Arnaud (lacatoire)
Committer: GitHub (web-flow)
Pusher: jordikroon
Date: 2026-05-11T20:03:05+02:00
Commit: https://github.com/php/doc-en/commit/890cc22d38fa747c9930fd0d5984c170f2490c1b
Raw diff: https://github.com/php/doc-en/commit/890cc22d38fa747c9930fd0d5984c170f2490c1b.diff
Sockets: add changelog entries for PHP 8.5 changes (#5535)
* Sockets: add changelog entries for PHP 8.5 changes
Changed paths:
M reference/sockets/constants.xml
M reference/sockets/functions/socket-addrinfo-lookup.xml
M reference/sockets/functions/socket-bind.xml
M reference/sockets/functions/socket-create-listen.xml
M reference/sockets/functions/socket-create.xml
M reference/sockets/functions/socket-getsockname.xml
M reference/sockets/functions/socket-sendto.xml
M reference/sockets/functions/socket-set-option.xml
Diff:
diff --git a/reference/sockets/constants.xml b/reference/sockets/constants.xml
index 9b896f8f4f7f..e1e4b9ada057 100644
--- a/reference/sockets/constants.xml
+++ b/reference/sockets/constants.xml
@@ -44,7 +44,22 @@
</term>
<listitem>
<simpara>
- Available as of PHP 8.3.0 (FreeBSD only)
+ Socket address family for the FreeBSD <literal>divert(4)</literal>
+ interface, used to receive packets diverted by the firewall.
+ Available as of PHP 8.3.0 (FreeBSD only).
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.af-packet">
+ <term>
+ <constant>AF_PACKET</constant>
+ (<type>int</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Socket address family for low-level packet sockets, used to send
+ and receive raw packets at the device-driver (OSI layer 2) level.
+ Available as of PHP 8.5.0 (Linux only).
</simpara>
</listitem>
</varlistentry>
diff --git a/reference/sockets/functions/socket-addrinfo-lookup.xml b/reference/sockets/functions/socket-addrinfo-lookup.xml
index 40aee9e5ccf7..6bb136c32241 100644
--- a/reference/sockets/functions/socket-addrinfo-lookup.xml
+++ b/reference/sockets/functions/socket-addrinfo-lookup.xml
@@ -73,6 +73,15 @@
</row>
</thead>
<tbody>
+ <row>
+ <entry>8.5.0</entry>
+ <entry>
+ Now throws a <exceptionname>TypeError</exceptionname> if any value of
+ the <parameter>hints</parameter> array cannot be cast to int, and may
+ throw a <exceptionname>ValueError</exceptionname> if any of these
+ values overflow.
+ </entry>
+ </row>
<row>
<entry>8.0.0</entry>
<entry>
diff --git a/reference/sockets/functions/socket-bind.xml b/reference/sockets/functions/socket-bind.xml
index e9c073945155..0d93bd9252bc 100644
--- a/reference/sockets/functions/socket-bind.xml
+++ b/reference/sockets/functions/socket-bind.xml
@@ -86,6 +86,13 @@
</row>
</thead>
<tbody>
+ <row>
+ <entry>8.5.0</entry>
+ <entry>
+ Now throws a <exceptionname>ValueError</exceptionname> when
+ <parameter>port</parameter> is lower than 0 or greater than 65535.
+ </entry>
+ </row>
&sockets.changelog.socket-param;
</tbody>
</tgroup>
diff --git a/reference/sockets/functions/socket-create-listen.xml b/reference/sockets/functions/socket-create-listen.xml
index 8c16451d59cd..802431c19208 100644
--- a/reference/sockets/functions/socket-create-listen.xml
+++ b/reference/sockets/functions/socket-create-listen.xml
@@ -74,6 +74,13 @@
</row>
</thead>
<tbody>
+ <row>
+ <entry>8.5.0</entry>
+ <entry>
+ Now throws a <exceptionname>ValueError</exceptionname> when
+ <parameter>port</parameter> is lower than 0 or greater than 65535.
+ </entry>
+ </row>
<row>
<entry>8.4.0</entry>
<entry>
diff --git a/reference/sockets/functions/socket-create.xml b/reference/sockets/functions/socket-create.xml
index 709dc6c90ed1..d61481929f11 100644
--- a/reference/sockets/functions/socket-create.xml
+++ b/reference/sockets/functions/socket-create.xml
@@ -222,6 +222,12 @@
</row>
</thead>
<tbody>
+ <row>
+ <entry>8.5.0</entry>
+ <entry>
+ Now supports creating <constant>AF_PACKET</constant> family sockets.
+ </entry>
+ </row>
<row>
<entry>8.0.0</entry>
<entry>
diff --git a/reference/sockets/functions/socket-getsockname.xml b/reference/sockets/functions/socket-getsockname.xml
index e1ce522bde5f..08911aa0066b 100644
--- a/reference/sockets/functions/socket-getsockname.xml
+++ b/reference/sockets/functions/socket-getsockname.xml
@@ -90,6 +90,13 @@
</row>
</thead>
<tbody>
+ <row>
+ <entry>8.5.0</entry>
+ <entry>
+ Now retrieves the interface index and its string representation when
+ used on an <constant>AF_PACKET</constant> family socket.
+ </entry>
+ </row>
&sockets.changelog.socket-param;
</tbody>
</tgroup>
diff --git a/reference/sockets/functions/socket-sendto.xml b/reference/sockets/functions/socket-sendto.xml
index 9dc952c5206b..89881b4e499e 100644
--- a/reference/sockets/functions/socket-sendto.xml
+++ b/reference/sockets/functions/socket-sendto.xml
@@ -137,6 +137,13 @@
</row>
</thead>
<tbody>
+ <row>
+ <entry>8.5.0</entry>
+ <entry>
+ Now throws a <exceptionname>ValueError</exceptionname> when
+ <parameter>port</parameter> is lower than 0 or greater than 65535.
+ </entry>
+ </row>
&sockets.changelog.socket-param;
<row>
<entry>8.0.0</entry>
diff --git a/reference/sockets/functions/socket-set-option.xml b/reference/sockets/functions/socket-set-option.xml
index 7f6c8ff9a444..9500de38af70 100644
--- a/reference/sockets/functions/socket-set-option.xml
+++ b/reference/sockets/functions/socket-set-option.xml
@@ -90,6 +90,17 @@
</row>
</thead>
<tbody>
+ <row>
+ <entry>8.5.0</entry>
+ <entry>
+ Now throws an exception when <constant>MCAST_LEAVE_GROUP</constant>
+ or <constant>MCAST_LEAVE_SOURCE_GROUP</constant> is used and the
+ value is not a valid object or array, and throws a
+ <exceptionname>ValueError</exceptionname> when a multicast option is
+ used on a socket that is not of <constant>AF_INET</constant> or
+ <constant>AF_INET6</constant> family.
+ </entry>
+ </row>
&sockets.changelog.socket-param;
</tbody>
</tgroup>