PHP 8.5 migration guide by mumumu · Pull Request #4906 · php/doc-en

mumumu · 2025-10-07T18:38:56Z

Based on PHP 8.5 UPGRADE NOTES and past migration guides.

TODO
- New Features
- New Classes and Interfaces
- New Functions
- New Global Constants
- Backward Incompatible Changes
- Deprecated Features
- Windows Support
- Other Changes
- doc-base/manual.xml.in change
  - added PHP 8.5 migration guide link doc-base#258

DanielEScherzer · 2025-10-19T23:10:49Z

I forgot to add UPGRADING for FILTER_THROW_ON_FAILURE and the 2 new classes that added, so it wasn't in #4886 originally - I just added that, can you include them here too?

TimWolla · 2025-10-20T06:47:54Z

php/php-src#20239 might also need to be incorporated

php/php-src@cea52f7

mumumu · 2025-10-20T12:38:35Z

I forgot to add UPGRADING for FILTER_THROW_ON_FAILURE and the 2 new classes that added, so it wasn't in #4886 originally

Added in 4f86bb5

php/php-src#20239 might also need to be incorporated

Changed in 3d7f6f5

https://wiki.php.net/rfc/clone_with_v2

TimWolla · 2025-10-24T20:22:26Z

php/php-src#20278

…PHP 8.5 php/php-src#20278

mumumu · 2025-10-25T10:46:03Z

php/php-src#20278

Added in a288458.
However, it is not the UPGRADING file as-is; instead, content based on the RFC wording has been added.

Girgias

Thank you for starting this! I left a lot of comments that I would like to have addressed. :)

appendices/migration85/deprecated.xml

Girgias · 2025-10-29T14:21:56Z

appendices/migration85/deprecated.xml

+  <simpara>
+   The <link linkend="object.wakeup">__wakeup()</link> magic method of
+   <interfacename>DateTimeInterface</interfacename>,
+   <classname>DateTime</classname>, <classname>DateTimeImmutable</classname>,
+   <classname>DateTimeZone</classname>, <classname>DateInterval</classname>,
+   and <classname>DatePeriod</classname> has been deprecated in favour of
+   the <link linkend="object.unserialize">__unserialize()</link> magic method.
+   <!-- RFC: https://wiki.php.net/rfc/deprecations_php_8_5#deprecate_the_sleep_and_wakeup_magic_methods -->
+  </simpara>


I don't remember if this wasn't reverted with the soft deprecation RFC, so this would need to be removed.

ok. deleted in eaa8c68.

Girgias · 2025-10-29T14:22:30Z

appendices/migration85/deprecated.xml

+   The <constant>MHASH_<replaceable>*</replaceable></constant> constants
+   have been deprecated.  These have been overlooked when the mhash*() function
+   family has been deprecated per
+   <!-- RFC: https://wiki.php.net/rfc/deprecations_php_8_1#mhash_function_family -->


This text doesn't make much sense as the RFC which is being linked to is in a comment

ok. deleted mhash*() related description in dc23d16.

Girgias · 2025-10-29T14:47:27Z

appendices/migration85/new-features.xml

+    The <link linkend="language.oop5.cloning">clone language construct</link>
+    is now a function and supports reassigning (readonly) properties during
+    cloning via the new <property>$withProperties</property> parameter.
+    <!-- RFC: https://wiki.php.net/rfc/clone_with_v2 -->


@TimWolla it cannot be disabled via disable_functions right?

appendices/migration85/new-features.xml

Girgias

Thank you for starting this! I left a lot of comments that I would like to have addressed. :)

Co-authored-by: Gina Peter Banyard <girgias@php.net>

mumumu · 2025-11-02T10:22:14Z

@Girgias

Thanks for all the feedback! I've addressed the points you raised, but I'm not sure how to fix the following.

https://github.com/php/doc-en/pull/4906/files#r2473529673

Girgias

More review comments, not sure I correctly identified the review comment you had issues with as the GitHub UI doesn't work...

appendices/migration85/deprecated.xml

appendices/migration85/incompatible.xml

appendices/migration85/other-changes.xml

Girgias · 2025-11-04T05:12:15Z

appendices/migration85/other-changes.xml

+   <simpara>
+    <function>pg_connect</function> checks if the connection_string argument
+    contains any null byte.
+   </simpara>
+
+   <simpara>
+    <function>pg_close_stmt</function> checks if the statement_name argument
+    contains any null byte.
+   </simpara>


Right so this should be move to the incompatible.xml file as this is a BC change and many of the other value errors are situated there

Girgias · 2025-11-04T05:14:12Z

appendices/migration85/other-changes.xml

+   <simpara>
+    Upgraded pcre2lib from 10.44 to 10.46.
+   </simpara>


This was downgraded again due to a bug in PCRE, @ndossche please confirm.

Co-authored-by: Gina Peter Banyard <girgias@php.net>

mumumu · 2025-11-04T12:18:05Z

@Girgias ok, nits markup issues addressed again.

Also, [ValueError|TypeError|Error|Exception] BC break changes are moved in 35ce39c, fed7a9f refs: https://github.com/php/doc-en/pull/4906/files#r2473529673

Girgias

Sorry for the delay haven't been feeling well.

