status = $status;
}
public function getStatus(): Status
{
return $this->status;
}
}
PHP,
after: <<<'PHP'
class BlogData
{
public readonly Status $status;
public function __construct(Status $status)
{
$this->status = $status;
}
}
PHP,
),
new FeatureComparison(
id: 'first_class_callable_syntax',
title: message('first_class_callable_syntax_title', $lang),
description: message('first_class_callable_syntax_content', $lang),
links: [
'RFC|https://wiki.php.net/rfc/first_class_callable_syntax',
message('documentation', $lang) . "|/manual/$documentation/functions.first_class_callable_syntax.php",
],
before: <<<'PHP'
$foo = [$this, 'foo'];
$fn = Closure::fromCallable('strlen');
PHP,
after: <<<'PHP'
$foo = $this->foo(...);
$fn = strlen(...);
PHP,
),
new FeatureComparison(
id: 'new_in_initializers',
title: message('new_in_initializers_title', $lang),
description: message('new_in_initializers_content', $lang),
links: ['RFC|https://wiki.php.net/rfc/new_in_initializers'],
before: <<<'PHP'
class Service
{
private Logger $logger;
public function __construct(
?Logger $logger = null,
) {
$this->logger = $logger ?? new NullLogger();
}
}
PHP,
after: <<<'PHP'
class Service
{
private Logger $logger;
public function __construct(
Logger $logger = new NullLogger(),
) {
$this->logger = $logger;
}
}
PHP,
before2: <<<'PHP'
class User
{
/**
* @Assert\All({
* @Assert\NotNull,
* @Assert\Length(min=5)
* })
*/
public string $name = '';
}
PHP,
after2: <<<'PHP'
class User
{
#[\Assert\All(
new \Assert\NotNull,
new \Assert\Length(min: 5))
]
public string $name = '';
}
PHP,
),
new FeatureComparison(
id: 'pure_intersection_types',
title: message('pure_intersection_types_title', $lang),
description: message('pure_intersection_types_content', $lang),
links: [
'RFC|https://wiki.php.net/rfc/pure-intersection-types',
message('documentation', $lang) . "|/manual/$documentation/language.types.declarations.php#language.types.declarations.composite.intersection",
],
before: <<<'PHP'
function count_and_iterate(Iterator $value) {
if (!($value instanceof Countable)) {
throw new TypeError('value must be Countable');
}
foreach ($value as $val) {
echo $val;
}
count($value);
}
PHP,
after: <<<'PHP'
function count_and_iterate(Iterator&Countable $value) {
foreach ($value as $val) {
echo $val;
}
count($value);
}
PHP,
),
new FeatureComparison(
id: 'never_return_type',
title: message('never_return_type_title', $lang),
description: message('never_return_type_content', $lang),
links: [
'RFC|https://wiki.php.net/rfc/noreturn_type',
message('documentation', $lang) . "|/manual/$documentation/language.types.declarations.php#language.types.declarations.never",
],
before: <<<'PHP'
function redirect(string $uri) {
header('Location: ' . $uri);
exit();
}
function redirectToLoginPage() {
redirect('/login');
echo 'Hello'; // <- dead code
}
PHP,
after: <<<'PHP'
function redirect(string $uri): never {
header('Location: ' . $uri);
exit();
}
function redirectToLoginPage(): never {
redirect('/login');
echo 'Hello'; // <- dead code detected by static analysis
}
PHP,
),
new FeatureComparison(
id: 'final_class_constants',
title: message('final_class_constants_title', $lang),
description: message('final_class_constants_content', $lang),
links: [
'RFC|https://wiki.php.net/rfc/final_class_const',
message('documentation', $lang) . "|/manual/$documentation/language.oop5.final.php#language.oop5.final.example.php81",
],
before: <<<'PHP'
class Foo
{
public const XX = "foo";
}
class Bar extends Foo
{
public const XX = "bar"; // No error
}
PHP,
after: <<<'PHP'
class Foo
{
final public const XX = "foo";
}
class Bar extends Foo
{
public const XX = "bar"; // Fatal error
}
PHP,
),
new FeatureComparison(
id: 'explicit_octal_numeral_notation',
title: message('octal_numeral_notation_title', $lang),
description: message('octal_numeral_notation_content', $lang),
links: [
'RFC|https://wiki.php.net/rfc/explicit_octal_notation',
message('documentation', $lang) . "|/manual/$documentation/migration81.new-features.php#migration81.new-features.core.octal-literal-prefix",
],
before: <<<'PHP'
016 === 16; // false because `016` is octal for `14` and it's confusing
016 === 14; // true
PHP,
after: <<<'PHP'
0o16 === 16; // false — not confusing with explicit notation
0o16 === 14; // true
PHP,
),
new FeatureComparison(
id: 'fibers',
title: message('fibers_title', $lang),
description: message('fibers_content', $lang),
links: [
'RFC|https://wiki.php.net/rfc/fibers',
message('documentation', $lang) . "|/manual/$documentation/language.fibers.php",
],
before: <<<'PHP'
$httpClient->request('https://example.com/')
->then(function (Response $response) {
return $response->getBody()->buffer();
})
->then(function (string $responseBody) {
print json_decode($responseBody)['code'];
});
PHP,
after: <<<'PHP'
$response = $httpClient->request('https://example.com/');
print json_decode($response->getBody()->buffer())['code'];
PHP,
),
new FeatureComparison(
id: 'array_unpacking_support_for_string_keyed_arrays',
title: message('array_unpacking_title', $lang),
description: message('array_unpacking_content', $lang),
links: [
'RFC|https://wiki.php.net/rfc/array_unpacking_string_keys',
message('documentation', $lang) . "|/manual/$documentation/language.types.array.php#language.types.array.unpacking",
],
before: <<<'PHP'
$arrayA = ['a' => 1];
$arrayB = ['b' => 2];
$result = array_merge(['a' => 0], $arrayA, $arrayB);
// ['a' => 1, 'b' => 2]
PHP,
after: <<<'PHP'
$arrayA = ['a' => 1];
$arrayB = ['b' => 2];
$result = ['a' => 0, ...$arrayA, ...$arrayB];
// ['a' => 1, 'b' => 2]
PHP,
),
];
echo ReleasePage::getHeroSection(
title: message('main_title', $lang),
subtitle: message('main_subtitle', $lang),
logoSvg: <<
SVG,
upgradeNow: message('upgrade_now', $lang),
);
echo ReleasePage::getFeatureComparisons($comparisons, 'PHP 8.1', 'PHP < 8.1');
?>
false]);
