Skip to content

PHP 8.6 migration guide #5900

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
jordikroon merged 17 commits into from
Oct 13, 2026
Merged

PHP 8.6 migration guide #5900

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
4d036b3
Added initial files for 8.6 migration
jordikroon Sep 28, 2026
81885f1
Document new classes & functions
jordikroon Sep 28, 2026
fdcaf3a
Document deprecations
jordikroon Sep 28, 2026
af1f242
Improve documentation of deprecations
jordikroon Sep 28, 2026
8f5a487
Document Windows changes
jordikroon Sep 30, 2026
76c5481
Document Constant changes
jordikroon Sep 30, 2026
d3fae3d
Document new features
jordikroon Sep 30, 2026
ee16f84
Document more examples for features
jordikroon Sep 30, 2026
98db2ed
Document incompatibilities features
jordikroon Sep 30, 2026
d671404
Document incompatibilities features
jordikroon Sep 30, 2026
b0e11b7
Document other changes
jordikroon Sep 30, 2026
2ae1edb
Document other changes
jordikroon Sep 30, 2026
9829f3f
minor cleanup
jordikroon Sep 30, 2026
8b2d215
Apply batched suggestions from code review
jordikroon Oct 6, 2026
2335a03
Remove EOF functions from migration guide
jordikroon Oct 8, 2026
26eb28e
Fix incorrect entity ref
jordikroon Oct 13, 2026
ecc7bdc
Document php-src#c01c9d009c1db68a87dabd45b128f544913a63f2
jordikroon Oct 13, 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
56 changes: 56 additions & 0 deletions appendices/migration86.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
<?xml version="1.0" encoding="utf-8"?>
<appendix xml:id="migration86" xmlns="http://docbook.org/ns/docbook">
<title>Migrating from PHP 8.5.x to PHP 8.6.x</title>

<simpara>
This new minor version brings with it a number of
<link linkend="migration86.new-features">new features</link> and a
<link linkend="migration86.incompatible">few incompatibilities</link>
that should be tested for before switching PHP versions in production
environments.
</simpara>

<simpara>
&manual.migration.seealso;
<link linkend="migration71">7.1.x</link>,
<link linkend="migration72">7.2.x</link>,
<link linkend="migration73">7.3.x</link>,
<link linkend="migration74">7.4.x</link>,
<link linkend="migration80">8.0.x</link>,
<link linkend="migration81">8.1.x</link>,
<link linkend="migration82">8.2.x</link>,
<link linkend="migration83">8.3.x</link>,
<link linkend="migration84">8.4.x</link>,
<link linkend="migration85">8.5.x</link>.
</simpara>

&appendices.migration86.new-features;
&appendices.migration86.new-classes;
&appendices.migration86.new-functions;
&appendices.migration86.constants;
&appendices.migration86.incompatible;
&appendices.migration86.deprecated;
&appendices.migration86.other-changes;
&appendices.migration86.windows-support;

</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
187 changes: 187 additions & 0 deletions appendices/migration86/constants.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,187 @@
<?xml version="1.0" encoding="utf-8"?>
<sect1 xml:id="migration86.constants">
<title>New Global Constants</title>

<sect2 xml:id="migration86.constants.core">
<title>Core</title>

<simplelist>
<member>
<constant>ARRAY_FILTER_USE_VALUE</constant>
</member>
<member>
<constant>STREAM_CRYPTO_STATUS_NONE</constant>
</member>
<member>
<constant>STREAM_CRYPTO_STATUS_WANT_READ</constant>
</member>
<member>
<constant>STREAM_CRYPTO_STATUS_WANT_WRITE</constant>
</member>
</simplelist>
</sect2>

<sect2 xml:id="migration86.constants.curl">
<title>cURL</title>

<simplelist>
<member>
<constant>CURLINFO_SIZE_DELIVERED</constant> (libcurl >= 8.20.0)
</member>
<member>
<constant>CURLOPT_SEEKFUNCTION</constant>
</member>
<member>
<constant>CURL_SEEKFUNC_OK</constant>
</member>
<member>
<constant>CURL_SEEKFUNC_FAIL</constant>
</member>
<member>
<constant>CURL_SEEKFUNC_CANTSEEK</constant>
</member>
<member>
<constant>CURL_READFUNC_ABORT</constant>
</member>
</simplelist>
</sect2>

<sect2 xml:id="migration86.constants.mysqli">
<title>MySQLi</title>

<simplelist>
<member>
<constant>MYSQLI_OPT_COMPRESS</constant>
</member>
</simplelist>
</sect2>

<sect2 xml:id="migration86.constants.openssl">
<title>OpenSSL</title>

<simplelist>
<member><constant>OPENSSL_RSA_PSS_SALTLEN_DIGEST</constant></member>
<member><constant>OPENSSL_RSA_PSS_SALTLEN_AUTO</constant></member>
<member><constant>OPENSSL_RSA_PSS_SALTLEN_MAX</constant></member>
</simplelist>
</sect2>