Lets just merge this now and do more improvements over time.

Co-authored-by: Gina Peter Banyard <girgias@php.net>

PHP 8.5 migration guide (WIP)

36c3aa7

mumumu mentioned this pull request Oct 7, 2025

PHP 8.5 documentation tracker #4886

Open

mumumu added this to the PHP 8.5 milestone Oct 7, 2025

[WIP] added many entries to new-features.xml

6ebc73a

mumumu assigned mumumu and unassigned mumumu Oct 8, 2025

mumumu added 10 commits October 9, 2025 22:14

[new-features] some more markup tweaks

6ed8dda

added windows-support.xml

2bda1b8

[new-features.xml] added code comment

f5563f8

[incompatible.xml] added more details

53691ed

fixed trailing whitespace

1821c08

line length fix.

999de67

added deprecated.xml

8d58d7e

uncomment deprecated.xml

5ce1ccf

deleted superfluous comment

3baac18

[WIP] other-changes.xml template

5a2a157

mumumu mentioned this pull request Oct 12, 2025

added PHP 8.5 migration guide link php/doc-base#258

Merged

[other-changes.xml] completed.

c0b29d2

mumumu marked this pull request as ready for review October 12, 2025 12:10

mumumu added 8 commits October 15, 2025 01:03

added Closure and first class callables link

46ad7d6

clearify "compipe-time non-class constants".

51ee8ef

added class.curlsharepersistenthandle link

2117e36

deleted duplicate entry

3bcc889

deleted invalid new functions entry (curl_multi_add_handle)

3dd2688

more fix about markup

1464bc6

moved URI extention description to new-features.xml

9f8fabd

clearify pipe character (|).

e3a2108

add missing entries for FILTER_THROW_ON_FAILURE RFC

4f86bb5

PHP 8.5 | UPGRADING: fix entry about new grapheme $locale parameter

3d7f6f5

php/php-src@cea52f7

markup and typo tweaks

62852ce

mumumu mentioned this pull request Oct 20, 2025

PHP 8.5 移行ガイド日本語版 php/doc-ja#317

Merged

8 tasks

added clone_with_v2 functionality.

f38e1e1

https://wiki.php.net/rfc/clone_with_v2

added SoapClient::__doRequest undocumented backwards incompatible in …

a288458

…PHP 8.5 php/php-src#20278

fixed markup

928e2f4

mumumu force-pushed the php85-migration-guide branch from 5369184 to 928e2f4 Compare October 25, 2025 11:40

Girgias reviewed Oct 29, 2025

View reviewed changes

mumumu and others added 6 commits November 2, 2025 17:18

Apply suggestions from code review

870fc8d

Co-authored-by: Gina Peter Banyard <girgias@php.net>

fixed missing indent

8b62bd4

fixed log-limit fpm ini setting link.

bc0ae40

Added link for new INI setting TODO comment (openssl.libctx)

4f892b5

deleted mhash*() function descrption

dc23d16

deleted Datetime related magic method deprecation.

eaa8c68

Girgias reviewed Nov 4, 2025

View reviewed changes

mumumu and others added 3 commits November 4, 2025 20:47

Apply suggestions from code review part II.

9382594

Co-authored-by: Gina Peter Banyard <girgias@php.net>

nits markup tweaks

de74591

moved [ValueError|TypeError] BC Break changes to incompatible.xml

35ce39c

mumumu added 2 commits November 10, 2025 00:39

moved Exception|Error BC Break changes to incompatible.xml part II.

fed7a9f

fixed xml:id mistake

9d4152a

Girgias approved these changes Nov 10, 2025

View reviewed changes

Girgias merged commit ec45af7 into php:master Nov 10, 2025
2 checks passed

mumumu deleted the php85-migration-guide branch November 10, 2025 12:31

Crell pushed a commit to Crell/doc-en that referenced this pull request Dec 15, 2025

Add PHP 8.5 migration guide (php#4906)

b240b20

Co-authored-by: Gina Peter Banyard <girgias@php.net>

Conversation

mumumu commented Oct 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

DanielEScherzer commented Oct 19, 2025

Uh oh!

TimWolla commented Oct 20, 2025

Uh oh!

mumumu commented Oct 20, 2025

Uh oh!

TimWolla commented Oct 24, 2025

Uh oh!

mumumu commented Oct 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Girgias left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Girgias Oct 29, 2025

Choose a reason for hiding this comment

Uh oh!

mumumu Nov 2, 2025

Choose a reason for hiding this comment

Uh oh!

Girgias Oct 29, 2025

Choose a reason for hiding this comment

Uh oh!

mumumu Nov 2, 2025

Choose a reason for hiding this comment

Uh oh!

Girgias Oct 29, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Girgias left a comment

Choose a reason for hiding this comment

Uh oh!

mumumu commented Nov 2, 2025

Uh oh!

Girgias left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Girgias Nov 4, 2025

Choose a reason for hiding this comment

Uh oh!

Girgias Nov 4, 2025

Choose a reason for hiding this comment

Uh oh!

mumumu commented Nov 4, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Girgias left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

mumumu commented Oct 7, 2025 •

edited

Loading

mumumu commented Oct 25, 2025 •

edited

Loading

mumumu commented Nov 4, 2025 •

edited

Loading