[WIP] PHP 8.5 release page #1454

saundefined · 2025-09-25T16:19:47Z

Preview: https://web-php-pr-1454.preview.thephp.foundation/releases/8.5/en.php

github-actions · 2025-09-25T16:21:27Z

🚀 Regression report for commit 55be0cb is at https://web-php-regression-report-pr-1454.preview.thephp.foundation

github-actions · 2025-09-25T16:21:40Z

🚀 Preview for commit 55be0cb can be found at https://web-php-pr-1454.preview.thephp.foundation

releases/8.5/release.inc

releases/8.5/languages/en.php

releases/8.5/release.inc

TimWolla · 2025-10-01T15:15:14Z

releases/8.5/release.inc

+$versions = ['PHP 8.1', 'PHP 8.2', 'PHP 8.3', 'PHP 8.4', 'PHP 8.5'];
+
+var_dump($versions[array_key_first($versions)]);
+// string(7) "PHP 8.1"


I find this example too simple to be useful, especially because $versions[0] works for a list. Perhaps we can find something with an associative array?

releases/8.5/release.inc

Co-authored-by: Tim Düsterhus <[email protected]>

releases/8.5/release.inc

TimWolla · 2025-10-04T13:26:24Z

releases/8.5/release.inc

+$upcomingRelease = null;
+foreach ($php as $key => $version) {
+    if ($version['state'] === 'upcoming') {
+        $upcomingRelease = $version;
+        break;
+    }
+}


This is not a good example, because this could just be array_find().

TimWolla · 2025-10-04T13:26:40Z

releases/8.5/release.inc

+$upcomingRelease = array_first(
+    array_filter(
+        $php,
+        static fn($version) => $version['state'] === 'upcoming'
+    )
+);


TimWolla · 2025-10-04T13:28:55Z

releases/8.5/release.inc

+            <div class="php8-compare__main">
+                <div class="php8-compare__block example-contents">
+                    <div class="php8-compare__label">PHP &lt; 8.5</div>
+                    <div class="php8-code phpcode">
+                        <?php highlight_php_trimmed(
+                                <<<'PHP'
+$sh = curl_share_init();
+curl_share_setopt($sh, CURLSHOPT_SHARE, CURL_LOCK_DATA_DNS);
+curl_share_setopt($sh, CURLSHOPT_SHARE, CURL_LOCK_DATA_CONNECT);
+
+$ch1 = curl_init('https://php.net/');
+curl_setopt($ch1, CURLOPT_SHARE, $sh);
+curl_exec($ch1);
+
+$ch2 = curl_init('https://thephp.foundation/');
+curl_setopt($ch2, CURLOPT_SHARE, $sh);
+curl_exec($ch2);
+
+curl_share_close($sh);
+
+curl_close($ch1);
+curl_close($ch2);
+PHP
+
+                        ); ?>
+                    </div>
+                </div>
+                <div class="php8-compare__arrow"></div>
+                <div class="php8-compare__block example-contents" style="display: table;">
+                    <div class="php8-compare__label php8-compare__label_new">PHP 8.5</div>
+                    <div class="php8-code phpcode" style="display: table-cell;">
+                        <?php highlight_php_trimmed(
+                                <<<'PHP'
+$sh = curl_share_init_persistent([
+    CURL_LOCK_DATA_DNS,
+    CURL_LOCK_DATA_CONNECT
+]);
+
+$ch1 = curl_init('https://php.net/');
+curl_setopt($ch1, CURLOPT_SHARE, $sh);
+curl_exec($ch1);
+
+$ch2 = curl_init('https://thephp.foundation/');
+curl_setopt($ch2, CURLOPT_SHARE, $sh);
+curl_exec($ch2);
+
+curl_close($ch1);
+curl_close($ch2);
+PHP
+                        ); ?>
+                    </div>
+                </div>
+            </div>


This comparison is not really meaningful to understand what has changed. At least some explanation is necessary. curl_close() should be removed in all cases, since it is useless with 8.0 and deprecated with 8.5.

TimWolla · 2025-10-04T13:31:23Z

releases/8.5/release.inc

+    #[DataProvider('subtractionProvider')]
+    public function testSubtraction(
+        int $minuend,
+        int $subtrahend,
+        int $result
+    ): void
+    {
+        $this->assertSame(
+            $result,
+            Calculator::subtract($minuend, $subtrahend)
+        );
+    }


This should be kept in sync with the 8.5 version. Unfortunately the 8.5 version can't yet use PHPUnit, since sebastianbergmann/phpunit#6136 is not implemented yet. So both should use some “generic test framework”.

/cc @sebastianbergmann

releases/8.5/release.inc

Co-authored-by: Tim Düsterhus <[email protected]>

releases/8.5/release.inc

TimWolla · 2025-10-05T17:03:40Z

releases/8.5/release.inc

+    |> (fn (string $string) => str_replace(' ', '-', $string))
+    |> (fn (string $string) => str_replace(['.', '/', '…'], '', $string))


Suggested change

|> (fn (string $string) => str_replace(' ', '-', $string))

