[WIP] PHP 8.4 release page #1079

saundefined · 2024-09-22T12:44:55Z

Let's start preparing for the release.

Update logo ( @pronskiy )
Finish the English version
Put messages in lang-files
Add links to Documentation
Merge PR without updates in include/header.inc and index.php
Waiting for the release of PHP 8.4 🎉
Update include/header.inc and index.php

Any help is welcome, especially from RFC authors :)

github-actions · 2024-09-22T12:45:58Z

🚀 Preview for commit b585014 can be found at https://web-php-pr-1079.preview.thephp.foundation

github-actions · 2024-09-22T12:46:26Z

🚀 Regression report for commit b585014 is at https://web-php-regression-report-pr-1079.preview.thephp.foundation

TimWolla · 2024-10-03T12:51:07Z

releases/8.4/languages/en.php

+<?php
+
+return [
+ 'common_header' => 'PHP 8.4 is a major update of the PHP language. It contains many new features, such as property hooks, asymmetric visibility, lazy objects, and additions to the randomness functionality. As always it also includes performance improvements, bug fixes, and general cleanup.',


Randomness functionality didn't have any additions for 8.4.

TimWolla · 2024-10-03T12:52:10Z

releases/8.4/languages/en.php

+ 'common_header' => 'PHP 8.4 is a major update of the PHP language. It contains many new features, such as property hooks, asymmetric visibility, lazy objects, and additions to the randomness functionality. As always it also includes performance improvements, bug fixes, and general cleanup.',
+ 'documentation' => 'Doc',
+ 'main_title' => 'Released!',
+ 'main_subtitle' => 'PHP 8.4 is a major update of the PHP language.<br class="display-none-md"> It contains many new features, such as property hooks, asymmetric visibility, lazy objects, and additions to the randomness functionality. As always it also includes performance improvements, bug fixes, and general cleanup.',


TimWolla · 2024-10-03T12:52:36Z

releases/8.4/release.inc

+ <div class="php8-compare">
+ <h2 class="php8-h2" id="domdocument_html5_parser">
+ <?= message('domdocument_html5_parser_title', $lang) ?>
+ <a class="php8-rfc" href="https://wiki.php.net/rfc/new_without_parentheses">RFC</a>


Wrong RFC link

TimWolla · 2024-10-03T12:53:17Z

releases/8.4/release.inc

+ <div class="php8-compare">
+ <h2 class="php8-h2" id="dom_additions_84">
+ <?= message('dom_additions_84_title', $lang) ?>
+ <a class="php8-rfc" href="https://wiki.php.net/rfc/dom_additions_84">RFC</a>
+ </h2>
+ <div class="php8-compare__main">
+ <div class="php8-compare__block example-contents">
+ <div class="php8-compare__label">PHP &lt; 8.4</div>
+ <div class="php8-code phpcode">
+ <?php highlight_php_trimmed(
+ <<<'PHP'
+// TODO
+PHP
+
+ ); ?>
+ </div>
+ </div>
+ <div class="php8-compare__arrow"></div>
+ <div class="php8-compare__block example-contents">
+ <div class="php8-compare__label php8-compare__label_new">PHP 8.4</div>
+ <div class="php8-code phpcode">
+ <?php highlight_php_trimmed(
+ <<<'PHP'
+// TODO
+PHP
+ ); ?>
+ </div>
+ </div>
+ </div>
+ </div>
+ <div class="php8-compare">
+ <h2 class="php8-h2" id="domdocument_html5_parser">
+ <?= message('domdocument_html5_parser_title', $lang) ?>
+ <a class="php8-rfc" href="https://wiki.php.net/rfc/new_without_parentheses">RFC</a>
+ </h2>
+ <div class="php8-compare__main">
+ <div class="php8-compare__block example-contents">
+ <div class="php8-compare__label">PHP &lt; 8.4</div>
+ <div class="php8-code phpcode">
+ <?php highlight_php_trimmed(
+ <<<'PHP'
+// TODO
+PHP
+
+ ); ?>
+ </div>
+ </div>
+ <div class="php8-compare__arrow"></div>
+ <div class="php8-compare__block example-contents">
+ <div class="php8-compare__label php8-compare__label_new">PHP 8.4</div>
+ <div class="php8-code phpcode">
+ <?php highlight_php_trimmed(
+ <<<'PHP'
+// TODO
+PHP
+ ); ?>
+ </div>
+ </div>
+ </div>
+ </div>


These two can probably be merged into a single example. /cc @nielsdos

Probably indeed. Thing is though that we do not have a counterpart for pre-8.4 for the new DOM additions.

That would not necessarily be a problem. The ext/random example in 8.2 did not have a comparison either: https://www.php.net/releases/8.2/en.php#random_extension.

Though one could possibly compare XPath with the new CSS selectors.

TimWolla · 2024-10-03T12:56:32Z

releases/8.4/release.inc

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


I know that this change has been hyped on social media, but even leaving aside that I don't personally like it, I do not believe that it warrants such a prominent spot in the list of changes. Either #[\Deprecated] or array_find() and friends are likely more appealing to list here. Perhaps both of them if HTML 5 + DOM improvements are merged.

Agreed, Lazy Objects would be more suited to highlight.

I think this change is noteworthy enough to be included, though I would agree it should be lower on the list than e.g. the new array functions.

TimWolla · 2024-10-03T12:58:19Z

releases/8.4/release.inc

+$phpVersion = new PhpVersion();
+$foo->version = 'PHP 8.4'; // No error


Suggested change

$phpVersion = new PhpVersion();

$foo->version = 'PHP 8.4'; // No error

$phpVersion = new PhpVersion();

$phpVersion->version = '8.4'; // No error

TimWolla · 2024-10-03T12:58:34Z

releases/8.4/release.inc

+$phpVersion = new PhpVersion();
+$foo->version = 'PHP 8.3'; // Visibility error


Suggested change

$phpVersion = new PhpVersion();

$foo->version = 'PHP 8.3'; // Visibility error

$phpVersion = new PhpVersion();

$phpVersion->version = '8.3'; // Visibility error

TimWolla · 2024-10-03T12:59:19Z

releases/8.4/release.inc

+ <div class="php8-code phpcode">
+ <?php highlight_php_trimmed(
+ <<<'PHP'
+class PhpVersion {


Opening brace of the class is inconsistent with the other examples.

Girgias

A big feature of this release is also the dedicated PDO Driver subclasses, IMHO.

Girgias · 2024-10-03T18:41:10Z

releases/8.4/languages/en.php

+ 'asymmetric_visibility_title' => 'Asymmetric Visibility',
+ 'domdocument_html5_parser_title' => 'New HTML5 support',
+ 'dom_additions_84_title' => 'New ext-dom features',
+ 'new_without_parentheses_title' => 'new MyClass()->method() without parentheses',


Surely Lazy Objects warrant a highlight compared to this.

I really don't understand what is so revolutionary about not needing to use parentheses with new.

Girgias · 2024-10-03T18:41:39Z

releases/8.4/languages/en.php

+ 'new_classes_title' => 'New Classes, Interfaces, and Functions',
+ 'new_bc_functions' => 'New <code>bcfloor()</code>, <code>bcceil()</code>, and <code>bcround()</code> functions.',
+ 'new_dom_methods' => 'New <code>DOMNode::compareDocumentPosition()</code>, <code>DOMXPath::registerPhpFunctionNS()</code>, and <code>DOMXPath::quote()</code> methods.',
+ 'new_intl_methods' => 'New <code>IntlDateFormatter::getIanaID()</code>, <code>IntlDateFormatter::parseToCalendar()</code>, and <code>SpoofChecker::setAllowedChars()</code> methods, and also <code>intltz_get_iana_id()</code>, <code>grapheme_str_split()</code> functions.',
+ 'new_mbstring_functions' => 'New <code>mb_trim()</code>, <code>mb_ltrim()</code>, <code>mb_rtrim()</code>, <code>mb_ucfirst()</code>, and <code>mb_lcfirst()</code> functions.',
+ 'new_pcntl_functions' => 'New <code>pcntl_setns()</code>, <code>pcntl_getcpuaffinity()</code>, <code>pcntl_setcpuaffinity()</code>, <code>pcntl_getcpu()</code>, <code>pcntl_waitid()</code>, and <code>pcntl_getqos_class()</code> functions.',
+ 'new_pdo_method' => 'New <code>Pdo\Pgsql::setNoticeCallback()</code> method.',
+ 'new_pgsql_functions' => 'New <code>pg_change_password()</code>, <code>pg_put_copy_data()</code>, <code>pg_socket_poll()</code>, <code>pg_jit()</code>, and <code>pg_set_chunked_rows_size()</code> functions.',
+ 'new_reflection_methods' => 'New <code>ReflectionClass::newLazyGhost()</code>, <code>ReflectionClass::newLazyProxy()</code>, <code>ReflectionClass::resetAsLazyGhost()</code>, <code>ReflectionClass::resetAsLazyProxy()</code>, <code>ReflectionClass::isUninitializedLazyObject()</code>, <code>ReflectionClass::initializeLazyObject()</code>, <code>ReflectionClass::markLazyObjectAsInitialized()</code>, <code>ReflectionClass::getLazyInitializer()</code>, <code>ReflectionProperty::skipLazyInitialization</code>, and <code>ReflectionProperty::setRawValueWithoutLazyInitialization</code> methods.',
+ 'new_sodium_functions' => 'New <code>sodium_crypto_aead_aegis128l_*()</code>, <code>sodium_crypto_aead_aegis256l_*()</code>, and <code>sodium_crypto_aead_aes256gcm_*()</code> functions.',
+ 'new_soap_method' => 'New <code>SoapServer::__getLastResponse()</code> method.',
+ 'new_standard_functions' => 'New <code>http_get_last_response_headers()</code>, <code>http_clear_last_response_headers()</code>, <code>fpow()</code>, <code>array_find()</code>, <code>array_find_key()</code>, <code>array_all()</code>, and <code>array_any()</code> functions.',
+ 'new_tidy_methods' => 'New <code>tidyNode::getNextSibling()</code> and <code>tidyNode::getPreviousSibling()</code> methods.',
+ 'new_xml_methods' => 'New <code>XMLReader::fromStream()</code>, <code>XMLReader::fromUri()</code>, <code>XMLReader::fromString()</code>, <code>XMLWriter::toStream()</code>, <code>XMLWriter::toUri()</code>, and <code>XMLWriter::toMemory()</code> methods.',
+ 'new_xsl_method' => 'New <code>XSLTProcessor::registerPhpFunctionNS()</code> method.',


This whole thing is out of date because UPGRADING was not properly organised.

Girgias · 2024-10-03T18:42:33Z

releases/8.4/release.inc

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


Agreed, Lazy Objects would be more suited to highlight.

nielsdos · 2024-10-03T19:29:40Z

The rendering of the property hooks snippet is a bit ugly, screen resolution is 1920x1080

saundefined added 2 commits September 19, 2024 09:16

Initial commit for PHP 8.4 page

39c03e6

Additions for PHP 8.4 page

87d3794

TimWolla reviewed Oct 3, 2024

View reviewed changes

Girgias reviewed Oct 3, 2024

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[WIP] PHP 8.4 release page #1079

[WIP] PHP 8.4 release page #1079

saundefined commented Sep 22, 2024

github-actions bot commented Sep 22, 2024

github-actions bot commented Sep 22, 2024

TimWolla Oct 3, 2024

TimWolla Oct 3, 2024

TimWolla Oct 3, 2024

TimWolla Oct 3, 2024

nielsdos Oct 3, 2024

TimWolla Oct 4, 2024

TimWolla Oct 3, 2024

Girgias Oct 3, 2024

theodorejb Oct 3, 2024

TimWolla Oct 3, 2024

TimWolla Oct 3, 2024

TimWolla Oct 3, 2024

Girgias left a comment

Girgias Oct 3, 2024

Girgias Oct 3, 2024

Girgias Oct 3, 2024

nielsdos commented Oct 3, 2024

		$phpVersion = new PhpVersion();
		$foo->version = 'PHP 8.4'; // No error

		$phpVersion = new PhpVersion();
		$foo->version = 'PHP 8.3'; // Visibility error

[WIP] PHP 8.4 release page #1079

Are you sure you want to change the base?

[WIP] PHP 8.4 release page #1079

Conversation

saundefined commented Sep 22, 2024

github-actions bot commented Sep 22, 2024

github-actions bot commented Sep 22, 2024

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Girgias left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

nielsdos commented Oct 3, 2024