Lançado!

PHP 8.3 é uma atualização importante da linguagem PHP.
Ela contém muitos recursos novos, como tipagem explícita de constantes de classe, clonagem profunda de propriedades somente leitura e adições à funcionalidade de aleatoriedade. Como sempre, também inclui melhorias de desempenho, correções de bugs e limpeza geral.

Atualize para PHP 8.3 agora!

Constantes de classe tipadas

interface I {
    // We may naively assume that the PHP constant is always a string.
    const PHP = 'PHP 8.2';
}

class Foo implements I {
    // But implementing classes may define it as an array.
    const PHP = [];
}

interface I {
    const string PHP = 'PHP 8.3';
}

class Foo implements I {
    const string PHP = [];
}

// Fatal error: Cannot use array as value for class constant
// Foo::PHP of type string

Recuperação dinâmica de constantes de classe

class Foo {
    const PHP = 'PHP 8.2';
}

$searchableConstant = 'PHP';

var_dump(constant(Foo::class . "::{$searchableConstant}"));

class Foo {
    const PHP = 'PHP 8.3';
}

$searchableConstant = 'PHP';

var_dump(Foo::{$searchableConstant});

Novo atributo `#[\Override]`

Ao adicionar o atributo #[\Override] a um método, o PHP garantirá que um método com o mesmo nome exista em uma classe pai ou em uma interface implementada. Adicionar o atributo torna claro que a sobreposição de um método pai é intencional e simplifica a refatoração, pois a remoção de um método pai sobreposto será detectada.

use PHPUnit\Framework\TestCase;

final class MyTest extends TestCase {
    protected $logFile;

    protected function setUp(): void {
        $this->logFile = fopen('/tmp/logfile', 'w');
    }

    protected function taerDown(): void {
        fclose($this->logFile);
        unlink('/tmp/logfile');
    }
}

// The log file will never be removed, because the
// method name was mistyped (taerDown vs tearDown).

use PHPUnit\Framework\TestCase;

final class MyTest extends TestCase {
    protected $logFile;

    protected function setUp(): void {
        $this->logFile = fopen('/tmp/logfile', 'w');
    }

    #[\Override]
    protected function taerDown(): void {
        fclose($this->logFile);
        unlink('/tmp/logfile');
    }
}

// Fatal error: MyTest::taerDown() has #[\Override] attribute,
// but no matching parent method exists

Clonagem profunda de propriedades somente leitura

Propriedades readonly agora podem ser modificadas uma vez dentro do método mágico __clone para permitir a clonagem profunda de propriedades somente leitura.

class PHP {
    public string $version = '8.2';
}

readonly class Foo {
    public function __construct(
        public PHP $php
    ) {}

    public function __clone(): void {
        $this->php = clone $this->php;
    }
}

$instance = new Foo(new PHP());
$cloned = clone $instance;

// Fatal error: Cannot modify readonly property Foo::$php

class PHP {
    public string $version = '8.2';
}

readonly class Foo {
    public function __construct(
        public PHP $php
    ) {}

    public function __clone(): void {
        $this->php = clone $this->php;
    }
}

$instance = new Foo(new PHP());
$cloned = clone $instance;

$cloned->php->version = '8.3';

Nova função `json_validate()`

json_validate() permite verificar se uma string é sintaticamente válida em JSON, sendo mais eficiente do que json_decode().

function json_validate(string $string): bool {
    json_decode($string);

    return json_last_error() === JSON_ERROR_NONE;
}

var_dump(json_validate('{ "test": { "foo": "bar" } }')); // true

var_dump(json_validate('{ "test": { "foo": "bar" } }')); // true

Novo método `Randomizer::getBytesFromString()`

A Extensão Random que foi adicionada no PHP 8.2 foi ampliada com um novo método para gerar strings aleatórias consistindo apenas de bytes específicos. Este método permite que o desenvolvedor gere facilmente identificadores aleatórios, como nomes de domínio e strings numéricas de comprimento arbitrário.

// This function needs to be manually implemented.
function getBytesFromString(string $string, int $length) {
    $stringLength = strlen($string);

    $result = '';
    for ($i = 0; $i < $length; $i++) {
        // random_int is not seedable for testing, but secure.
        $result .= $string[random_int(0, $stringLength - 1)];
    }

    return $result;
}

$randomDomain = sprintf(
    "%s.example.com",
    getBytesFromString(
        'abcdefghijklmnopqrstuvwxyz0123456789',
        16,
    ),
);

echo $randomDomain;

// A \Random\Engine may be passed for seeding,
// the default is the secure engine.
$randomizer = new \Random\Randomizer();

