{"id":65417,"date":"2023-12-02T04:26:28","date_gmt":"2023-12-02T07:26:28","guid":{"rendered":"https:\/\/kinsta.com\/pt\/?p=65417&preview=true&preview_id=65417"},"modified":"2023-12-04T07:10:41","modified_gmt":"2023-12-04T10:10:41","slug":"php-8-3","status":"publish","type":"post","link":"https:\/\/kinsta.com\/pt\/blog\/php-8-3\/","title":{"rendered":"PHP 8.3: O Que H\u00e1 de Novo e O Que Mudou na \u00daltima Vers\u00e3o"},"content":{"rendered":"

O PHP 8.3 foi lan\u00e7ado no prazo previsto, em 23 de novembro, e inclui muitos recursos novos e melhorias desde o lan\u00e7amento do PHP 8.2<\/a>. Embora seja oficialmente considerada uma vers\u00e3o secund\u00e1ria, algumas das mudan\u00e7as na vers\u00e3o 8.3 podem afetar diretamente seu trabalho com PHP, inclusive ajudando voc\u00ea a codificar mais rapidamente e com menos bugs.<\/p>\n

Vamos nos aprofundar e analisar as grandes \u2014 ou n\u00e3o t\u00e3o grandes \u2014 mudan\u00e7as que v\u00eam com essa \u00faltima vers\u00e3o.<\/p>\n

<\/div><\/kinsta-auto-toc>\n

Novos recursos e melhorias no PHP 8.3<\/h2>\n

Vamos come\u00e7ar explorando os recursos do PHP 8.3 que mais chamam a aten\u00e7\u00e3o.<\/p>\n

<\/div><\/kinsta-auto-toc>\n

Constantes de classe tipadas<\/h3>\n

A capacidade de declarar tipos para propriedades de classes tem estado dispon\u00edvel desde o PHP 7.4<\/a>. No entanto, apesar de v\u00e1rios ajustes na tipagem do PHP ao longo dos anos, isso n\u00e3o se estendia \u00e0s constantes \u2014 at\u00e9 agora.<\/p>\n

Constantes de classes \u2014 e isso tamb\u00e9m inclui constantes de interfaces, traits e enums \u2014 podem ser tipadas no PHP 8.3, tornando menos prov\u00e1vel que os desenvolvedores se desviem da inten\u00e7\u00e3o por tr\u00e1s da declara\u00e7\u00e3o inicial de uma constante.<\/p>\n

Aqui est\u00e1 um exemplo b\u00e1sico usando uma interface:<\/p>\n

\/\/ Legal:\ninterface ConstTest {\n    \/\/ Declared type and value are both strings\n    const string VERSION = \"PHP 8.3\";\n}\n\n\/\/ Illegal:\ninterface ConstTest {\n    \/\/ Type and value mismatch in this initial declaration\n    const float VERSION = \"PHP 8.3\";\n}<\/code><\/pre>\n
O verdadeiro valor dessas constantes de classe tipadas<\/a> \u00e9 revelado quando trabalhamos em classes derivadas das declara\u00e7\u00f5es base. Embora uma classe filha possa frequentemente atribuir um novo valor a uma constante, o PHP 8.3 pode ajudar a prevenir altera\u00e7\u00f5es acidentais no seu tipo de modo que ela se torne incompat\u00edvel com a declara\u00e7\u00e3o inicial:<\/p>\n
class ConstTest {\n    const string VERSION = \"PHP 8.2\";\n}\n\nclass MyConstTest extends ConstTest {\n\n    \/\/ Legal:\n    \/\/ It's OK to change the value of VERSION here\n    const string VERSION = \"PHP 8.3\";\n\n    \/\/ Illegal:\n    \/\/ Type must be declared if it was specified in the base class\n    const VERSION = \"PHP 8.3\";\n\n    \/\/ Illegal:\n    \/\/ In this case, we can't change the type declared in the \n    \/\/ base class, even if the new type and its value are compatible.\n    const float VERSION = 8.3;\n}<\/code><\/pre>\n
Lembre-se de que o tipo atribu\u00eddo a uma constante de classe pode variar ao “restringir” m\u00faltiplos tipos ou ao usar um tipo de outra forma compat\u00edvel:<\/p>\n
class ConstTest {\n    const string|float VERSION = \"PHP 8.2\";\n}\n\nclass MyConstTest extends ConstTest {\n\n    \/\/ Legal:\n    \/\/ Here, it's OK to narrow the type declaration to string or float\n    const string VERSION = \"PHP 8.3\";\n    const float VERSION = 8.3;\n\n    \/\/ Legal:\n    \/\/ Value could be an int, but it's compatible with float \n    const float VERSION = 8;\n\n    \/\/ Illegal:\n    \/\/ We can't widen the type options here to include int\n    const string|float|int VERSION = 8;\n}<\/code><\/pre>\n
Dois tipos suportados para outras propriedades ao validar valores de retorno \u2014 void<\/code> e never<\/code> \u2014 n\u00e3o s\u00e3o suportados como tipos de constantes de classe.<\/p>\n
Uma nova fun\u00e7\u00e3o json_validate()<\/code><\/h3>\n
Ao trabalhar com dados codificados em JSON, \u00e9 melhor saber se o payload \u00e9 sintaticamente v\u00e1lido antes de tentar fazer algo com ele.<\/p>\n
Em vers\u00f5es anteriores do PHP, os desenvolvedores usavam a fun\u00e7\u00e3o json_decode()<\/code> e verificavam se havia erros quando essa fun\u00e7\u00e3o tentava transformar dados JSON em arrays associativos ou objetos. A nova fun\u00e7\u00e3o json_validate()<\/a><\/code> do PHP 8.3 faz a verifica\u00e7\u00e3o de erros sem usar toda a mem\u00f3ria necess\u00e1ria para criar essas estruturas de arrays ou objetos.<\/p>\n
Portanto, no passado, voc\u00ea poderia validar um payload JSON mais ou menos assim:<\/p>\n
$obj = json_decode($maybeJSON);\n\nif (json_last_error() === JSON_ERROR_NONE) {\n    \/\/ Probably do something with $obj   \n}<\/code><\/pre>\n
Se voc\u00ea n\u00e3o for fazer algo imediatamente com $obj<\/code> no exemplo acima, s\u00e3o muitos recursos usados apenas para confirmar a validade do payload JSON original. No PHP 8.3, voc\u00ea pode poupar um pouco de mem\u00f3ria fazendo algo assim:<\/p>\n
if (json_validate($maybeJSON)) {\n    \/\/ Do something with $maybeJSON   \n}<\/code><\/pre>\n
Observa\u00e7\u00e3o:<\/strong> N\u00e3o faz muito sentido usar json_validate()<\/code> e, em seguida, executar imediatamente os dados em json_decode()<\/code>, ainda usando os recursos de mem\u00f3ria do decode. Provavelmente voc\u00ea ir\u00e1 preferir usar a nova fun\u00e7\u00e3o para validar o JSON antes de armazen\u00e1-lo em algum lugar ou entreg\u00e1-lo como resposta a uma solicita\u00e7\u00e3o.<\/p>\n
Clonagem profunda de propriedades readonly<\/code><\/h3>\n
A capacidade de declarar propriedades de classe individuais como readonly<\/code> apareceu no PHP 8.1<\/a>. O PHP 8.2 introduziu a capacidade de designar esse atributo a uma classe inteira<\/a>. No entanto, muitos desenvolvedores sentiram que as restri\u00e7\u00f5es impostas ao trabalhar com classes que continham tais propriedades dificultavam realizar uma programa\u00e7\u00e3o mais \u00fatil.<\/p>\n
Uma RFC para modificar o comportamento do readonly<\/code><\/a>\u00a0fez duas propostas:<\/p>\n
    \n
  1. Permitir que classes que n\u00e3o s\u00e3o readonly<\/code> estendam classes que s\u00e3o<\/li>\n
  2. Permitir que propriedades readonly<\/code> sejam reinicializadas ao clonar<\/li>\n<\/ol>\n
    A segunda proposta foi inclu\u00edda no PHP 8.3. A nova abordagem permite que inst\u00e2ncias de uma classe com propriedades readonly<\/code> sejam reinicializadas no m\u00e9todo m\u00e1gico __clone<\/code> (inclusive por meio de fun\u00e7\u00f5es invocadas desde __clone<\/code>).<\/p>\n
    Este exemplo de c\u00f3digo da RFC mostra como isso funciona:<\/p>\n
    class Foo {\n    public function __construct(\n        public readonly DateTime $bar,\n        public readonly DateTime $baz\n    ) {}\n \n    public function __clone() {\n        \/\/ $bar will get a new DateTime when clone is invoked\n        $this->bar = clone $this->bar; \n\n        \/\/ And this function will be called\n        $this->cloneBaz();\n    }\n \n    private function cloneBaz() {\n       \/\/ This is legal when called from within __clone\n        unset($this->baz); \n    }\n}\n \n$foo = new Foo(new DateTime(), new DateTime());\n$foo2 = clone $foo;<\/code><\/pre>\n
    Novo atributo #[\\Override]<\/code><\/h3>\n
    Ao implementar interfaces no PHP, os programadores fornecem funcionalidades detalhadas para os m\u00e9todos nomeados nessas interfaces. Ao criar uma inst\u00e2ncia de uma classe, os programadores podem substituir um m\u00e9todo principal criando uma vers\u00e3o alternativa com o mesmo nome e uma assinatura compat\u00edvel na classe filha.<\/p>\n
    Um problema \u00e9 que os programadores podem pensar<\/em> que est\u00e3o implementando um m\u00e9todo de interface ou substituindo um m\u00e9todo principal quando n\u00e3o est\u00e3o. Eles podem estar criando uma entidade totalmente separada devido a um erro de digita\u00e7\u00e3o no nome do m\u00e9todo da classe filha ou porque os m\u00e9todos foram removidos ou renomeados no c\u00f3digo principal.<\/p>\n
    O PHP 8.3 introduziu o atributo #[\\Override]<\/code> para ajudar os programadores a deixar claro que um m\u00e9todo deve ter alguma linhagem dentro do c\u00f3digo.<\/p>\n
    Aqui est\u00e1 um exemplo b\u00e1sico:<\/p>\n
    class A {\n    protected function ovrTest(): void {}\n}\n\n\/\/ This will work because ovrTest() \n\/\/ can be found in the parent class\nclass B extends A {\n    #[\\Override]\n    public function ovrTest(): void {}\n}\n\n\/\/ This will fail because ovrBest() \n\/\/ (probably a typo) is not in the parent\nclass C extends A {\n    #[\\Override]\n    public function ovrBest(): void {}\n}<\/code><\/pre>\n
    Busca din\u00e2mica de constantes de classe e membros de Enum<\/h3>\n
    Diferentemente de outras propriedades no c\u00f3digo PHP, a busca de constantes de classe e membros de Enum com nomes de vari\u00e1veis tem sido um pouco complicada. Antes do PHP 8.3, voc\u00ea talvez fizesse isso usando a fun\u00e7\u00e3o constant()<\/code> desta forma:<\/p>\n
    class MyClass {\n    public const THE_CONST = 9;\n}\n\nenum MyEnum int {\n    case FirstMember = 9;\n    case SecondMember = 9;\n}\n\n$constantName = 'THE_CONST';\n$memberName = 'FirstMember';\n\necho constant('MyClass::' . $constantName);\necho constant('MyEnum::' . $memberName)->value;<\/code><\/pre>\n
    Agora, usando as mesmas defini\u00e7\u00f5es de classe e de Enum acima, voc\u00ea pode obter o mesmo resultado no PHP 8.3 com a busca din\u00e2mica de constantes<\/a> desta forma:<\/p>\n
    $constantName = 'THE_CONST';\n$memberName = 'FirstMember';\n\necho MyClass::{$constantName};\necho MyEnum::{$memberName}->value;<\/code><\/pre>\n
    Novo m\u00e9todo getBytesFromString()<\/code><\/h3>\n
    Voc\u00ea j\u00e1 quis gerar strings aleat\u00f3rias usando uma cole\u00e7\u00e3o pr\u00e9-aprovada de caracteres? Agora voc\u00ea pode fazer isso facilmente com o m\u00e9todo getBytesFromString()<\/a><\/code>, que foi adicionado \u00e0 extens\u00e3o Random do PHP 8.3.<\/p>\n
    Esse novo m\u00e9todo \u00e9 simples: voc\u00ea passa a ele uma string de caracteres como material de origem e especifica quantos deles deseja usar. Em seguida, o m\u00e9todo selecionar\u00e1 bytes da string aleatoriamente at\u00e9 atingir o comprimento especificado.<\/p>\n
    Um exemplo simples:<\/p>\n
    $rando = new Random\\Randomizer();\n$alpha = 'ABCDEFGHJKMNPQRSTVWXYZ';\n\n$rando->getBytesFromString($alpha, 6); \/\/  \"MBXGWL\"\n$rando->getBytesFromString($alpha, 6); \/\/  \"LESPMG\"\n$rando->getBytesFromString($alpha, 6); \/\/  \"NVHWXC\"<\/code><\/pre>\n
    \u00c9 poss\u00edvel que o comprimento solicitado da sa\u00edda aleat\u00f3ria tenha mais bytes do que a string de entrada:<\/p>\n
    $rando = new Random\\Randomizer();\n$nums = '123456';\n\n$rando->getBytesFromString($nums, 10); \/\/  \"2526341615\"<\/code><\/pre>\n
    Com uma string de entrada de caracteres exclusivos, cada um tem a mesma chance de ser selecionado para o resultado aleat\u00f3rio. No entanto, os caracteres podem ser ponderados se aparecerem com mais frequ\u00eancia do que outros na entrada. Por exemplo:<\/p>\n
    $rando = new Random\\Randomizer();\n$weighted = 'AAAAA12345';\n\n$rando->getBytesFromString($weighted, 5); \/\/  \"1AA53\"\n$rando->getBytesFromString($weighted, 10); \/\/  \"42A5A1AA3A\"<\/code><\/pre>\n
    Novos m\u00e9todos getFloat()<\/code> e nextFloat()<\/code><\/h3>\n
    Tamb\u00e9m expandindo a extens\u00e3o Random, o PHP 8.3 apresenta dois novos m\u00e9todos para gerar valores aleat\u00f3rios de float: getFloat()<\/code> e nextFloat()<\/code>.<\/p>\n
    Por exemplo:<\/p>\n
    $rando = new Random\\Randomizer();\n\n\/\/ Generate a float value between a minimum \n\/\/  value of 0 and a maximum value of 5\n$rando->getFloat(0,5); \/\/ 2.3937446906217<\/code><\/pre>\n
    O m\u00e9todo getFloat()<\/code> tamb\u00e9m aceita um terceiro par\u00e2metro ap\u00f3s os valores m\u00ednimo e m\u00e1ximo. Usando um Enum Random\\IntervalBoundary<\/strong>, voc\u00ea pode determinar se os pr\u00f3prios valores m\u00ednimo e m\u00e1ximo podem ser retornados pela fun\u00e7\u00e3o.<\/p>\n
    Estas s\u00e3o as regras:<\/p>\n