Sockets: add changelog entries for PHP 8.5 changes (#5535)

* Sockets: add changelog entries for PHP 8.5 changes

Author: lacatoire

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>

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>

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>

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>

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>

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>

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>

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>