Skip to content

WIP: start writing migration guide #3822

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
merged 35 commits into from
Oct 16, 2024
Merged

WIP: start writing migration guide #3822

Show file tree
Hide file tree
Changes from 17 commits
Commits
Show all changes
35 commits
Select commit Hold shift + click to select a range
574d33a
WIP: start writing migration guide with new constants
Girgias Oct 2, 2024
840a6e8
Add Windows support section
Girgias Oct 2, 2024
7d66021
Add other changes page
Girgias Oct 2, 2024
05d5347
Add removed extensions
Girgias Oct 2, 2024
c44b06c
Add new classes
Girgias Oct 2, 2024
bc47aff
Add Dba\Connection class which is only mentioned in BC Breaks
Girgias Oct 2, 2024
8d57a7b
Fix entities
Girgias Oct 3, 2024
21750a5
Add new functions page
Girgias Oct 3, 2024
71c6110
Complete from stuff found via UPGRADING move
Girgias Oct 3, 2024
a8bd656
Add deprecation page
Girgias Oct 5, 2024
0441d4b
Use simplelist
Girgias Oct 5, 2024
3451d40
Add AVX support for Windows mention
Girgias Oct 5, 2024
fbf5135
Apply changes from fixes to UPGRADING
Girgias Oct 13, 2024
f39024b
Add incompatibilities page
Girgias Oct 13, 2024
3e3c27f
Some fixes
Girgias Oct 14, 2024
163ff2a
Add new feature page
Girgias Oct 14, 2024
9e7e396
Detail SimpleXMLElement incompatibility more
Girgias Oct 15, 2024
1be1bf7
Fix title
Girgias Oct 15, 2024
cd64356
Move exceptions from other changes to incompatibility
Girgias Oct 15, 2024
6fc846d
Some imprevements to GD exceptions
Girgias Oct 15, 2024
16ae1a4
Fix typo
Girgias Oct 15, 2024
8421fda
Wording fixes
Girgias Oct 15, 2024
3a82b47
Fix tag
Girgias Oct 15, 2024
f3cd002
PDO Class constants
Girgias Oct 15, 2024
2bc52b5
Remove uselss apostropheé
Girgias Oct 15, 2024
696f884
Fix weird spacing
Girgias Oct 15, 2024
f28d803
Use lowercase null wording
Girgias Oct 15, 2024
8347eca
Move str function performance to Standard
Girgias Oct 15, 2024
d12836d
PCNTL enum not global constants
Girgias Oct 15, 2024
57974fa
Fill in TODO for aziv
Girgias Oct 16, 2024
52cfde5
Add some of the new namespaces Dom classes
Girgias Oct 16, 2024
69a1585
Update removed extension text
Girgias Oct 16, 2024
5492e73
Credit Colin Percival
Girgias Oct 16, 2024
d065458
Nits and markup reviews
Girgias Oct 16, 2024
7880dce
Typo
Girgias Oct 16, 2024
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
55 changes: 55 additions & 0 deletions appendices/migration84.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
<?xml version="1.0" encoding="utf-8"?>
<appendix xml:id="migration84" xmlns="http://docbook.org/ns/docbook">
<title>Migrating from PHP 8.3.x to PHP 8.4.x</title>

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

<para>
&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>.
</para>

&appendices.migration84.new-features;
&appendices.migration84.new-classes;
&appendices.migration84.new-functions;
&appendices.migration84.constants;
&appendices.migration84.incompatible;
&appendices.migration84.deprecated;
&appendices.migration84.removed-extensions;
&appendices.migration84.other-changes;
&appendices.migration84.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
-->
339 changes: 339 additions & 0 deletions appendices/migration84/constants.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,339 @@
<?xml version="1.0" encoding="utf-8"?>
<sect1 xml:id="migration84.constants">
<title>New Global Constants</title>

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

<simplelist>
<member>
<constant>PHP_OUTPUT_HANDLER_PROCESSED</constant>
</member>
<member>
<constant>PHP_SBINDIR</constant>
</member>
</simplelist>
</sect2>

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

