O PHP 8.2 \u00e9 uma grande atualiza\u00e7\u00e3o da linguagem PHP. Ela cont\u00e9m muitos recursos novos, incluindo classes somente leitura, null, false e true como tipos aut\u00f4nomos, propriedades din\u00e2micas obsoletas, melhorias de desempenho e muito mais.<\/p>\n\n\n\n
Vamos ao novo PHP 8.2<\/p>\n\n\n\n
<?php\n\n\/\/ PHP < 8.2\nclass BlogData\n{\n public readonly string $title;\n\n public readonly Status $status;\n\n public function __construct(string $title, Status $status)\n {\n $this->title = $title;\n $this->status = $status;\n }\n}\n\n\/\/ PHP 8.2\nreadonly class BlogData\n{\n public string $title;\n\n public Status $status;\n\n public function __construct(string $title, Status $status)\n {\n $this->title = $title;\n $this->status = $status;\n }\n}<\/code><\/pre>\n\n\n\nFuncionalmente, tornar uma classe somente leitura \u00e9 o mesmo que tornar todas as propriedades somente leitura; mas tamb\u00e9m impedir\u00e1 que propriedades din\u00e2micas sejam adicionadas a uma classe.<\/p>\n\n\n\n
Observe que voc\u00ea s\u00f3 pode estender de classes somente leitura se a classe filha tamb\u00e9m for somente leitura.<\/p>\n\n\n\n
O PHP mudou bastante e as classes somente leitura s\u00e3o uma adi\u00e7\u00e3o bem-vinda. Voc\u00ea tamb\u00e9m pode dar uma olhada no meu v\u00eddeo sobre a evolu\u00e7\u00e3o do PHP.<\/p>\n\n\n\n
Tipos de forma normal disjuntiva – DNF<\/h2>\n\n\n\n<?php\n\n\/\/ PHP < 8.2\nclass Foo {\n public function bar(mixed $entity) {\n if ((($entity instanceof A) && ($entity instanceof B)) || ($entity === null)) {\n return $entity;\n }\n\n throw new Exception('Invalid entity');\n }\n}\n\n\/\/ PHP 8.2\nclass Foo {\n public function bar((A&B)|null $entity) {\n return $entity;\n }\n}<\/code><\/pre>\n\n\n\nO Disjunctive Normal Form (DNF) \u00e9 uma forma padronizada de organizar express\u00f5es booleanas. Ela consiste em uma disjun\u00e7\u00e3o de conjun\u00e7\u00f5es \u2013 em termos booleanos, que \u00e9 um OR de AND.<\/p>\n\n\n\n
Os tipos DNF permitem combinar os tipos uni\u00e3o e interse\u00e7\u00e3o, seguindo uma regra estrita: ao combinar os tipos uni\u00e3o e interse\u00e7\u00e3o, os tipos de interse\u00e7\u00e3o devem ser agrupados entre colchetes. Na pr\u00e1tica, fica assim:<\/p>\n\n\n\n
<?php\n\n\/\/ Veja mais um exemplo\n\nfunction generateSlug((HasTitle&HasId)|null $post) \n{\n if ($post === null) {\n return '';\n }\n\n return \n strtolower($post->getTitle()) \n . $post->getId();\n}<\/code><\/pre>\n\n\n\nNeste caso, \u00e9 o tipo DNF.(HasTitle&HasId)|null<\/p>\n\n\n\n
\u00c9 uma boa adi\u00e7\u00e3o, especialmente porque significa que agora podemos ter tipos de interse\u00e7\u00e3o anul\u00e1veis, que provavelmente \u00e9 o caso de uso mais importante para esse recurso.<\/p>\n\n\n\n
O PHP 8.2 aborda v\u00e1rias defici\u00eancias e restri\u00e7\u00f5es do sistema de tipo do PHP, permitindo que os aplicativos PHP desfrutem de melhor seguran\u00e7a de tipo. Isso inclui adicionar suporte para truetype e permitir que tipos nulle falsesejam usados \u200b\u200bcomo tipos aut\u00f4nomos e suporte para tipos DNF.<\/p>\n\n\n\n
O PHP 8.2 suporta tipos Disjoint Normal Form (DNF) \u2014 Agora \u00e9 poss\u00edvel combinar tipos de uni\u00e3o (PHP 8.0) e tipos de interse\u00e7\u00e3o (PHP 8.1) , tornando poss\u00edvel declarar par\u00e2metros precisos e expressivos, retorno e tipos de propriedade.<\/p>\n\n\n\n
Permitir null, false e true<\/em><\/strong> como tipos aut\u00f4nomos<\/h2>\n\n\n\n<?php\n\n\/\/ PHP < 8.2\n\nclass Falsy\n{\n public function almostFalse(): bool { \/* ... *\/ *}\n\n public function almostTrue(): bool { \/* ... *\/ *}\n\n public function almostNull(): string|null { \/* ... *\/ *}\n}\n\n\/\/ PHP 8.2\n\nclass Falsy\n{\n public function alwaysFalse(): false { \/* ... *\/ *}\n\n public function alwaysTrue(): true { \/* ... *\/ *}\n\n public function alwaysNull(): null { \/* ... *\/ *}\n}<\/code><\/pre>\n\n\n\nCom o PHP 8.0, os usu\u00e1rios receberam suporte para Union Types. Voc\u00ea pode declarar um tipo como uma uni\u00e3o de dois ou mais tipos. Mesmo que voc\u00ea pudesse usar false e null como tipos poss\u00edveis, n\u00e3o era permitido us\u00e1-los como tipos aut\u00f4nomos.<\/p>\n\n\n\n
Com o PHP 8.2, ser\u00e1 poss\u00edvel usar false e null como tipos aut\u00f4nomos. Com esta adi\u00e7\u00e3o, o sistema de tipos do PHP ser\u00e1 mais descritivo, pois voc\u00ea poder\u00e1 declarar com mais precis\u00e3o os tipos de retorno, par\u00e2metro e propriedade.<\/p>\n\n\n\n
Exemplos comuns s\u00e3o as fun\u00e7\u00f5es internas do PHP, onde false<\/em><\/strong> \u00e9 usado como o tipo de retorno para quando ocorre um erro. Por exemplo em file_get_contents:<\/p>\n\n\n\n<?php\n\nfile_get_contents(\/* \u2026 *\/): string|false<\/code><\/pre>\n\n\n\nAntes do PHP 8.2, voc\u00ea j\u00e1 podia usar false<\/em><\/strong> junto com outros tipos como uma uni\u00e3o; mas agora tamb\u00e9m pode ser usado como um tipo aut\u00f4nomo:<\/p>\n\n\n\n<?php\n\nfunction alwaysFalse(): false\n{\n return false;\n}<\/code><\/pre>\n\n\n\nO mesmo agora vale para true e null.<\/em><\/strong><\/p>\n\n\n\nNova extens\u00e3o aleat\u00f3ria<\/h2>\n\n\n\n
O PHP 8.2 adiciona um novo gerador de n\u00fameros aleat\u00f3rios que corrige muitos problemas com o anterior: \u00e9 mais eficiente, mais seguro, mais f\u00e1cil de manter e n\u00e3o depende do estado global; eliminando uma s\u00e9rie de bugs dif\u00edceis de detectar ao usar as fun\u00e7\u00f5es aleat\u00f3rias do PHP.<\/p>\n\n\n\n
H\u00e1 uma nova classe chamada Randomizer<\/em><\/strong>, que aceita um mecanismo aleat\u00f3rio. Agora voc\u00ea pode mudar esse motor, dependendo de suas necessidades. Por exemplo, para diferenciar entre um ambiente de produ\u00e7\u00e3o e de teste.<\/p>\n\n\n\n<?php\n\n$rng = $is_production\n ? new Random\\Engine\\Secure()\n : new Random\\Engine\\Mt19937(1234);\n \n$randomizer = new Random\\Randomizer($rng);\n$randomizer->shuffleString('foobar');<\/code><\/pre>\n\n\n\nAo longo da hist\u00f3ria do PHP, ele suportou v\u00e1rios Geradores de N\u00fameros Aleat\u00f3rios (RNG) com v\u00e1rios graus de desempenho, casos de uso e ajuste para aplicativos seguros. O PHP 8.2 d\u00e1 um passo adiante ao refatorar todas as funcionalidades relacionadas ao RNG para uma nova extens\u00e3o chamada random<\/em><\/strong>.<\/p>\n\n\n\nA random<\/em><\/strong> extens\u00e3o fornece a mesma funcionalidade sem interromper nenhuma API, portanto, as fun\u00e7\u00f5es , rand<\/em><\/strong>, e existentes continuam a funcionar sem altera\u00e7\u00f5es. Ele tamb\u00e9m fornece uma nova API OOP para gerar n\u00fameros aleat\u00f3rios com uma arquitetura conect\u00e1vel, portanto, agora \u00e9 f\u00e1cil zombar do RNG e fornecer novos RNGs, tornando os aplicativos PHP seguros e f\u00e1ceis de testar. mt_rand , random_bytes , random_int<\/em><\/strong><\/p>\n\n\n\nConstantes em tra\u00e7os<\/h2>\n\n\n\n<?php\n\n\/\/ PHP 8.2\n\ntrait Foo\n{\n public const CONSTANT = 1;\n}\n\nclass Bar\n{\n use Foo;\n}\n\nvar_dump(Bar::CONSTANT); \/\/ 1\nvar_dump(Foo::CONSTANT); \/\/ Error<\/code><\/pre>\n\n\n\nVoc\u00ea n\u00e3o pode acessar a constante pelo nome da constante, mas pode acessar a constante pela classe que usa a constante.<\/p>\n\n\n\n
No PHP 8.2, agora \u00e9 poss\u00edvel declarar constantes em traits<\/em><\/strong> . As caracter\u00edsticas n\u00e3o podem ser acessadas diretamente, mas essas constantes tornam-se constantes de classe quando uma classe usa a constante.<\/p>\n\n\n\n<?php\n\ntrait FooBar {\n const FOO = 'foo';\n private const BAR = 'bar';\n final const BAZ = 'baz';\n final protected const QUX = 'qux';\n}\n\nclass Test {\n use FooBar;\n}\n\necho Test::BAZ; \/\/ 'bar'<\/code><\/pre>\n\n\n\nIsso n\u00e3o era permitido no PHP 8.1 e anteriores. Constantes n\u00e3o podem ser acessadas diretamente (ou FooBar::FOO seja, n\u00e3o s\u00e3o permitidas). As constantes de trait<\/em><\/strong> tamb\u00e9m n\u00e3o devem colidir com outros trait<\/em><\/strong> ou com a classe imediata que os usa.<\/p>\n\n\n\nReduzindo par\u00e2metros sens\u00edveis em Back-Trace<\/h2>\n\n\n\n
Como quase qualquer linguagem de programa\u00e7\u00e3o, o PHP permite rastrear sua pilha de chamadas em qualquer ponto da execu\u00e7\u00e3o do c\u00f3digo. O rastreamento da pilha facilita a depura\u00e7\u00e3o do c\u00f3digo para corrigir erros e gargalos de desempenho.<\/p>\n\n\n\n
A execu\u00e7\u00e3o de um rastreamento de pilha n\u00e3o impede a execu\u00e7\u00e3o do programa. Normalmente, a maioria dos tra\u00e7os de pilha s\u00e3o executados em segundo plano e s\u00e3o registrados silenciosamente \u2013 para inspe\u00e7\u00e3o posterior, se necess\u00e1rio.<\/p>\n\n\n\n
Entretanto, alguns desses tra\u00e7os detalhados da pilha PHP podem ser um inconveniente se voc\u00ea os compartilhar com servi\u00e7os de terceiros \u2013 geralmente para an\u00e1lise de registros de erros, rastreamento de erros, etc. Esses tra\u00e7os de pilha podem incluir informa\u00e7\u00f5es sens\u00edveis, como nomes de usu\u00e1rio, senhas e vari\u00e1veis de ambiente.<\/p>\n\n\n\n
O PHP 8.2 permite que voc\u00ea marque esses par\u00e2metros sens\u00edveis com um novo atributo \\SensitiveParameter. Qualquer par\u00e2metro marcado como sens\u00edvel n\u00e3o ser\u00e1 listado no seu backtraces. Assim, voc\u00ea pode compartilh\u00e1-los sem preocupa\u00e7\u00f5es com qualquer servi\u00e7o de terceiros.<\/p>\n\n\n\n
Aqui est\u00e1 um exemplo simples com um \u00fanico par\u00e2metro sens\u00edvel:<\/p>\n\n\n\n
<?php\n\nfunction example(\n $ham,\n #[\\SensitiveParameter] $eggs,\n $butter\n) {\n throw new \\Exception('Error');\n}\n\nexample('ham', 'eggs', 'butter');\n\n\/*\nFatal error: Uncaught Exception: Error in test.php:8\nStack trace:\n#0 test.php(11): test('ham', Object(SensitiveParameterValue), 'butter')\n#1 {main}\nthrown in test.php on line 8\n*\/<\/code><\/pre>\n\n\n\nQuando voc\u00ea gera um backtrace<\/strong>, qualquer par\u00e2metro com o atributo \\SensitiveParameter<\/em><\/strong> ser\u00e1 substitu\u00eddo por um objeto \\SensitiveParameterValue<\/em><\/strong>, e seu valor real nunca ser\u00e1 armazenado no tra\u00e7o. O objeto SensitiveParameterValue<\/em><\/strong> encapsula o valor real do par\u00e2metro \u2013 se voc\u00ea precisar dele por qualquer raz\u00e3o.<\/p>\n\n\n\nOutro exemplo:<\/p>\n\n\n\n
<?php\n\nfunction login(\n string $user,\n #[\\SensitiveParameter] string $password\n) {\n \/\/ \u2026\n \n throw new Exception('Error');\n}\n \nlogin('root', 'root');\n\n\/* \nFatal error: Uncaught Exception: Error in login.php:8\nStack trace:\n#0 login.php(11): login('root', Object(SensitiveParameterValue))\n#1 {main} thrown in login.php on line 8\n*\/<\/code><\/pre>\n\n\n\nCom a marca\u00e7\u00e3o de “par\u00e2metros sens\u00edveis” com um atributo, voc\u00ea n\u00e3o precise se preocupar com eles sendo listados em seus rastreamentos de pilha quando algo der errado.<\/p>\n\n\n\n
Melhorias nos enums<\/h2>\n\n\n\n
Quando os enums foram introduzidos, era imposs\u00edvel buscar as propriedades name e value<\/em><\/strong> de um enum em uma express\u00e3o constante. Resumimos alguns casos de express\u00f5es constantes em que esse foi o caso:<\/p>\n\n\n\n<?php\n\nclass Post\n{\n #[DefaultValue(Status::Draft->name)]\n public string $status = Status::Draft->name;\n\n public function updateStatus(string $status = Status::Draft->name): void\n {\n \/** \u2026 *\/\n }\n}\n\nconst STATUS = Status::Draft->name;<\/code><\/pre>\n\n\n\nEsta RFC prop\u00f5e permitir que o operador -> \/ ?-> busque enum<\/em><\/strong> propriedades nas express\u00f5es const.<\/p>\n\n\n\nA principal raz\u00e3o para este novo recurso \u00e9 que voc\u00ea n\u00e3o pode usar enum objetos em alguns lugares, como chaves de array. Em tal caso, voc\u00ea ter\u00e1 que repetir o valor do caso enum apenas para us\u00e1-lo.<\/p>\n\n\n\n
Permitir a busca de propriedades enum<\/em><\/strong> em lugares onde enum<\/em><\/strong> objetos n\u00e3o s\u00e3o permitidos pode simplificar este procedimento.<\/p>\n\n\n\n<?php\n\nenum A: string \n{\n case B = 'B';\n \n const C = [self::B->value => self::B];\n}\n<\/code><\/pre>\n\n\n\nE s\u00f3 por seguran\u00e7a, este RFC tamb\u00e9m inclui suporte para o operador nullsafe ?-> <\/p>\n\n\n\n
Deprecia\u00e7\u00f5es no PHP 8.2<\/h2>\n\n\n\n
O PHP 8.2 tamb\u00e9m traz uma boa quantidade de deprecia\u00e7\u00f5es. Quando uma sintaxe, fun\u00e7\u00e3o ou recurso \u00e9 obsoleto, o PHP emite um aviso de descontinua\u00e7\u00e3o que n\u00e3o deve interromper ou configurar corretamente os aplicativos PHP, mas \u00e9 registrado no log de erros.<\/p>\n\n\n\n
Observe que, desde o PHP 8.0, a configura\u00e7\u00e3o de relat\u00f3rio de erros padr\u00e3o do PHP \u00e9 definida comoE_ALL.<\/p>\n\n\n\n
<\/p>\n\n\n\n
Propriedades din\u00e2micas obsoletas<\/h2>\n\n\n\n
Uma das reprova\u00e7\u00f5es mais not\u00e1veis \u200b\u200bno PHP 8.2 \u00e9 que ele descontinua propriedades de classe que s\u00e3o declaradas dinamicamente . Existe uma op\u00e7\u00e3o de exclus\u00e3o, mas a abordagem recomendada \u00e9 declarar as propriedades de classe na declara\u00e7\u00e3o de classe, de prefer\u00eancia com uma declara\u00e7\u00e3o de tipo tamb\u00e9m.<\/p>\n\n\n\n
\/\/ PHP 8.2\n\nclass User {\n public int $uid;\n}\n\n$user = new User();\n$user->name = 'Foo';\n\n\/\/ Sa\u00edda:\n\/\/ Deprecated: Creation of dynamic property User::$name is deprecated in ... on<\/code><\/pre>\n\n\n\n\u00c9 prov\u00e1vel que muitos aplicativos PHP herdados sejam afetados por essa mudan\u00e7a, porque os aplicativos legados tendem a n\u00e3o declarar propriedades de classe quando s\u00e3o estendidos ou evolu\u00eddos ao longo dos anos com altera\u00e7\u00f5es.<\/p>\n\n\n\n
A corre\u00e7\u00e3o recomendada \u00e9 declarar as propriedades na classe:<\/p>\n\n\n\n
\/\/ PHP 8.2\n\nclass User {\n public int $uid;\n public string $name; \n}\n\n$user = new User();\n$user->name = 'Foo';<\/code><\/pre>\n\n\n\nutf8_encode e utf8_decode<\/em><\/strong> fun\u00e7\u00f5es obsoletas<\/h2>\n\n\n\nO PHP 8.2 finalmente deprecia as fun\u00e7\u00f5es utf8_encode e utf8_decode<\/em><\/strong> que infelizmente foram nomeadas sem notar que elas apenas codificam\/decodificam de Latin 1(ISO-8859-1).<\/p>\n\n\n\nA maioria dos aplicativos PHP que usam essas fun\u00e7\u00f5es tende a n\u00e3o estar ciente dessa defici\u00eancia. As substitui\u00e7\u00f5es recomendadas incluem a melhor funcionalidade fornecida por extens\u00f5es: mbstring, iconv e intl<\/em><\/strong>.<\/p>\n\n\n\n${var} Interpola\u00e7\u00e3o de string obsoleta<\/h2>\n\n\n\n
O PHP sempre deu suporte \u00e0 interpola\u00e7\u00e3o de vari\u00e1vel de string com ” foo {$bar} “<\/em><\/strong> padr\u00e3o e junto com uma sintaxe alternativa em que o cifr\u00e3o \u00e9 colocado fora das chaves (por exemplo ” foo ${bar} “<\/em><\/strong> , ).<\/p>\n\n\n\nNo PHP 8.2, a sintaxe alternativa de colocar o cifr\u00e3o fora das chaves \u00e9 obsoleta.<\/p>\n\n\n\n