$randomDomain = sprintf(
    "%s.example.com",
    $randomizer->getBytesFromString(
        'abcdefghijklmnopqrstuvwxyz0123456789',
        16,
    ),
);

echo $randomDomain;

Novos métodos `Randomizer::getFloat()` e `Randomizer::nextFloat()`

Devido à precisão limitada e ao arredondamento implícito de números de ponto flutuante, gerar um float imparcial dentro de um intervalo específico não é trivial, e as soluções comumente usadas no nível do usuário podem gerar resultados tendenciosos ou números fora do intervalo solicitado.

O Randomizer também foi ampliado com dois métodos para gerar floats de maneira imparcial. O método Randomizer::getFloat() utiliza o algoritmo da seção γ que foi publicado em Drawing Random Floating-Point Numbers from an Interval. Frédéric Goualard, ACM Trans. Model. Comput. Simul., 32:3, 2022.

// Returns a random float between $min and $max, both including.
function getFloat(float $min, float $max) {
    // This algorithm is biased for specific inputs and may
    // 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;
}

$temperature = getFloat(-89.2, 56.7);

$chanceForTrue = 0.1;
// getFloat(0, 1) might return the upper bound, i.e. 1,
// introducing a small bias.
$myBoolean = getFloat(0, 1) < $chanceForTrue;

$randomizer = new \Random\Randomizer();

$temperature = $randomizer->getFloat(
    -89.2,
    56.7,
    \Random\IntervalBoundary::ClosedClosed,
);

$chanceForTrue = 0.1;
// Randomizer::nextFloat() is equivalent to
// Randomizer::getFloat(0, 1, \Random\IntervalBoundary::ClosedOpen).
// The upper bound, i.e. 1, will not be returned.
$myBoolean = $randomizer->nextFloat() < $chanceForTrue;

O linter de linha de comando suporta vários arquivos

O linter da linha de comando agora aceita vários nomes de arquivos para lint

php -l foo.php bar.php
No syntax errors detected in foo.php

php -l foo.php bar.php
No syntax errors detected in foo.php
No syntax errors detected in bar.php

Novas classes, interfaces e funções

Novos métodos DOMElement::getAttributeNames(), DOMElement::insertAdjacentElement(), DOMElement::insertAdjacentText(), DOMElement::toggleAttribute(), DOMNode::contains(), DOMNode::getRootNode(), DOMNode::isEqualNode(), DOMNameSpaceNode::contains() e DOMParentNode::replaceChildren().
Novos métodos IntlCalendar::setDate(), IntlCalendar::setDateTime(), IntlGregorianCalendar::createFromDate() e IntlGregorianCalendar::createFromDateTime().
Novas funções ldap_connect_wallet() e ldap_exop_sync().
Nova função mb_str_pad().
Novas funções posix_sysconf(), posix_pathconf(), posix_fpathconf() e posix_eaccess().
Novo método ReflectionMethod::createFromMethodName().
Nova função socket_atmark().
Nova função str_increment(), str_decrement() e stream_context_set_options().
Novo método ZipArchive::getArchiveFlag().
Suporte para geração de chaves EC com parâmetros EC personalizados na extensão OpenSSL.
Nova configuração INI zend.max_allowed_stack_size para definir o tamanho máximo permitido da pilha.
php.ini agora suporta sintaxe de valor substituto/padrão.
Classes anônimas agora podem ser somente leitura.

Alterações obsoletas e incompatibilidades com versões anteriores

Exceções de Date/Time mais apropriadas.
Atribuir um índice negativo n a um array vazio agora garantirá que o próximo índice seja n + 1 em vez de 0.
Alterações na função range().
Alterações na redeclaração de propriedades estáticas em traits.
A constante U_MULTIPLE_DECIMAL_SEPERATORS foi obsoleta em favor de U_MULTIPLE_DECIMAL_SEPARATORS.
A variante MT_RAND_PHP do Mt19937 está obsoleta.
O tipo de retorno de ReflectionClass::getStaticProperties() não será mais nulo.
As configurações INI assert.active, assert.bail, assert.callback, assert.exception e assert.warning foram obsoletas.
Chamar get_class() e get_parent_class() sem argumentos está obsoleto.
SQLite3: modo de erro padrão definido como exceções.

Melhorias de desempenho, sintaxe aprimorada e maior segurança de tipos.

Para downloads do código-fonte do PHP 8.3, visite a página de downloads. Binários para Windows podem ser encontrados no site PHP for Windows. A lista de alterações está registrada no ChangeLog.

O guia de migração está disponível no Manual do PHP. Consulte-o para obter uma lista detalhada de novos recursos e alterações incompatíveis com versões anteriores.