Skip to content

PHP 8.3 migration guide. #2780

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
Girgias merged 25 commits into from
Sep 26, 2023
Merged

PHP 8.3 migration guide. #2780

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
8d335e9
Added PHP 8.3 migration guide.
mumumu Sep 21, 2023
11cc340
Update appendices/migration83/new-features.xml
mumumu Sep 21, 2023
dcfdb95
added "Other Changes" page.
mumumu Sep 22, 2023
c701b6d
fixed some libcurl constants version
mumumu Sep 22, 2023
866b4af
fixed whitespace
mumumu Sep 22, 2023
8284f79
Update appendices/migration83/[other-changes|incompatible|deprecated]…
mumumu Sep 23, 2023
72795d5
missing tag tweaks
mumumu Sep 23, 2023
59411bd
added assert* deprecated change to deprecated.xml
mumumu Sep 23, 2023
f80adcf
added missing clsasname|literal tags
mumumu Sep 23, 2023
c76190f
added assert.* ini setting link
mumumu Sep 23, 2023
9dd57ed
tweaked for lines to be broken down into 80 character long
mumumu Sep 23, 2023
f1457f6
addressed review comments
mumumu Sep 24, 2023
07998d2
more tweaks in assining negative value description, FFI incompatible.
mumumu Sep 24, 2023
c733dd1
Adjuct tags further
mumumu Sep 24, 2023
6c4ba00
followed UPGRADING changes (Move things to the right section)
mumumu Sep 24, 2023
c28519b
Update appendices/migration83/new-features.xml
mumumu Sep 24, 2023
e425995
Update appendices/migration83/new-features.xml
mumumu Sep 24, 2023
6d10bbb
fixed Phar::setStub() parameter markup
mumumu Sep 24, 2023
6ee1c29
fixed varname (n+1 -> $n+1)
mumumu Sep 24, 2023
e60aad0
Added missing "Core Changes" section
mumumu Sep 24, 2023
c2c7f47
added "migration83.incompatible.core" section titles
mumumu Sep 24, 2023
c2879da
Apply suggestions from code review
mumumu Sep 25, 2023
ef2618c
fixed check-whitespace error
mumumu Sep 25, 2023
f0e1c5e
added before/after example of range('9', 'A')
mumumu Sep 25, 2023
48b58c1
Apply suggestions from code review, part II.
mumumu Sep 26, 2023
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
54 changes: 54 additions & 0 deletions appendices/migration83.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
<?xml version="1.0" encoding="utf-8"?>
<appendix xml:id="migration83" xmlns="http://docbook.org/ns/docbook" xmlns:phd="http://www.php.net/ns/phd">
<title>Migrating from PHP 8.2.x to PHP 8.3.x</title>

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

<sect1 phd:chunk="false" xml:id="migration83.intro">
<para>
This new minor version brings with it a number of
<link linkend="migration83.new-features">new features</link> and a
<link linkend="migration83.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>.
</para>
</sect1>
</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
-->
337 changes: 337 additions & 0 deletions appendices/migration83/constants.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,337 @@
<?xml version="1.0" encoding="utf-8"?>
<sect1 xml:id="migration83.constants" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>New Global Constants</title>

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

<itemizedlist>
<listitem>
<simpara>
<constant>CURLINFO_CAPATH</constant> (libcurl >= 7.84.0)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>CURLINFO_CAINFO</constant> (libcurl >= 7.84.0)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>CURLOPT_MIME_OPTIONS</constant> (libcurl >= 7.81.0)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>CURLMIMEOPT_FORMESCAPE</constant> (libcurl >= 7.81.0)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>CURLOPT_WS_OPTIONS</constant> (libcurl >= 7.86.0)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>CURLWS_RAW_MODE</constant> (libcurl >= 7.86.0)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>CURLOPT_SSH_HOSTKEYFUNCTION</constant> (libcurl >= 7.84.0)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>CURLOPT_PROTOCOLS_STR</constant> (libcurl >= 7.85.0)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>CURLOPT_REDIR_PROTOCOLS_STR</constant> (libcurl >= 7.85.0)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>CURLOPT_CA_CACHE_TIMEOUT</constant> (libcurl >= 7.87.0)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>CURLOPT_QUICK_EXIT</constant> (libcurl >= 7.87.0)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>CURLKHMATCH_OK</constant> (libcurl >= 7.19.6)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>CURLKHMATCH_MISMATCH</constant> (libcurl >= 7.19.6)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>CURLKHMATCH_MISSING</constant> (libcurl >= 7.19.6)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>CURLKHMATCH_LAST</constant> (libcurl >= 7.19.6)
</simpara>
</listitem>
</itemizedlist>
</sect2>

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

<itemizedlist>
<listitem>
<simpara><constant>MIXED_NUMBERS</constant>
(<classname>Spoofchecker</classname>)</simpara>
</listitem>
<listitem>
<simpara><constant>HIDDEN_OVERLAY</constant>
(<classname>Spoofchecker</classname>)</simpara>
</listitem>
</itemizedlist>
</sect2>

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

<itemizedlist>
<listitem>
<simpara><constant>OPENSSL_CMS_OLDMIMETYPE</constant></simpara>
</listitem>
<listitem>
<simpara><constant>PKCS7_NOOLDMIMETYPE</constant></simpara>
</listitem>
</itemizedlist>
</sect2>

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

<itemizedlist>
<listitem>
<simpara><constant>SIGINFO</constant></simpara>
</listitem>
</itemizedlist>
</sect2>

<sect2 xml:id="migration83.constants.pdo-odbc">
<title>PDO_ODBC</title>

<itemizedlist>
<listitem>
<simpara><constant>PDO_ODBC_TYPE</constant></simpara>
</listitem>
</itemizedlist>
</sect2>