|> (fn (string $string) => str_replace(['.', '/', '…'], '', $string))

|> (fn($string) => str_replace(' ', '-', $string))

|> (fn($string) => str_replace(['.', '/', '…'], '', $string))

No space after fn for PER-CS. Removed the type, because it seems unlikely for folks to add an explict type in pipes, which will also shorten the line.

/cc @Crell

Co-authored-by: Tim Düsterhus <[email protected]>

TimWolla · 2025-10-09T19:25:48Z

releases/8.5/languages/en.php

+    'url_parsing_api_title' => 'Add RFC 3986 and WHATWG URL compliant API',
+    'url_parsing_api_description' => '<code>Uri\UriException</code>, <code>Uri\InvalidUriException</code>, <code>Uri\UriComparisonMode</code>,
+    <code>Uri\Rfc3986\Uri</code>, <code>Uri\WhatWg\InvalidUrlException</code>, <code>Uri\WhatWg\UrlValidationErrorType</code>, <code>Uri\WhatWg\UrlValidationError</code>, and <code>Uri\WhatWg\Url</code> are now available.',
+    'clone_with_title' => 'Clone with v2',


Suggested change

'clone_with_title' => 'Clone with v2',

'clone_with_title' => 'Clone With',

I don't think we need the v2 here, since this is intended for the end user, not the folks who actually read RFCs 😀

TimWolla · 2025-10-09T19:26:12Z

releases/8.5/languages/en.php

+    'main_subtitle' => 'PHP 8.5 is a major update of the PHP language.<br class="display-none-md"> It contains many new features, such as the new URI extension, support for modifying properties while cloning, the Pipe operator, performance improvements, bug fixes, and general cleanup.',
+    'upgrade_now' => 'Upgrade to PHP 8.5 now!',
+
+    'pipe_operator_title' => 'Pipe operator',


Suggested change

'pipe_operator_title' => 'Pipe operator',

'pipe_operator_title' => 'Pipe Operator',

TimWolla · 2025-10-09T19:27:29Z

releases/8.5/languages/en.php

+    'upgrade_now' => 'Upgrade to PHP 8.5 now!',
+
+    'pipe_operator_title' => 'Pipe operator',
+    'url_parsing_api_title' => 'Add RFC 3986 and WHATWG URL compliant API',


Suggested change

'url_parsing_api_title' => 'Add RFC 3986 and WHATWG URL compliant API',

'url_parsing_api_title' => 'New URI Extension',

TimWolla · 2025-10-09T19:27:47Z

releases/8.5/languages/en.php

+    'url_parsing_api_description' => '<code>Uri\UriException</code>, <code>Uri\InvalidUriException</code>, <code>Uri\UriComparisonMode</code>,
+    <code>Uri\Rfc3986\Uri</code>, <code>Uri\WhatWg\InvalidUrlException</code>, <code>Uri\WhatWg\UrlValidationErrorType</code>, <code>Uri\WhatWg\UrlValidationError</code>, and <code>Uri\WhatWg\Url</code> are now available.',
+    'clone_with_title' => 'Clone with v2',
+    'no_discard_title' => 'New <code>#[\NoDiscard]</code> Attribute',


Suggested change

'no_discard_title' => 'New <code>#[\NoDiscard]</code> Attribute',

'no_discard_title' => '<code>#[\NoDiscard]</code> Attribute',

TimWolla · 2025-10-09T19:28:17Z

releases/8.5/languages/en.php

+    'clone_with_title' => 'Clone with v2',
+    'no_discard_title' => 'New <code>#[\NoDiscard]</code> Attribute',
+    'fcc_in_const_expr_title' => 'First Class Callables in constant expressions',
+    'curl_share_persistence_improvement_title' => 'Persistent cURL share handle improvement',


Suggested change

'curl_share_persistence_improvement_title' => 'Persistent cURL share handle improvement',

'curl_share_persistence_improvement_title' => 'Persistent cURL Share Handles',

TimWolla · 2025-10-09T19:28:54Z

releases/8.5/languages/en.php

+    <code>Uri\Rfc3986\Uri</code>, <code>Uri\WhatWg\InvalidUrlException</code>, <code>Uri\WhatWg\UrlValidationErrorType</code>, <code>Uri\WhatWg\UrlValidationError</code>, and <code>Uri\WhatWg\Url</code> are now available.',
+    'clone_with_title' => 'Clone with v2',
+    'no_discard_title' => 'New <code>#[\NoDiscard]</code> Attribute',
+    'fcc_in_const_expr_title' => 'First Class Callables in constant expressions',


Suggested change

'fcc_in_const_expr_title' => 'First Class Callables in constant expressions',

'fcc_in_const_expr_title' => 'Closures and First Class Callables in Constant Expressions',

TimWolla · 2025-10-09T19:35:01Z

releases/8.5/release.inc

+                </div>
+            </div>
+            <div class="php8-compare__content">
+                <?= message('url_parsing_api_description', $lang) ?>


As an always-available part of PHP's standard library the new URI extension provides APIs to parse and modify URIs and URLs according to the RFC 3986 and the WHATWG URL standards.

