[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 9048311 is at https://web-php-regression-report-pr-2030.preview.thephp.foundation

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

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

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

TimWolla · 2026-10-25T18:02:40Z

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


Suggested change

/**

* Returns up to $limit items matching the $query.

*/

/**

* Returns up to $limit items matching the $query.

*/

TimWolla · 2026-10-25T18:02:57Z

+                    /** Terms to search */
+                    string $query,
+
+                    /** int Terms to search */


Suggested change

/** int Terms to search */

/** Maximum number of results */

TimWolla · 2026-10-25T18:03:27Z

+                ],
+                before: '',
+                after: <<<'PHP'
+            class NewsEntry {


Suggested change

class NewsEntry {

class NewsEntry

{

TimWolla · 2026-10-25T18:03:44Z

+                ],
+                before: '',
+                after: <<<'PHP'
+            class DB {


Suggested change

class DB {

class DB

{

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

+            class QueryBuilder {
+                private SortDirection $sort;
+
+                public function setSort(SortDirection $sort): void {
+                    $this->sort = $sort;
+                }
+
+                private function getSortKeyword(): string {
+                    return match($this->sort) {
+                        SortDirection::Ascending => 'ASC',
+                        SortDirection::Descending => 'DESC',
+                    };
+                }
+            }


Suggested change

class QueryBuilder {

private SortDirection $sort;

public function setSort(SortDirection $sort): void {

$this->sort = $sort;

}

private function getSortKeyword(): string {

return match($this->sort) {

SortDirection::Ascending => 'ASC',

SortDirection::Descending => 'DESC',

};

}

}

class QueryBuilder

{

private SortDirection $sort;

public function setSort(SortDirection $sort): void

{

$this->sort = $sort;

}

private function getSortKeyword(): string

{

return match($this->sort) {

SortDirection::Ascending => 'ASC',

SortDirection::Descending => 'DESC',

};

}

}

TimWolla · 2026-10-25T18:04:19Z

+            class QueryBuilder {
+                private int $sort;
+
+                public function setSort(int $sort): void {
+                    $this->sort = $sort;
+                }
+
+                private function getSortKeyword(): string {
+                    return match($this->sort) {
+                        SORT_ASC => 'ASC',
+                        SORT_DESC => 'DESC',
+                    };
+                }
+            }


Suggested change

class QueryBuilder {

private int $sort;

public function setSort(int $sort): void {

$this->sort = $sort;

}

private function getSortKeyword(): string {

return match($this->sort) {

SORT_ASC => 'ASC',

SORT_DESC => 'DESC',

};

}

}

class QueryBuilder

{

private int $sort;

public function setSort(int $sort): void

{

$this->sort = $sort;

}

private function getSortKeyword(): string

{

return match($this->sort) {

SORT_ASC => 'ASC',

SORT_DESC => 'DESC',

};

}

}

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:14:22Z

+<?php
+
+return [
+    'common_header' => 'PHP 8.6 is a major update of the PHP language, with new features including the Partial Function Application, new Duration class, Polling API, and new clamp() function',


Suggested change

'common_header' => 'PHP 8.6 is a major update of the PHP language, with new features including the Partial Function Application, new Duration class, Polling API, and new clamp() function',

'common_header' => 'PHP 8.6 is a major update of the PHP language, with new features including Partial Function Application, a new Duration class, a Polling API, and a new clamp() function',

("a" can also be "the", both here and in the main_subtitle message)

DanielEScherzer · 2026-10-25T19:14:40Z

+return [
+    'common_header' => 'PHP 8.6 is a major update of the PHP language, with new features including the Partial Function Application, new Duration class, Polling API, and new clamp() function',
+    'main_title' => 'Smarter, Faster, Built for Tomorrow.',
+    'main_subtitle' => '<p xmlns="http://www.w3.org/1999/html"><strong>PHP 8.6 is a major update of the PHP language</strong>, with new features including the <strong>Partial Function Application</strong>, new <strong>Duration</strong> class, <strong>Polling API</strong>, and new <strong>clamp()</strong> function</p>',


Suggested change

'main_subtitle' => 'PHP 8.6 is a major update of the PHP language, with new features including the Partial Function Application, new Duration class, Polling API, and new clamp() function',

'main_subtitle' => 'PHP 8.6 is a major update of the PHP language, with new features including Partial Function Application, a new Duration class, a Polling API, and a new clamp() function',

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  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

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

+    'features_polling_api_description' => '<p>The new API is available at the user-code level, allowing low-level frameworks such as ReactPHP or Amp to utilize it.</p>',
+    'features_clamp_description' => '<p>Ensures that a given value (numeric or otherwise) falls within a specified range.</p>',
+    'features_duration_description' => '<p>Represents a duration of time.</p>',
+    'features_sort_direction_description' => '<p>Represents a sort directions.</p>',


Suggested change

'features_sort_direction_description' => 'Represents a sort directions.',

'features_sort_direction_description' => 'Represents possible sort directions.',

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

+    'stream_error_handling_description' => 'TODO.',
+    'doc_comments_title' => 'DocComments For Function Parameters',
+    'doc_comments_description' => 'TODO.',
+    'isreadable_iswriteable_title' => 'New <code>ReflectionProperty::isReadable</code> and <code>ReflectionProperty::isWritable</code> methods',


Suggested change

'isreadable_iswriteable_title' => 'New <code>ReflectionProperty::isReadable</code> and <code>ReflectionProperty::isWritable</code> methods',

'isreadable_iswriteable_title' => 'New <code>ReflectionProperty::isReadable()</code> and <code>ReflectionProperty::isWritable()</code> methods',

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 ?

TimWolla

Rendering on mobile is broken:

For PHP 8.5:

theodorejb · 2026-10-27T18:49:51Z

+common_header(message('common_header', $lang));
+
+$comparisons = [
+        new FeatureComparison(


Why does this array have 8-space indentation? The existing release pages use 4-space indentation.

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 Outdated

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

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

Comment thread public/releases/8.6/release.inc

Comment thread public/releases/8.6/release.inc

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

TimWolla reviewed Oct 26, 2026

View reviewed changes

theodorejb reviewed Oct 27, 2026

View reviewed changes

	'common_header' => 'PHP 8.6 is a major update of the PHP language, with new features including the Partial Function Application, new Duration class, Polling API, and new clamp() function',
	'common_header' => 'PHP 8.6 is a major update of the PHP language, with new features including Partial Function Application, a new Duration class, a Polling API, and a new clamp() function',

	'main_subtitle' => '<p xmlns="http://www.w3.org/1999/html"><strong>PHP 8.6 is a major update of the PHP language</strong>, with new features including the <strong>Partial Function Application</strong>, new <strong>Duration</strong> class, <strong>Polling API</strong>, and new <strong>clamp()</strong> function</p>',
	'main_subtitle' => '<p xmlns="http://www.w3.org/1999/html"><strong>PHP 8.6 is a major update of the PHP language</strong>, with new features including <strong>Partial Function Application</strong>, a new <strong>Duration</strong> class, a <strong>Polling API</strong>, and a new <strong>clamp()</strong> function</p>',

	'features_sort_direction_description' => '<p>Represents a sort directions.</p>',
	'features_sort_direction_description' => '<p>Represents possible sort directions.</p>',

	'isreadable_iswriteable_title' => 'New <code>ReflectionProperty::isReadable</code> and <code>ReflectionProperty::isWritable</code> methods',
	'isreadable_iswriteable_title' => 'New <code>ReflectionProperty::isReadable()</code> and <code>ReflectionProperty::isWritable()</code> methods',

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!

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!

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!

TimWolla left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

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