<sect2 xml:id="migration86.constants.sockets">
<title>Sockets</title>

<simplelist>
<member>
<constant>TCP_USER_TIMEOUT</constant> (Linux only)
</member>
<member>
<constant>AF_UNSPEC</constant>
</member>
<member>
<constant>EAI_BADFLAGS</constant>
</member>
<member>
<constant>EAI_NONAME</constant>
</member>
<member>
<constant>EAI_AGAIN</constant>
</member>
<member>
<constant>EAI_FAIL</constant>
</member>
<member>
<constant>EAI_NODATA</constant>
</member>
<member>
<constant>EAI_FAMILY</constant>
</member>
<member>
<constant>EAI_SOCKTYPE</constant>
</member>
<member>
<constant>EAI_SERVICE</constant>
</member>
<member>
<constant>EAI_ADDRFAMILY</constant>
</member>
<member>
<constant>EAI_SYSTEM</constant>
</member>
<member>
<constant>EAI_OVERFLOW</constant>
</member>
<member>
<constant>EAI_INPROGRESS</constant>
</member>
<member>
<constant>EAI_CANCELED</constant>
</member>
<member>
<constant>EAI_NOTCANCELED</constant>
</member>
<member>
<constant>EAI_ALLDONE</constant>
</member>
<member>
<constant>EAI_INTR</constant>
</member>
<member>
<constant>EAI_IDN_ENCODE</constant>
</member>
<member>
<constant>SO_DETACH_REUSEPORT_BPF</constant> (Linux only)
</member>
</simplelist>
</sect2>

<sect2 xml:id="migration86.constants.sodium">
<title>Sodium</title>

<simplelist>
<member><constant>SODIUM_CRYPTO_IPCRYPT_BYTES</constant></member>
<member><constant>SODIUM_CRYPTO_IPCRYPT_KEYBYTES</constant></member>
<member><constant>SODIUM_CRYPTO_IPCRYPT_ND_KEYBYTES</constant></member>
<member><constant>SODIUM_CRYPTO_IPCRYPT_ND_TWEAKBYTES</constant></member>
<member><constant>SODIUM_CRYPTO_IPCRYPT_ND_INPUTBYTES</constant></member>
<member><constant>SODIUM_CRYPTO_IPCRYPT_ND_OUTPUTBYTES</constant></member>
<member><constant>SODIUM_CRYPTO_IPCRYPT_NDX_KEYBYTES</constant></member>
<member><constant>SODIUM_CRYPTO_IPCRYPT_NDX_TWEAKBYTES</constant></member>
<member><constant>SODIUM_CRYPTO_IPCRYPT_NDX_INPUTBYTES</constant></member>
<member><constant>SODIUM_CRYPTO_IPCRYPT_NDX_OUTPUTBYTES</constant></member>
<member><constant>SODIUM_CRYPTO_IPCRYPT_PFX_KEYBYTES</constant></member>
<member><constant>SODIUM_CRYPTO_IPCRYPT_PFX_BYTES</constant></member>
<member><constant>SODIUM_CRYPTO_KEM_PUBLICKEYBYTES</constant> (libsodium >= 1.0.22)</member>
<member><constant>SODIUM_CRYPTO_KEM_SECRETKEYBYTES</constant> (libsodium >= 1.0.22)</member>
<member><constant>SODIUM_CRYPTO_KEM_CIPHERTEXTBYTES</constant> (libsodium >= 1.0.22)</member>
<member><constant>SODIUM_CRYPTO_KEM_SHAREDSECRETBYTES</constant> (libsodium >= 1.0.22)</member>
<member><constant>SODIUM_CRYPTO_KEM_SEEDBYTES</constant> (libsodium >= 1.0.22)</member>
<member><constant>SODIUM_CRYPTO_KEM_KEYPAIRBYTES</constant> (libsodium >= 1.0.22)</member>
<member><constant>SODIUM_CRYPTO_KEM_MLKEM768_PUBLICKEYBYTES</constant> (libsodium >= 1.0.22)</member>
<member><constant>SODIUM_CRYPTO_KEM_MLKEM768_SECRETKEYBYTES</constant> (libsodium >= 1.0.22)</member>
<member><constant>SODIUM_CRYPTO_KEM_MLKEM768_CIPHERTEXTBYTES</constant> (libsodium >= 1.0.22)</member>
<member><constant>SODIUM_CRYPTO_KEM_MLKEM768_SHAREDSECRETBYTES</constant> (libsodium >= 1.0.22)</member>
<member><constant>SODIUM_CRYPTO_KEM_MLKEM768_SEEDBYTES</constant> (libsodium >= 1.0.22)</member>
<member><constant>SODIUM_CRYPTO_KEM_MLKEM768_KEYPAIRBYTES</constant> (libsodium >= 1.0.22)</member>
</simplelist>
</sect2>

</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Loading
Loading