[WIP] PHP 8.6 release page by saundefined · Pull Request #2030 · php/web-php

saundefined · 2026-10-04T05:02:36Z

URL: https://web-php-pr-2030.preview.thephp.foundation/releases/8.6/en.php

github-actions · 2026-10-04T05:09:30Z

📊 Regression report for commit 7b98f5c is at https://web-php-regression-report-pr-2030.preview.thephp.foundation

github-actions · 2026-10-04T05:10:52Z

🚀 Preview for commit 7b98f5c is available at https://web-php-pr-2030.preview.thephp.foundation

Co-authored-by: Tim Düsterhus <tim@bastelstu.be>

TimWolla · 2026-10-25T18:07:09Z

+        new FeatureComparison(
+                id: 'duration-class',
+                title: message('duration_title', $lang),
+                description: message('duration_description', $lang),
+                links: [
+                        'RFC|https://wiki.php.net/rfc/duration_class',
+                ],
+                before: <<<'PHP'
+            // TODO
+            PHP,
+                after: <<<'PHP'
+            // TODO
+            PHP,
+        ),


For Duration perhaps a custom wrapper around time_nanosleep()? The class nicely maps directly onto the parameters of time_nanosleep().

And then perhaps showcase some of the mathematical operations, e.g. the delay example from the RFC: https://wiki.php.net/rfc/duration_class#examples

DanielEScherzer · 2026-10-25T19:15:45Z

+    'documentation' => 'Doc',
+    'released' => 'Released Nov 19, 2026',
+    'key_features' => 'Key Features in PHP 8.6',
+    'key_features_description' => '<p><strong>Faster</strong>, <strong>cleaner</strong>, and <strong>built for developers</strong>.</p>',


Can we avoid putting the <p> tags in the message contents, if the entire message is a single paragraph? Just wrap the actual usage in the tags, to make translating easier

DanielEScherzer · 2026-10-25T19:16:23Z

+    'key_features' => 'Key Features in PHP 8.6',
+    'key_features_description' => '<p><strong>Faster</strong>, <strong>cleaner</strong>, and <strong>built for developers</strong>.</p>',
+
+    'features_pfa_description' => '<p>Allows functions to be called with only a subset of the required parameters, deferring the passing of the remaining ones to a later time.</p>',


this description is wrong - functions are not called with a subset of the required parameters, rather a subset of parameters is specified and the call is delayed until the remaining ones are provided

DanielEScherzer · 2026-10-25T19:17:13Z

+    'features_sort_direction_description' => '<p>Represents a sort directions.</p>',
+
+    'pfa_title' => 'Partial Function Application',
+    'pfa_description' => 'Allows functions to be called with only a subset of the required parameters, deferring the passing of the remaining ones to a later time.',


any expected difference between this and features_pfa_description? Same with some of the other description messages - if they are expected to be the same, just reuse the original one?

Not repeating my comments on the various features_* and other messages

I’ve separated these into two different language keys, because the features_* descriptions might be simplified or condensed, whereas the main descriptions might require more detail.

If the wording ends up being the same, we can always merge them.

DanielEScherzer · 2026-10-25T19:19:28Z

