[doc-en] master: Document missing PHP 8.4.0 constants and deprecations (#5368)
Author: Louis-Arnaud (lacatoire)
Committer: GitHub (web-flow)
Pusher: jordikroon
Date: 2026-06-10T21:57:23+02:00
Commit: https://github.com/php/doc-en/commit/7c4e8d8219e9a65553cfc378bb46405bf6b2ed53
Raw diff: https://github.com/php/doc-en/commit/7c4e8d8219e9a65553cfc378bb46405bf6b2ed53.diff
Document missing PHP 8.4.0 constants and deprecations (#5368)
- Session: add deprecation warning for SID constant
- SOAP: add deprecation note for SOAP_FUNCTIONS_ALL constant
- LDAP: add LDAP_OPT_X_TLS_PROTOCOL_MAX and LDAP_OPT_X_TLS_PROTOCOL_TLS1_3
- LDAP: update LDAP_OPT_X_TLS_PROTOCOL_MIN to mention TLS1_3
- OpenSSL: add X509_PURPOSE_OCSP_HELPER and X509_PURPOSE_TIMESTAMP_SIGN
Changed paths:
M reference/ldap/constants.xml
M reference/openssl/constants.xml
M reference/session/constants.xml
M reference/soap/constants.xml
Diff:
diff --git a/reference/ldap/constants.xml b/reference/ldap/constants.xml
index f98d46470b49..d6a51735449f 100644
--- a/reference/ldap/constants.xml
+++ b/reference/ldap/constants.xml
@@ -373,7 +373,19 @@
</term>
<listitem>
<simpara>
- Specifies the minimum protocol version. This can be one of:
<constant>LDAP_OPT_X_TLS_PROTOCOL_SSL2</constant>,<constant>LDAP_OPT_X_TLS_PROTOCOL_SSL3</constant>,
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_0</constant>,
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_1</constant>,
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_2</constant>
+ Specifies the minimum protocol version. This can be one of:
<constant>LDAP_OPT_X_TLS_PROTOCOL_SSL2</constant>,<constant>LDAP_OPT_X_TLS_PROTOCOL_SSL3</constant>,
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_0</constant>,
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_1</constant>,
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_2</constant>,
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_3</constant>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.ldap-opt-x-tls-protocol-max">
+ <term>
+ <constant>LDAP_OPT_X_TLS_PROTOCOL_MAX</constant>
+ (<type>int</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Specifies the maximum protocol version.
+ Available as of PHP 8.4.0.
</simpara>
</listitem>
</varlistentry>
@@ -1155,6 +1167,18 @@
</simpara>
</listitem>
</varlistentry>
+ <varlistentry xml:id="constant.ldap-opt-x-tls-protocol-tls1-3">
+ <term>
+ <constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_3</constant>
+ (<type>int</type>)
+ </term>
+ <listitem>
+ <simpara>
+ The TLS 1.3 protocol.
+ Available as of PHP 8.4.0.
+ </simpara>
+ </listitem>
+ </varlistentry>
</variablelist>
</appendix>
diff --git a/reference/openssl/constants.xml b/reference/openssl/constants.xml
index 293be48f5cd9..b9dcb11b4a36 100644
--- a/reference/openssl/constants.xml
+++ b/reference/openssl/constants.xml
@@ -83,6 +83,28 @@
</simpara>
</listitem>
</varlistentry>
+ <varlistentry xml:id="constant.x509-purpose-ocsp-helper">
+ <term>
+ <constant>X509_PURPOSE_OCSP_HELPER</constant>
+ (<type>int</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Available as of PHP 8.4.0.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry xml:id="constant.x509-purpose-timestamp-sign">
+ <term>
+ <constant>X509_PURPOSE_TIMESTAMP_SIGN</constant>
+ (<type>int</type>)
+ </term>
+ <listitem>
+ <simpara>
+ Available as of PHP 8.4.0.
+ </simpara>
+ </listitem>
+ </varlistentry>
</variablelist>
</section>
diff --git a/reference/session/constants.xml b/reference/session/constants.xml
index 617237181cc2..4199b094155e 100644
--- a/reference/session/constants.xml
+++ b/reference/session/constants.xml
@@ -16,6 +16,11 @@
if session ID was set in an appropriate session cookie. This is
the same id as the one returned by <function>session_id</function>.
</simpara>
+ <warning>
+ <simpara>
+ This constant has been deprecated as of PHP 8.4.0.
+ </simpara>
+ </warning>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-session-disabled">
diff --git a/reference/soap/constants.xml b/reference/soap/constants.xml
index 2d8072ce79a8..2fff5bf2b416 100644
--- a/reference/soap/constants.xml
+++ b/reference/soap/constants.xml
@@ -60,7 +60,9 @@
(<type>int</type>)
</entry>
<entry>999</entry>
- <entry/>
+ <entry>
+ Deprecated as of PHP 8.4.0.
+ </entry>
</row>
<row xml:id="constant.soap-encoded">
<entry>
Thread (1 message)
- Louis-Arnaud via GitHub