<sect2 xml:id="migration83.constants.posix">
<title>Posix</title>

<itemizedlist>
<listitem>
<simpara><constant>POSIX_SC_ARG_MAX</constant></simpara>
</listitem>
<listitem>
<simpara><constant>POSIX_SC_PAGESIZE</constant></simpara>
</listitem>
<listitem>
<simpara><constant>POSIX_SC_NPROCESSORS_CONF</constant></simpara>
</listitem>
<listitem>
<simpara><constant>POSIX_SC_NPROCESSORS_ONLN</constant></simpara>
</listitem>
<listitem>
<simpara><constant>POSIX_PC_LINK_MAX</constant></simpara>
</listitem>
<listitem>
<simpara><constant>POSIX_PC_MAX_CANON</constant></simpara>
</listitem>
<listitem>
<simpara><constant>POSIX_PC_MAX_INPUT</constant></simpara>
</listitem>
<listitem>
<simpara><constant>POSIX_PC_NAME_MAX</constant></simpara>
</listitem>
<listitem>
<simpara><constant>POSIX_PC_PATH_MAX</constant></simpara>
</listitem>
<listitem>
<simpara><constant>POSIX_PC_PIPE_BUF</constant></simpara>
</listitem>
<listitem>
<simpara><constant>POSIX_PC_CHOWN_RESTRICTED</constant></simpara>
</listitem>
<listitem>
<simpara><constant>POSIX_PC_NO_TRUNC</constant></simpara>
</listitem>
<listitem>
<simpara><constant>POSIX_PC_ALLOC_SIZE_MIN</constant></simpara>
</listitem>
<listitem>
<simpara><constant>POSIX_PC_SYMLINK_MAX</constant></simpara>
</listitem>
</itemizedlist>
</sect2>

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

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

<itemizedlist>
<listitem>
<simpara><constant>SO_ATTACH_REUSEPORT_CBPF</constant> (Linux)</simpara>
</listitem>
<listitem>
<simpara><constant>SO_DETACH_BPF</constant> (Linux)</simpara>
</listitem>
<listitem>
<simpara><constant>SO_DETACH_FILTER</constant> (Linux)</simpara>
</listitem>
<listitem>
<simpara><constant>TCP_QUICKACK</constant> (Linux)</simpara>
</listitem>
<listitem>
<simpara><constant>IP_DONTFRAG</constant> (FreeBSD)</simpara>
</listitem>
<listitem>
<simpara><constant>IP_MTU_DISCOVER</constant> (Linux)</simpara>
</listitem>
<listitem>
<simpara><constant>IP_PMTUDISC_DO</constant> (Linux)</simpara>
</listitem>
<listitem>
<simpara><constant>IP_PMTUDISC_DONT</constant> (Linux)</simpara>
</listitem>
<listitem>
<simpara><constant>IP_PMTUDISC_WANT</constant> (Linux)</simpara>
</listitem>
<listitem>
<simpara><constant>IP_PMTUDISC_PROBE</constant> (Linux)</simpara>
</listitem>
<listitem>
<simpara><constant>IP_PMTUDISC_INTERFACE</constant> (Linux)</simpara>
</listitem>
<listitem>
<simpara><constant>IP_PMTUDISC_OMIT</constant> (Linux)</simpara>
</listitem>
<listitem>
<simpara><constant>AF_DIVERT</constant> (FreeBSD)</simpara>
</listitem>
<listitem>
<simpara><constant>SOL_UDPLITE</constant></simpara>
</listitem>
<listitem>
<simpara><constant>UDPLITE_RECV_CSCOV</constant></simpara>
</listitem>
<listitem>
<simpara><constant>UDPLITE_SEND_CSCOV</constant></simpara>
</listitem>

<listitem>
<simpara><constant>SO_RERROR</constant> (NetBSD)</simpara>
</listitem>
<listitem>
<simpara><constant>SO_ZEROIZE</constant> (OpenBSD)</simpara>
</listitem>
<listitem>
<simpara><constant>SO_SPLICE</constant> (OpenBSD)</simpara>
</listitem>
<listitem>
<simpara><constant>TCP_REPAIR</constant> (Linux)</simpara>
</listitem>
<listitem>
<simpara><constant>SO_REUSEPORT_LB</constant> (FreeBSD)</simpara>
</listitem>
<listitem>
<simpara><constant>IP_BIND_ADDRESS_NO_PORT</constant> (Linux)</simpara>
</listitem>
</itemizedlist>
</sect2>

<sect2 xml:id="migration83.constants.zip">
<title>Zip</title>

<itemizedlist>
<listitem>
<simpara>
<constant>ZipArchive::ER_DATA_LENGTH</constant> (libzip >= 1.10)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>ZipArchive::ER_NOT_ALLOWED</constant> (libzip >= 1.10)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>ZipArchive::AFL_RDONLY</constant> (libzip >= 1.10)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>ZipArchive::AFL_IS_TORRENTZIP</constant> (libzip >= 1.10)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>ZipArchive::AFL_WANT_TORRENTZIP</constant> (libzip >= 1.10)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>ZipArchive::AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE</constant>
(libzip >= 1.10)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>ZipArchive::FL_OPEN_FILE_NOW</constant>
</simpara>
</listitem>
<listitem>
<simpara>
<constant>ZipArchive::LENGTH_TO_END</constant> as default value for
<function>ZipArchive::addFile</function> and
<function>ZipArchive::replaceFile</function>
</simpara>
</listitem>
<listitem>
<simpara>
<constant>ZipArchive::LENGTH_UNCHECKED</constant> (libzip >= 1.10)
</simpara>
</listitem>
</itemizedlist>
</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