The secure and standards-compliant URI parsing is powered by the uriparser (RFC 3986) and Lexbor (WHATWG URL) libraries.

TimWolla · 2025-10-09T19:40:58Z

releases/8.5/release.inc

+
+        <div class="php8-compare">
+            <h2 class="php8-h2" id="clone_with">
+                <?= message('clone_with_title', $lang) ?>


Description:

It is not possible to update properties during object cloning by passing an associative array with the updated to the clone() function. This enables straight-forward support of the "with-er" pattern for readonly classes.

TimWolla · 2025-10-09T19:46:35Z

releases/8.5/release.inc

+
+        <div class="php8-compare">
+            <h2 class="php8-h2" id="no_discard">
+                <?= message('no_discard_title', $lang) ?>


Description:

By adding the #[\NoDiscard] attribute to a function, PHP will check whether the returned value is consumed and emit a warning if it is not. This allows to improve the safety of APIs where the returned value is important, but where it is easy to forget using the return value by accident.

The associated (void) cast can be used to indicate that a value is intentionally unused.

Add PHP 8.5 release page

2614191

saundefined added the Status: Preview Allowed label Sep 25, 2025

TimWolla reviewed Sep 26, 2025

View reviewed changes

releases/8.5/release.inc Outdated Show resolved Hide resolved

wip

ec7b3ef

saundefined added Status: Preview Allowed and removed Status: Preview Allowed labels Oct 1, 2025

wip

5fc81d6

saundefined added Status: Preview Allowed and removed Status: Preview Allowed labels Oct 1, 2025

TimWolla reviewed Oct 1, 2025

View reviewed changes

vudaltsov reviewed Oct 3, 2025

View reviewed changes

releases/8.5/release.inc Outdated Show resolved Hide resolved

vudaltsov reviewed Oct 3, 2025

View reviewed changes

releases/8.5/release.inc Outdated Show resolved Hide resolved

TimWolla reviewed Oct 3, 2025

View reviewed changes

releases/8.5/release.inc Outdated Show resolved Hide resolved

releases/8.5/release.inc Outdated Show resolved Hide resolved

Apply suggestions from code review

1027001

Co-authored-by: Tim Düsterhus <[email protected]>

saundefined added Status: Preview Allowed and removed Status: Preview Allowed labels Oct 3, 2025

wip

4c0fe2b

saundefined added Status: Preview Allowed and removed Status: Preview Allowed labels Oct 3, 2025

wip

6e7045f

saundefined added Status: Preview Allowed and removed Status: Preview Allowed labels Oct 3, 2025

TimWolla reviewed Oct 4, 2025

View reviewed changes

TimWolla mentioned this pull request Oct 5, 2025

Design contest submission #1477

Open

1 task

TimWolla reviewed Oct 5, 2025

View reviewed changes

releases/8.5/release.inc Show resolved Hide resolved

Apply suggestions from code review

b655856

Co-authored-by: Tim Düsterhus <[email protected]>

saundefined removed the Status: Preview Allowed label Oct 5, 2025

TimWolla reviewed Oct 5, 2025

View reviewed changes

Apply suggestions from code review

7301dd8

Co-authored-by: Tim Düsterhus <[email protected]>

saundefined added the Status: Preview Allowed label Oct 5, 2025

cs

d525379

TimWolla mentioned this pull request Oct 6, 2025

Design Content Submission #5 #1485

Open

1 task

TimWolla reviewed Oct 9, 2025

View reviewed changes

TimWolla mentioned this pull request Oct 10, 2025

Design contest submission #1506

Open

1 task

		\|> (fn (string $string) => str_replace(' ', '-', $string))
		\|> (fn (string $string) => str_replace(['.', '/', '…'], '', $string))

	'clone_with_title' => 'Clone with v2',
	'clone_with_title' => 'Clone With',

	'pipe_operator_title' => 'Pipe operator',
	'pipe_operator_title' => 'Pipe Operator',

	'url_parsing_api_title' => 'Add RFC 3986 and WHATWG URL compliant API',
	'url_parsing_api_title' => 'New URI Extension',

	'no_discard_title' => 'New <code>#[\NoDiscard]</code> Attribute',
	'no_discard_title' => '<code>#[\NoDiscard]</code> Attribute',

	'curl_share_persistence_improvement_title' => 'Persistent cURL share handle improvement',
	'curl_share_persistence_improvement_title' => 'Persistent cURL Share Handles',

	'fcc_in_const_expr_title' => 'First Class Callables in constant expressions',
	'fcc_in_const_expr_title' => 'Closures and First Class Callables in Constant Expressions',

[WIP] PHP 8.5 release page #1454

Are you sure you want to change the base?

[WIP] PHP 8.5 release page #1454

Conversation

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

Uh oh!

Uh oh!

github-actions bot commented Sep 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Sep 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

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!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

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!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

saundefined commented Sep 25, 2025 •

edited

Loading

github-actions bot commented Sep 25, 2025 •

edited

Loading

github-actions bot commented Sep 25, 2025 •

edited

Loading