+    }
+
+    \site_header("PHP 8.6 Release Announcement", [
+        'current' => 'php85',


are these meant to say 8.5 for current and for the css ?

css — includes the necessary files,
current — adds a css class to the current page

Co-authored-by: Tim Düsterhus <timwolla@googlemail.com> Co-authored-by: Daniel Scherzer <daniel.e.scherzer@gmail.com>

Co-authored-by: Theodore Brown <theodorejb@outlook.com>

saundefined · 2026-11-07T10:16:57Z

Rendering on mobile is broken:

@TimWolla should be fixed

TimWolla · 2026-11-08T14:38:21Z

+            $durations = [
+                $oneSecond,
+                $negativeHour,
+                $onePointFiveSeconds,
+                $halfSecond,
+            ];
+
+            usort($durations, Duration::compare(...)); // Will sort to [-1h, 0.5s, 1s, 1.5s]


Not sure if this is worth showing on the release page.

TimWolla · 2026-11-08T14:39:07Z

+    new FeatureComparison(
+        id: 'clamp-function',
+        title: message('clamp_title', $lang),
+        description: message('clamp_description', $lang),
+        links: [
+            'RFC|https://wiki.php.net/rfc/clamp_v2',
+        ],
+        before: <<<'PHP'
+            var_dump(max(0, min(-10, 100)));
+            // int(0)
+
+            var_dump(max(0, min(50, 100)));
+            // int(50)
+
+            var_dump(max(0, min(110, 100)));
+            // int(100)
+            PHP,
+        after: <<<'PHP'
+            var_dump(clamp(-10, 0, 100));
+            // int(0)
+
+            var_dump(clamp(50, 0, 100));
+            // int(50)
+
+            var_dump(clamp(110, 0, 100));
+            // int(100)
+            PHP,
+    ),


The description says:

numeric or otherwise

Perhaps it makes sense to include one example using Duration? This would nicely interconnect the new features.

Co-authored-by: Tim Düsterhus <timwolla@googlemail.com>

Add missing examples and descriptions for the Polling API, readonly property defaults, stream error handling, parameter DocComments, and isReadable()/isWritable(). Rewrite the additional features and deprecations sections to focus on the most important changes instead of long lists of function names. Also fixed a couple PHPStan errors in the common.php file.

TimWolla · 2026-11-15T22:15:39Z

+                 * @param string $query Terms to search
+                 * @param int $limit Maximum number of results
+                 */
+                function search(string $query, int $limit = 10): array {


Suggested change

function search(string $query, int $limit = 10): array {

function search(string $query, int $limit = 10): array

{

TimWolla · 2026-11-15T22:17:04Z

+
+                    if ($stream === $server) {
+                        $client = stream_socket_accept($server);
+                        $poll->add(new StreamPollHandle($client), [Event::Read]);


Suggested change

$poll->add(new StreamPollHandle($client), [Event::Read]);

$poll->add(

new StreamPollHandle($client),

[Event::Read],

);

TimWolla · 2026-11-15T22:17:38Z

+                $read = [$server, ...$clients];
+                $write = $except = null;
+
+                // Based on select(), which typically can't handle more than 1024 connections


Suggested change

// Based on select(), which typically can't handle more than 1024 connections

// Based on select(), which typically can't handle

// more than 1024 connections

TimWolla · 2026-11-15T22:18:02Z

+                    $data = fread($stream, 8192);
+
+                    if ($data === '' || $data === false) {
+                        unset($clients[array_search($stream, $clients, true)]);


Suggested change

unset($clients[array_search($stream, $clients, true)]);

$key = array_search($stream, $clients, true);

unset($clients[$key]);

TimWolla · 2026-11-15T22:18:19Z

+            ]);
+
+            try {
+                $config = file_get_contents('/etc/app/config.json', context: $context);


Suggested change

$config = file_get_contents('/etc/app/config.json', context: $context);

$config = file_get_contents(

'/etc/app/config.json',

context: $context,

);

TimWolla · 2026-11-15T22:18:34Z

+            } catch (StreamException $e) {
+                foreach ($e->getErrors() as $error) {
+                    // $error->code is a StreamErrorCode enum case
+                    log_error($error->code->name, $error->message, $error->wrapperName);


Suggested change

log_error($error->code->name, $error->message, $error->wrapperName);

log_error(

$error->code->name,

$error->message,

$error->wrapperName,

);

TimWolla · 2026-11-15T22:18:59Z

+            }
+
+            var_dump(
+                new ReflectionParameter([DB::class, 'search'], 'query')->getDocComment()


Suggested change

new ReflectionParameter([DB::class, 'search'], 'query')->getDocComment()

new ReflectionParameter([DB::class, 'search'], 'query')

->getDocComment(),

TimWolla · 2026-11-15T22:19:17Z

+                    "%s: isReadable=%s isWritable=%s\n",
+                    $item,
+                    $property->isReadable(null, $entry) ? 'yes' : 'no',
+                    $property->isWritable(null, $entry) ? 'yes' : 'no'


Suggested change

$property->isWritable(null, $entry) ? 'yes' : 'no'

$property->isWritable(null, $entry) ? 'yes' : 'no',

TimWolla · 2026-11-15T22:20:25Z

+                /**
+                 * Returns up to $limit items matching the $query.
+                 */
+                function search(


Suggested change

function search(

public function search(

TimWolla · 2026-11-15T22:20:31Z

+                 * @param string $query Terms to search
+                 * @param int $limit Maximum number of results
+                 */
+                function search(string $query, int $limit = 10): array {


Suggested change

function search(string $query, int $limit = 10): array {

public function search(string $query, int $limit = 10): array {

TimWolla · 2026-11-15T22:47:43Z

+        title: message('duration_title', $lang),
+        description: message('duration_description', $lang),
+        links: [
+            'RFC|https://wiki.php.net/rfc/duration_class',


Duration already has documentation: https://www.php.net/manual/en/class.time-duration.php

TimWolla · 2026-11-15T22:48:23Z

+        title: message('clamp_title', $lang),
+        description: message('clamp_description', $lang),
+        links: [
+            'RFC|https://wiki.php.net/rfc/clamp_v2',


Documentation: https://www.php.net/manual/en/function.clamp.php

Initial PHP 8.6 release page

fc8d7ca

saundefined added the Status: Preview Allowed label Oct 4, 2026

wip

3bb614f

saundefined added Status: Preview Allowed and removed Status: Preview Allowed labels Oct 10, 2026

TimWolla reviewed Oct 13, 2026

View reviewed changes

Comment thread public/releases/8.6/release.inc Resolved

Comment thread public/releases/8.6/release.inc Resolved

Comment thread public/releases/8.6/release.inc Resolved

Comment thread public/releases/8.6/release.inc Resolved

Comment thread public/releases/8.6/release.inc Resolved

Apply suggestions from code review

bed1b89

Co-authored-by: Tim Düsterhus <tim@bastelstu.be>

saundefined force-pushed the php86 branch from 3be3b6d to bed1b89 Compare October 25, 2026 10:04

saundefined added Status: Preview Allowed and removed Status: Preview Allowed labels Oct 25, 2026

Reorder features

9048311

saundefined added Status: Preview Allowed and removed Status: Preview Allowed labels Oct 25, 2026

TimWolla reviewed Oct 25, 2026

View reviewed changes

DanielEScherzer reviewed Oct 25, 2026

View reviewed changes

This comment was marked as resolved.

Sign in to view

theodorejb reviewed Oct 27, 2026

View reviewed changes

Comment thread public/releases/8.6/release.inc Resolved

saundefined and others added 3 commits November 7, 2026 12:51

Apply batched suggestions from code review

a5c1a6e

Co-authored-by: Tim Düsterhus <timwolla@googlemail.com> Co-authored-by: Daniel Scherzer <daniel.e.scherzer@gmail.com>

indentation fixed

022802d

Co-authored-by: Theodore Brown <theodorejb@outlook.com>

Fix mobile layout

284f24a

saundefined added Status: Preview Allowed and removed Status: Preview Allowed labels Nov 7, 2026

TimWolla reviewed Nov 8, 2026

View reviewed changes

Comment thread public/releases/8.6/release.inc Resolved

saundefined and others added 2 commits November 8, 2026 20:39

Apply batched suggestions from code review

432754f

Co-authored-by: Tim Düsterhus <timwolla@googlemail.com>

Wording + icons

7ad0add

saundefined added Status: Preview Allowed and removed Status: Preview Allowed labels Nov 8, 2026

This comment was marked as resolved.

Sign in to view

saundefined added Status: Preview Allowed and removed Status: Preview Allowed labels Nov 15, 2026

TimWolla reviewed Nov 15, 2026

View reviewed changes

	function search(string $query, int $limit = 10): array {
	function search(string $query, int $limit = 10): array
	{

	// Based on select(), which typically can't handle more than 1024 connections
	// Based on select(), which typically can't handle
	// more than 1024 connections

	unset($clients[array_search($stream, $clients, true)]);
	$key = array_search($stream, $clients, true);
	unset($clients[$key]);

	new ReflectionParameter([DB::class, 'search'], 'query')->getDocComment()
	new ReflectionParameter([DB::class, 'search'], 'query')
	->getDocComment(),

	$property->isWritable(null, $entry) ? 'yes' : 'no'
	$property->isWritable(null, $entry) ? 'yes' : 'no',

	function search(string $query, int $limit = 10): array {
	public function search(string $query, int $limit = 10): array {

Conversation

saundefined commented Oct 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Oct 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Oct 4, 2026 • 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!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

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!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

This comment was marked as resolved.

Uh oh!

Uh oh!

saundefined commented Nov 7, 2026

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!

Uh oh!

This comment was marked as resolved.

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!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Uh oh!

saundefined commented Oct 4, 2026 •

edited

Loading

github-actions Bot commented Oct 4, 2026 •

edited

Loading

github-actions Bot commented Oct 4, 2026 •

edited

Loading