Skip to content

Commit

Permalink
PHP 8.3 release page updates
Browse files Browse the repository at this point in the history 
Closes #827

Co-authored-by: Florian <[email protected]>
  • Loading branch information
@saundefined @Flote37
saundefined and Flote37 committed Nov 21, 2023
1 parent 23ecbbc commit 55390a7
Show file tree
Hide file tree
Showing 3 changed files with 46 additions and 42 deletions.
9 changes: 5 additions & 4 deletions releases/8.3/languages/en.php
View file
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
<?php

return [
'common_header' => 'PHP 8.3 is a major update of the PHP language. It contains many new features, such as explicit typing of class constants, deep-cloning of readonly properties and additions to the randomness functionality. As always it also includes performance improvements, bug fixes and general cleanup.',
'common_header' => 'PHP 8.3 is a major update of the PHP language. It contains many new features, such as explicit typing of class constants, deep-cloning of readonly properties 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.3 is a major update of the PHP language.<br class="display-none-md">It contains many new features, such as explicit typing of class constants, deep-cloning of readonly properties and additions to the randomness functionality. As always it also includes performance improvements, bug fixes and general cleanup.',
'main_subtitle' => 'PHP 8.3 is a major update of the PHP language.<br class="display-none-md">It contains many new features, such as explicit typing of class constants, deep-cloning of readonly properties and additions to the randomness functionality. As always it also includes performance improvements, bug fixes, and general cleanup.',
'upgrade_now' => 'Upgrade to PHP 8.3 now!',

'readonly_title' => 'Deep-cloning of readonly properties',
Expand All @@ -15,7 +15,7 @@
'override_title' => 'New <code>#[\Override]</code> attribute',
'override_description' => 'By adding the <code>#[\Override]</code> attribute to a method, PHP will ensure that a method with the same name exists in a parent class or in an implemented interface. Adding the attribute makes it clear that overriding a parent method is intentional and simplifies refactoring, because the removal of an overridden parent method will be detected.',
'randomizer_getbytesfromstring_title' => 'New <code>Randomizer<span style="word-break: break-all;">::</span>getBytesFromString()</code> method',
'randomizer_getbytesfromstring_description' => 'The <a href="/releases/8.2/en.php#random_extension">Random Extension</a> that was added in PHP 8.2 was extended by a new method to generate random strings consisting of specific bytes only. This method allows to easily generate random identifiers, such as domain names, and numeric strings of arbitrary length.',
'randomizer_getbytesfromstring_description' => 'The <a href="/releases/8.2/en.php#random_extension">Random Extension</a> that was added in PHP 8.2 was extended by a new method to generate random strings consisting of specific bytes only. This method allows the developer to easily generate random identifiers, such as domain names, and numeric strings of arbitrary length.',
'randomizer_getfloat_nextfloat_title' => 'New <code>Randomizer::getFloat()</code> and <code>Randomizer::nextFloat()</code> methods',
'randomizer_getfloat_nextfloat_description' => '<p>Due to the limited precision and implicit rounding of floating point numbers, generating an unbiased float lying within a specific interval is non-trivial and the commonly used userland solutions may generate biased results or numbers outside the requested range.</p><p>The Randomizer was also extended with two methods to generate random floats in an unbiased fashion. The <code>Randomizer::getFloat()</code> method uses the γ-section algorithm that was published in <a href="https://doi.org/10.1145/3503512" target="_blank" rel="noopener noreferrer">Drawing Random Floating-Point Numbers from an Interval. Frédéric Goualard, ACM Trans. Model. Comput. Simul., 32:3, 2022.</a></p>',
'dynamic_class_constant_fetch_title' => 'Dynamic class constant fetch',
Expand All @@ -28,7 +28,7 @@
'new_posix' => 'New <a href="/manual/en/function.posix-sysconf.php"><code>posix_sysconf()</code></a>, <a href="/manual/en/function.posix-pathconf.php"><code>posix_pathconf()</code></a>, <a href="/manual/en/function.posix-fpathconf.php"><code>posix_fpathconf()</code></a>, and <a href="/manual/en/function.posix-eaccess.php"><code>posix_eaccess()</code></a> functions.',
'new_reflection' => 'New <a href="/manual/en/reflectionmethod.createfrommethodname.php"><code>ReflectionMethod::createFromMethodName()</code></a> method.',
'new_socket' => 'New <a href="/manual/en/function.socket-atmark.php"><code>socket_atmark()</code></a> function.',
'new_str' => 'New <a href="/manual/en/function.str-increment.php"><code>str_increment()</code></a>, <a href="/manual/en/function.str-decrement.php"><code>str_decrement()</code></a>, and <a href="/manual/en/function.stream-context-set-option.php"><code>stream_context_set_options()</code></a> functions.',
'new_str' => 'New <a href="/manual/en/function.str-increment.php"><code>str_increment()</code></a>, <a href="/manual/en/function.str-decrement.php"><code>str_decrement()</code></a>, and <a href="/manual/en/function.stream-context-set-options.php"><code>stream_context_set_options()</code></a> functions.',
'new_ziparchive' => 'New <a href="/manual/en/ziparchive.getarchiveflag.php"><code>ZipArchive::getArchiveFlag()</code></a> method.',
'new_openssl_ec' => 'Support for generation EC keys with custom EC parameters in OpenSSL extension.',
'new_ini' => 'New INI setting <a href="/manual/en/migration83.other-changes.php#migration83.other-changes.ini"><code>zend.max_allowed_stack_size</code></a> to set the maximum allowed stack size.',
Expand All @@ -42,6 +42,7 @@
'bc_mtrand' => 'The <a href="/manual/en/random.constants.php#constant.mt-rand-php"><code>MT_RAND_PHP</code></a> Mt19937 variant is deprecated.',
'bc_reflection' => '<a href="/manual/en/reflectionclass.getstaticproperties.php"><code>ReflectionClass::getStaticProperties()</code></a> is no longer nullable.',
'bc_ini' => 'INI settings <a href="/manual/en/info.configuration.php#ini.assert.active"><code>assert.active</code></a>, <a href="/manual/en/info.configuration.php#ini.assert.bail"><code>assert.bail</code></a>, <a href="/manual/en/info.configuration.php#ini.assert.callback"><code>assert.callback</code></a>, <a href="/manual/en/info.configuration.php#ini.assert.exception"><code>assert.exception</code></a>, and <a href="/manual/en/info.configuration.php#ini.assert.warning"><code>assert.warning</code></a> have been deprecated.',
'bc_standard' => 'Calling <a href="/manual/en/function.get-class.php"><code>get_class()</code></a> and <a href="/manual/en/function.get-parent-class.php"><code>get_parent_class()</code></a> without arguments are deprecated.',

'footer_title' => 'Better performance, better syntax, improved type safety.',
'footer_description' => '<p>For source downloads of PHP 8.3 please visit the <a href="/downloads">downloads</a> page. Windows binaries can be found on the <a href="https://windows.php.net/download">PHP for Windows</a> site. The list of changes is recorded in the <a href="/ChangeLog-8.php#PHP_8_3">ChangeLog</a>.</p>
Expand Down
3 changes: 2 additions & 1 deletion releases/8.3/languages/ru.php
View file
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
'new_posix' => 'Новые функции <a href="/manual/ru/function.posix-sysconf.php"><code>posix_sysconf()</code></a>, <a href="/manual/ru/function.posix-pathconf.php"><code>posix_pathconf()</code></a>, <a href="/manual/ru/function.posix-fpathconf.php"><code>posix_fpathconf()</code></a> и <a href="/manual/ru/function.posix-eaccess.php"><code>posix_eaccess()</code></a>.',
'new_reflection' => 'Новый метод <a href="/manual/ru/reflectionmethod.createfrommethodname.php"><code>ReflectionMethod::createFromMethodName()</code></a>.',
'new_socket' => 'Новая функция <a href="/manual/ru/function.socket-atmark.php"><code>socket_atmark()</code></a>.',
'new_str' => 'Новые функции <a href="/manual/ru/function.str-increment.php"><code>str_increment()</code></a>, <a href="/manual/ru/function.str-decrement.php"><code>str_decrement()</code></a> и <a href="/manual/ru/function.stream-context-set-option.php"><code>stream_context_set_options()</code></a>.',
'new_str' => 'Новые функции <a href="/manual/ru/function.str-increment.php"><code>str_increment()</code></a>, <a href="/manual/ru/function.str-decrement.php"><code>str_decrement()</code></a> и <a href="/manual/ru/function.stream-context-set-options.php"><code>stream_context_set_options()</code></a>.',
'new_ziparchive' => 'Новый метод <a href="/manual/ru/ziparchive.getarchiveflag.php"><code>ZipArchive::getArchiveFlag()</code></a>.',
'new_openssl_ec' => 'Поддержка генерации EC-ключей с пользовательскими EC-параметрами в модуле OpenSSL.',
'new_ini' => 'Новый параметр INI <a href="/manual/ru/migration83.other-changes.php#migration83.other-changes.ini"><code>zend.max_allowed_stack_size</code></a> для установки максимально допустимого размера стека.',
Expand All @@ -42,6 +42,7 @@
'bc_mtrand' => 'Вариант Mt19937 <a href="/manual/ru/random.constants.php#constant.mt-rand-php"><code>MT_RAND_PHP</code></a> объявлен устаревшим.',
'bc_reflection' => '<a href="/manual/ru/reflectionclass.getstaticproperties.php"><code>ReflectionClass::getStaticProperties()</code></a> теперь не возвращает значение <code>null</code>.',
'bc_ini' => 'Параметры INI <a href="/manual/ru/info.configuration.php#ini.assert.active"><code>assert.active</code></a>, <a href="/manual/ru/info.configuration.php#ini.assert.bail"><code>assert.bail</code></a>, <a href="/manual/ru/info.configuration.php#ini.assert.callback"><code>assert.callback</code></a>, <a href="/manual/ru/info.configuration.php#ini.assert.exception"><code>assert.exception</code></a> и <a href="/manual/ru/info.configuration.php#ini.assert.warning"><code>assert.warning</code></a> объявлены устаревшими.',
'bc_standard' => 'Вызов функции <a href="/manual/en/function.get-class.php"><code>get_class()</code></a> и <a href="/manual/en/function.get-parent-class.php"><code>get_parent_class()</code></a> без аргументов объявлен устаревшим.',

'footer_title' => 'Выше производительность, лучше синтаксис, надёжнее система типов.',
'footer_description' => '<p>Для загрузки исходного кода PHP 8.3 посетите страницу <a href="/downloads">Downloads</a>. Бинарные файлы Windows находятся на сайте <a href="https://windows.php.net/download">PHP for Windows</a>. Список изменений перечислен на странице <a href="/ChangeLog-8.php#PHP_8_3">ChangeLog</a>.</p>
Expand Down
76 changes: 39 additions & 37 deletions releases/8.3/release.inc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -141,17 +141,14 @@ PHP
<<<'PHP'
use PHPUnit\Framework\TestCase;
final class MyTest extends TestCase
{
final class MyTest extends TestCase {
protected $logFile;
protected function setUp(): void
{
protected function setUp(): void {
$this->logFile = fopen('/tmp/logfile', 'w');
}
protected function taerDown(): void
{
protected function taerDown(): void {
fclose($this->logFile);
unlink('/tmp/logfile');
}
Expand All @@ -172,18 +169,15 @@ PHP
<<<'PHP'
use PHPUnit\Framework\TestCase;
final class MyTest extends TestCase
{
final class MyTest extends TestCase {
protected $logFile;
protected function setUp(): void
{
protected function setUp(): void {
$this->logFile = fopen('/tmp/logfile', 'w');
}
#[\Override]
protected function taerDown(): void
{
protected function taerDown(): void {
fclose($this->logFile);
unlink('/tmp/logfile');
}
Expand Down Expand Up @@ -213,23 +207,24 @@ PHP
<div class="php8-code phpcode">
<?php highlight_php_trimmed(
<<<'PHP'
readonly class Foo {
public \DateTime $dateTime;
class PHP {
public string $version = '8.2';
}
function __construct(\DateTime $dateTime) {
$this->dateTime = $dateTime;
}
readonly class Foo {
public function __construct(
public PHP $php
) {}
public function __clone()
{
$this->dateTime = clone $this->dateTime;
public function __clone(): void {
$this->php = clone $this->php;
}
}
$today = new Foo(new \DateTime());
$tomorrow = clone $today;
$instance = new Foo(new PHP());
$cloned = clone $instance;
// Fatal error: Cannot modify readonly property Foo::$dateTime
// Fatal error: Cannot modify readonly property Foo::$php
PHP

); ?>
Expand All @@ -241,23 +236,24 @@ PHP
<div class="php8-code phpcode">
<?php highlight_php_trimmed(
<<<'PHP'
readonly class Foo {
public \DateTime $dateTime;
class PHP {
public string $version = '8.2';
}
function __construct(\DateTime $dateTime) {
$this->dateTime = $dateTime;
}
readonly class Foo {
public function __construct(
public PHP $php
) {}
public function __clone()
{
$this->dateTime = clone $this->dateTime;
public function __clone(): void {
$this->php = clone $this->php;
}
}
$today = new Foo(new \DateTime());
$tomorrow = clone $today;
$instance = new Foo(new PHP());
$cloned = clone $instance;
$tomorrow->dateTime->modify('+1 day');
$cloned->php->version = '8.3';
PHP
); ?>
</div>
Expand All @@ -272,7 +268,8 @@ PHP
<h2 class="php8-h2" id="json_validate">
<?= message('json_validate_title', $lang) ?>
<a class="php8-rfc" href="https://wiki.php.net/rfc/json_validate">RFC</a>
<a class="php8-rfc" href="/manual/<?= $lang ?>/function.json-validate.php"><?= message('documentation', $lang) ?></a>
<a class="php8-rfc"
href="/manual/<?= $lang ?>/function.json-validate.php"><?= message('documentation', $lang) ?></a>
</h2>
<div class="php8-compare__main">
<div class="php8-compare__block example-contents">
Expand All @@ -282,6 +279,7 @@ PHP
<<<'PHP'
function json_validate(string $string): bool {
json_decode($string);
return json_last_error() === JSON_ERROR_NONE;
}
Expand Down Expand Up @@ -312,7 +310,8 @@ PHP
<h2 class="php8-h2" id="randomizer_get_bytes_from_string">
<?= message('randomizer_getbytesfromstring_title', $lang) ?>
<a class="php8-rfc" href="https://wiki.php.net/rfc/randomizer_additions#getbytesfromstring">RFC</a>
<a class="php8-rfc" href="/manual/<?= $lang ?>/random-randomizer.getbytesfromstring.php"><?= message('documentation', $lang) ?></a>
<a class="php8-rfc"
href="/manual/<?= $lang ?>/random-randomizer.getbytesfromstring.php"><?= message('documentation', $lang) ?></a>
</h2>
<div class="php8-compare__main">
<div class="php8-compare__block example-contents">
Expand Down Expand Up @@ -381,7 +380,8 @@ PHP
<h2 class="php8-h2" id="randomizer_get_float">
<?= message('randomizer_getfloat_nextfloat_title', $lang) ?>
<a class="php8-rfc" href="https://wiki.php.net/rfc/randomizer_additions#getfloat">RFC</a>
<a class="php8-rfc" href="/manual/<?= $lang ?>/random-randomizer.getfloat.php"><?= message('documentation', $lang) ?></a>
<a class="php8-rfc"
href="/manual/<?= $lang ?>/random-randomizer.getfloat.php"><?= message('documentation', $lang) ?></a>
</h2>
<div class="php8-compare__main">
<div class="php8-compare__block example-contents">
Expand All @@ -395,6 +395,7 @@ function getFloat(float $min, float $max) {
// return values outside the given range. This is impossible
// to work around in userland.
$offset = random_int(0, PHP_INT_MAX) / PHP_INT_MAX;
return $offset * ($max - $min) + $min;
}
Expand Down Expand Up @@ -474,6 +475,7 @@ PHP
<li><?= message('bc_mtrand', $lang) ?></li>
<li><?= message('bc_reflection', $lang) ?></li>
<li><?= message('bc_ini', $lang) ?></li>
<li><?= message('bc_standard', $lang) ?></li>
</ul>
</div>
</div>
Expand Down

0 comments on commit 55390a7

Please sign in to comment.