<simplelist>
<member>
<constant>CURL_HTTP_VERSION_3</constant>
</member>
<member>
<constant>CURL_HTTP_VERSION_3ONLY</constant>
</member>
<member>
<constant>CURL_TCP_KEEPCNT</constant>
</member>
<member>
<constant>CURLOPT_PREREQFUNCTION</constant>
</member>
<member>
<constant>CURL_PREREQFUNC_OK</constant>
</member>
<member>
<constant>CURL_PREREQFUNC_ABORT</constant>
</member>
<member>
<constant>CURLOPT_SERVER_RESPONSE_TIMEOUT</constant>
</member>
<member>
<constant>CURLOPT_DEBUGFUNCTION</constant>
</member>
<member>
<constant>CURLINFO_TEXT</constant>
</member>
<member>
<constant>CURLINFO_HEADER_IN</constant>
</member>
<member>
<constant>CURLINFO_DATA_IN</constant>
</member>
<member>
<constant>CURLINFO_DATA_OUT</constant>
</member>
<member>
<constant>CURLINFO_SSL_DATA_OUT</constant>
</member>
<member>
<constant>CURLINFO_SSL_DATA_IN</constant>
</member>
<member>
<constant>CURLINFO_POSTTRANSFER_TIME_T</constant>
</member>
</simplelist>
</sect2>

<sect2 xml:id="migration84.constants.intl">
<title>Intl</title>

<simplelist>
<member>
<constant>PATTERN</constant>
(<classname>IntlDateFormatter</classname>)
</member>
<member>
<constant>PROPERTY_IDS_UNARY_OPERATOR</constant>
(<classname>IntlChar</classname>)
</member>
<member>
<constant>PROPERTY_ID_COMPAT_MATH_START</constant>
<!-- for mathematical identifier profiling purpose -->
</member>
<member>
<constant>PROPERTY_ID_COMPAT_MATH_CONTINUE</constant>
<!-- for mathematical identifier profiling purpose -->
</member>
</simplelist>
</sect2>

<sect2 xml:id="migration84.constants.ldap">
<title>LDAP</title>

<simplelist>
<member>
<constant>LDAP_OPT_X_TLS_PROTOCOL_MAX</constant>
</member>
<member>
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_3</constant>
</member>
</simplelist>
</sect2>

<sect2 xml:id="migration84.constants.libxml">
<title>libxml</title>

<simplelist>
<member>
<constant>LIBXML_RECOVER</constant>
</member>
<member>
<constant>LIBXML_NO_XXE</constant>.
This is used together with <constant>LIBXML_NOENT</constant>
when entity substitution should be performed,
while disallowing external entity loading.
This constant is available as of libxml2 2.13.
</member>
</simplelist>
</sect2>

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

<simplelist>
<member>
<constant>MYSQLI_TYPE_VECTOR</constant>
</member>
</simplelist>
</sect2>

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

<simplelist>
<member><constant>X509_PURPOSE_OCSP_HELPER</constant></member>
<member><constant>X509_PURPOSE_TIMESTAMP_SIGN</constant></member>
</simplelist>
</sect2>

<sect2 xml:id="migration84.constants.pcntl">
<title>PCNTL</title>

<!-- TODO Isn't this a new Enum? -->
<simplelist>
<member>
<constant>Pcntl\QosClass::Background</constant> (macOS only)
</member>
<member>
<constant>Pcntl\QosClass::Default</constant> (macOS only)
</member>
<member>
<constant>Pctnl\QosClass::UserInteractive</constant> (macOS only)
</member>
<member>
<constant>Pcntl\QosClass::UserInitiated</constant> (macOS only)
</member>
<member>
<constant>Pcntl\QosClass::Utility</constant> (macOS only)
</member>
<!-- END OF TODO -->
<member>
<constant>SIGCKPT</constant> (DragonFlyBSD only)
</member>
<member>
<constant>SIGCKPTEXIT</constant> (DragonFlyBSD only)
</member>
<member>
<constant>WEXITED</constant>
</member>
<member>
<constant>WSTOPPED</constant>
</member>
<member>
<constant>WNOWAIT</constant>
</member>
<member>
<constant>P_ALL</constant>
</member>
<member>
<constant>P_PID</constant>
</member>
<member>
<constant>P_PGID</constant>
</member>
<member>
<constant>P_PIDFD</constant> (Linux only)
</member>
<member>
<constant>P_UID</constant> (NetBSD/FreeBSD only)
</member>
<member>
<constant>P_GID</constant> (NetBSD/FreeBSD only)
</member>
<member>
<constant>P_SID</constant> (NetBSD/FreeBSD only)
</member>
<member>
<constant>P_JAILID</constant> (FreeBSD only)
</member>
</simplelist>
</sect2>

<sect2 xml:id="migration84.constants.pgsql">
<title>PGSQL</title>

<simplelist>
<member><constant>PGSQL_TUPLES_CHUNK</constant></member>
</simplelist>
</sect2>

<sect2 xml:id="migration84.constants.posix">
<title>POSIX</title>

<simplelist>
<member><constant>POSIX_SC_CHILD_MAX</constant></member>
<member><constant>POSIX_SC_CLK_TCK</constant></member>
</simplelist>
</sect2>

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

<simpara>
The following socket options are now defined if they are supported:
</simpara>

<simplelist>
<member>
<constant>SO_EXCLUSIVEADDRUSE</constant> (Windows only)
</member>
<member>
<constant>SOCK_CONN_DGRAM</constant> (NetBSD only)
</member>
<member>
<constant>SOCK_DCCP</constant> (NetBSD only)
</member>
<member>
<constant>TCP_SYNCNT</constant> (Linux only)
</member>
<member>
<constant>SO_EXCLBIND</constant> (Solaris/Illumos only)
</member>
<member>
<constant>SO_NOSIGPIPE</constant> (macOS and FreeBSD)
</member>
<member>
<constant>SO_LINGER_SEC</constant> (macOS only)
</member>
<member>
<constant>IP_PORTRANGE</constant> (FreeBSD/NetBSD/OpenBSD only)
</member>
<member>
<constant>IP_PORTRANGE_DEFAULT</constant> (FreeBSD/NetBSD/OpenBSD only)
</member>
<member>
<constant>IP_PORTRANGE_HIGH</constant> (FreeBSD/NetBSD/OpenBSD only)
</member>
<member>
<constant>IP_PORTRANGE_LOW</constant> (FreeBSD/NetBSD/OpenBSD only)
</member>
<member>
<constant>SOCK_NONBLOCK</constant>
</member>
<member>
<constant>SOCK_CLOEXEC</constant>
</member>
<member>
<constant>SO_BINDTOIFINDEX</constant>
</member>
</simplelist>
</sect2>

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

<simplelist>
<member>
<constant>SODIUM_CRYPTO_AEAD_AEGIS128L_KEYBYTES</constant>
</member>
<member>
<constant>SODIUM_CRYPTO_AEAD_AEGIS128L_NSECBYTES</constant>
</member>
<member>
<constant>SODIUM_CRYPTO_AEAD_AEGIS128L_NPUBBYTES</constant>
</member>
<member>
<constant>SODIUM_CRYPTO_AEAD_AEGIS128L_ABYTES</constant>
</member>
<member>
<constant>SODIUM_CRYPTO_AEAD_AEGIS256_KEYBYTES</constant>
</member>
<member>
<constant>SODIUM_CRYPTO_AEAD_AEGIS256_NSECBYTES</constant>
</member>
<member>
<constant>SODIUM_CRYPTO_AEAD_AEGIS256_NPUBBYTES</constant>
</member>
<member>
<constant>SODIUM_CRYPTO_AEAD_AEGIS256_ABYTES</constant>
</member>
</simplelist>
</sect2>

<sect2 xml:id="migration84.constants.xml">
<title>XML</title>

<simplelist>
<member>
<constant>XML_OPTION_PARSE_HUGE</constant>
which allows parsing large inputs with
<function>xml_parse</function> and
<function>xml_parse_into_struct</function>.
</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