{"id":44394,"date":"2021-09-30T16:04:51","date_gmt":"2021-09-30T14:04:51","guid":{"rendered":"https:\/\/kinsta.com\/?p=100177"},"modified":"2023-08-22T04:45:45","modified_gmt":"2023-08-22T07:45:45","slug":"transpilacao-php","status":"publish","type":"post","link":"https:\/\/kinsta.com\/pt\/blog\/transpilacao-php\/","title":{"rendered":"O Guia Definitivo para a Transpila\u00e7\u00e3o do C\u00f3digo PHP"},"content":{"rendered":"

Em circunst\u00e2ncias ideais, n\u00f3s devemos usar o PHP 8.0<\/a> (a \u00faltima vers\u00e3o a partir do momento em que escrevemos este artigo) para todos os nossos sites e atualiz\u00e1-lo assim que uma nova vers\u00e3o for lan\u00e7ada. No entanto, os desenvolvedores freq\u00fcentemente precisar\u00e3o trabalhar com vers\u00f5es anteriores do PHP, como ao criar um plugin p\u00fablico para WordPress<\/a> ou trabalhar com c\u00f3digo antigo que impede a atualiza\u00e7\u00e3o do ambiente do webserver.<\/p>\n

Nessas situa\u00e7\u00f5es, n\u00f3s poder\u00edamos perder a esperan\u00e7a de usar o \u00faltimo c\u00f3digo do PHP. Mas h\u00e1 uma alternativa melhor: n\u00f3s ainda podemos escrever nosso c\u00f3digo fonte com o PHP 8.0 e transpilar para uma vers\u00e3o anterior do PHP – at\u00e9 mesmo para o PHP 7.1.<\/p>\n

Neste guia, n\u00f3s lhe ensinaremos tudo o que voc\u00ea precisa saber sobre a transpila\u00e7\u00e3o de c\u00f3digo PHP.<\/p>\n

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

O que \u00e9 transpila\u00e7\u00e3o?<\/h2>\n

Transpila\u00e7\u00e3o ou “Transpiling em Ingl\u00eas” converte o c\u00f3digo fonte de uma linguagem de programa\u00e7\u00e3o<\/a> em um c\u00f3digo fonte equivalente da mesma ou de uma linguagem de programa\u00e7\u00e3o diferente.<\/p>\n

Transpila\u00e7\u00e3o n\u00e3o \u00e9 um conceito novo dentro do desenvolvimento web: desenvolvedores do lado do cliente provavelmente estar\u00e3o familiarizados com o Babel<\/a>, um transpilador de c\u00f3digo JavaScript.<\/p>\n

Babel converte o c\u00f3digo JavaScript da moderna vers\u00e3o ECMAScript 2015+ em uma vers\u00e3o antiga e compat\u00edvel com os navegadores inferior . Por exemplo, dada uma fun\u00e7\u00e3o arrow ES2015:<\/p>\n

[2, 4, 6].map((n) => n * 2);\n<\/code><\/pre>\n
…Babel ir\u00e1 convert\u00ea-lo em sua vers\u00e3o ES5:<\/p>\n
[2, 4, 6].map(function(n) {\n  return n * 2;\n});\n<\/code><\/pre>\n
O que \u00e9 transpila\u00e7\u00e3o PHP?<\/h3>\n
O que \u00e9 potencialmente novo dentro do desenvolvimento web \u00e9 a possibilidade de transpilar o c\u00f3digo do lado do servidor, em particular o PHP.<\/p>\n
A transpila\u00e7\u00e3o do PHP funciona da mesma forma que a transpila\u00e7\u00e3o JavaScript: o c\u00f3digo fonte de uma vers\u00e3o moderna do PHP <\/a> \u00e9 convertido em um c\u00f3digo equivalente para uma vers\u00e3o PHP mais antiga.<\/p>\n
Seguindo o mesmo exemplo de antes, uma fun\u00e7\u00e3o arrow do PHP 7.4:<\/p>\n
$nums = array_map(fn($n) => $n * 2, [2, 4, 6]);\n<\/code><\/pre>\n
pode ser transpiladas para sua vers\u00e3o equivalente do PHP 7.3:<\/p>\n
$nums = array_map(\n  function ($n) {\n    return $n * 2;\n  },\n  [2, 4, 6]\n);\n<\/code><\/pre>\n
As fun\u00e7\u00f5es arrows podem ser transpiladas porque s\u00e3o syntactic sugar<\/a>, ou seja, uma nova sintaxe para produzir um comportamento existente. Este \u00e9 o fruto de baixa suspens\u00e3o.<\/p>\n
Entretanto, h\u00e1 tamb\u00e9m novas funcionalidades que criam um novo comportamento e, como tal, n\u00e3o haver\u00e1 c\u00f3digo equivalente para as vers\u00f5es anteriores do PHP. Esse \u00e9 o caso dos tipos de uni\u00e3o<\/a>, introduzidos no PHP 8.0:<\/p>\n
function someFunction(float|int $param): string|float|int|null\n{\n  \/\/ ...\n}\n<\/code><\/pre>\n
Nessas situa\u00e7\u00f5es, a transpila\u00e7\u00e3o ainda pode ser feita desde que o novo recurso seja necess\u00e1rio para o desenvolvimento, mas n\u00e3o para a produ\u00e7\u00e3o. Ent\u00e3o, n\u00f3s podemos simplesmente remover o recurso completamente do c\u00f3digo transpilado sem conseq\u00fc\u00eancias s\u00e9rias.<\/p>\n
Um desses exemplos s\u00e3o os tipos de uni\u00e3o. Este recurso \u00e9 usado para verificar se n\u00e3o h\u00e1 uma incompatibilidade entre o tipo de entrada e o valor fornecido, o que ajuda a prevenir bugs. Se houver um conflito com os tipos, haver\u00e1 um erro j\u00e1 em desenvolvimento e n\u00f3s devemos peg\u00e1-lo e corrigi-lo antes que o c\u00f3digo chegue \u00e0 produ\u00e7\u00e3o.<\/p>\n
Portanto, podemos nos dar ao luxo de remover o recurso do c\u00f3digo para produ\u00e7\u00e3o:<\/p>\n
function someFunction($param)\n{\n  \/\/ ...\n}\n<\/code><\/pre>\n
Se o erro ainda acontecer na produ\u00e7\u00e3o, a mensagem de erro lan\u00e7ada ser\u00e1 menos precisa do que se tiv\u00e9ssemos tipos de uni\u00e3o. No entanto, esta desvantagem potencial \u00e9 compensada pela capacidade de usar tipos de uni\u00e3o em primeiro lugar.<\/p>\n\n
Vantagens da transpila\u00e7\u00e3o do C\u00f3digo PHP<\/h2>\n
A transpila\u00e7\u00e3o permite codificar um aplicativo usando a \u00faltima vers\u00e3o do PHP e produzir uma vers\u00e3o que tamb\u00e9m funciona em ambientes que executam vers\u00f5es mais antigas do PHP.<\/p>\n
Isto pode ser particularmente \u00fatil para desenvolvedores que criam produtos antigo para o\u00a0content management systems (CMS)<\/a>. O WordPress, por exemplo, ainda suporta oficialmente o PHP 5.6<\/a> (apesar de recomendar o PHP 7.4+). A porcentagem de sites WordPress rodando vers\u00f5es PHP 5.6 a 7.2 – que todos est\u00e3o no Fim de vida “End-of-Life (EOL)”, significando que eles n\u00e3o est\u00e3o mais recebendo atualiza\u00e7\u00f5es de seguran\u00e7a – \u00e9 de 34,8%, e aqueles rodando em qualquer vers\u00e3o PHP que n\u00e3o seja a 8.0 \u00e9 de 99,5%:<\/p>\n
\"Estat\u00edsticas<\/a>
Estat\u00edsticas de uso do WordPress por vers\u00e3o. Fonte da imagem: WordPress<\/a><\/figcaption><\/figure>\n
Consequentemente, os temas e plugins do WordPress direcionados a uma audi\u00eancia global provavelmente ser\u00e3o codificados com uma vers\u00e3o antiga do PHP para aumentar seu poss\u00edvel alcance. Gra\u00e7as \u00e0 transpila\u00e7\u00e3o, estes poderiam ser codificados usando PHP 8.0, e ainda ser lan\u00e7ados para uma vers\u00e3o mais antiga do PHP, visando assim o maior n\u00famero poss\u00edvel de usu\u00e1rios.<\/p>\n
De fato, qualquer aplicativo que precise suportar qualquer vers\u00e3o PHP que n\u00e3o seja a mais recente (mesmo dentro da faixa das vers\u00f5es PHP atualmente suportadas) pode se beneficiar.<\/p>\n
Este \u00e9 o caso do Drupal, que requer o PHP 7.3<\/a>. Gra\u00e7as \u00e0 transpila\u00e7\u00e3o, os desenvolvedores podem criar m\u00f3dulos Drupal dispon\u00edveis publicamente usando o PHP 8.0, e liber\u00e1-los com o PHP 7.3.<\/p>\n
Outro exemplo \u00e9 quando se cria c\u00f3digo personalizado para clientes que n\u00e3o podem executar o PHP 8.0 em seus ambientes devido a uma raz\u00e3o ou outra. No entanto, gra\u00e7as \u00e0 transpila\u00e7\u00e3o, os desenvolvedores ainda podem codificar seus produtos usando PHP 8.0 e execut\u00e1-los nesses ambientes mais antigos.<\/p>\n
Quando Transpilar o PHP<\/h3>\n
O c\u00f3digo PHP sempre pode ser transpilado a menos que contenha algum recurso PHP que n\u00e3o tenha equivalente na vers\u00e3o anterior do PHP.<\/p>\n
Esse \u00e9 possivelmente o caso dos atributos<\/a>, introduzidos no PHP 8.0:<\/p>\n
#[SomeAttr]\nfunction someFunc() {}\n\n#[AnotherAttr]\nclass SomeClass {}\n<\/code><\/pre>\n
No exemplo anterior, usando fun\u00e7\u00f5es arrow, o c\u00f3digo podia ser transpilado porque as fun\u00e7\u00f5es arrow s\u00e3o syntactic sugar. Atributos, em contraste, criam um comportamento completamente novo. Este comportamento tamb\u00e9m poderia ser reproduzido com o PHP 7.4 ou abaixo, mas apenas codificando manualmente, ou seja, n\u00e3o automaticamente baseado em uma ferramenta ou processo (IA poderia fornecer uma solu\u00e7\u00e3o, mas n\u00f3s ainda n\u00e3o estamos l\u00e1).<\/p>\n
Atributos destinados ao uso em desenvolvimento, tais como #[<\/a>Deprecated<\/a>]<\/code> , podem ser removidos da mesma forma que os tipos de uni\u00e3o s\u00e3o removidos. Mas os atributos que modificam o comportamento do aplicativo na produ\u00e7\u00e3o n\u00e3o podem ser removidos, e tamb\u00e9m n\u00e3o podem ser transpiladas diretamente.<\/p>\n
A partir de hoje, nenhum transpilador “transpiler em Ingl\u00eas” pode pegar c\u00f3digo com atributos no PHP 8.0 e produzir automaticamente seu c\u00f3digo equivalente no PHP 7.4. Consequentemente, se o seu c\u00f3digo PHP precisa usar atributos, ent\u00e3o a sua transpila\u00e7\u00e3o ser\u00e1 dif\u00edcil ou invi\u00e1vel.<\/p>\n
Funcionalidades PHP que podem ser transpiladas<\/h3>\n
Estas s\u00e3o as funcionalidades do PHP 7.1 ou acima que podem ser transpiladas atualmente. Se o seu c\u00f3digo s\u00f3 usa estes recursos, voc\u00ea pode ter a certeza de que seu aplicativo transposta ir\u00e1 funcionar. Caso contr\u00e1rio, voc\u00ea precisar\u00e1 avaliar se o c\u00f3digo transpilado ir\u00e1 produzir falhas.<\/p>\n\n\n\n\n\n\n\n\n\n
Vers\u00e3o PHP<\/th>\nFuncionalidades<\/th>\n<\/tr>\n<\/thead>\n
7.1<\/td>\nTudo<\/td>\n<\/tr>\n
7.2<\/td>\n– tipoobject<\/code><\/a>
\n– Parameter type widening<\/a>
\n– PREG_UNMATCHED_AS_NULL<\/code> flag em preg_match<\/code><\/a><\/td>\n<\/tr>\n
7.3<\/td>\n– Atribui\u00e7\u00f5es de refer\u00eancia em list()<\/code><\/a> \/ desestrutura\u00e7\u00e3o de array (Exceto dentro do foreach<\/code> – #4376<\/a><\/em>)
\n– Sintaxe flex\u00edvel de Heredoc e Nowdoc<\/a>
\n– Chamadas de fun\u00e7\u00f5es com v\u00edrgulas de rastreamento<\/a>
\n– set(raw)cookie<\/code> aceita argumento $op\u00e7\u00e3o<\/a><\/td>\n<\/tr>\n
7.4<\/td>\n– Propriedades datilografadas<\/a>
\n– Fun\u00e7\u00f5es arrow<\/a>
\n– Operador de coalesc\u00eancia nula<\/a>
\n– Desembalando dentro de arrays<\/a>
\n– Separador num\u00e9rico literal<\/a>
\n– strip_tags()<\/code> com array de nomes de tags<\/a>
\n– tipos de retorno covariantes e param tipos contravariantes<\/a><\/td>\n<\/tr>\n
8.0<\/td>\n– Tipo Uni\u00e3o<\/a>
\n– Pseudo-tiposmixed<\/code><\/a>
\n– Tipo retorno static<\/code><\/a>
\n– Constante m\u00e1gica nos objetos <\/a>::class<\/code><\/a>
\n– express\u00f5es match<\/code><\/a>
\n– Exce\u00e7\u00f5es somente por tipo <\/a>catch<\/code><\/a>
\n– Operador seguro para todos<\/a>
\n– Promo\u00e7\u00e3o de propriedade de construtores de classe<\/a>
\n– V\u00edrgulas de rastreamento em listas de par\u00e2metros e listas use<\/code> de fechamento<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Transpiladores PHP<\/h2>\n
Atualmente, existe uma ferramenta para a transpila\u00e7\u00e3o de c\u00f3digo PHP: Rector<\/a>.<\/p>\n
Rector \u00e9 uma ferramenta reconstrutora de PHP, que converte c\u00f3digo PHP baseado em regras program\u00e1veis. N\u00f3s inserimos o c\u00f3digo fonte e o conjunto de regras<\/a> a serem executadas, e Rector transformar\u00e1 o c\u00f3digo.<\/p>\n
O Rector \u00e9 operado via linha de comando, instalado no projeto via Composer. Quando executado, o Rector ir\u00e1 emitir um “diff” (adi\u00e7\u00f5es em verde, remo\u00e7\u00f5es em vermelho) do c\u00f3digo antes e depois da convers\u00e3o:<\/p>\n
\"Sa\u00edda<\/a>
Sa\u00edda “diff” do Rector<\/figcaption><\/figure>\n
Qual vers\u00e3o do PHP que pode ser transpilada<\/h2>\n
Para transpilar o c\u00f3digo atrav\u00e9s das vers\u00f5es PHP, as regras correspondentes devem ser criadas.<\/p>\n
Hoje, a biblioteca do Rector inclui a maioria das regras para a transpila\u00e7\u00e3o de c\u00f3digo dentro da faixa do PHP 8.0 a 7.1. Portanto, n\u00f3s podemos transpilar de forma confi\u00e1vel nosso c\u00f3digo PHP at\u00e9 a vers\u00e3o 7.1.<\/p>\n
H\u00e1 tamb\u00e9m regras para a transpila\u00e7\u00e3o do PHP 7.1 para 7.0<\/a> e de 7.0 para 5.6<\/a>, mas estas n\u00e3o s\u00e3o exaustivas. O trabalho est\u00e1 em andamento para complet\u00e1-las, ent\u00e3o n\u00f3s podemos eventualmente transpilar o c\u00f3digo PHP para a vers\u00e3o 5.6.<\/p>\n
Transpila\u00e7\u00e3o vs. Backporting<\/h2>\n
O backporting \u00e9 similar ao transpila\u00e7\u00e3o “transpiling em Ingl\u00eas”, mas mais simples. O c\u00f3digo de backporting n\u00e3o necessariamente depende de novas funcionalidades de uma linguagem. Ao inv\u00e9s disso, a mesma funcionalidade pode ser fornecida para uma vers\u00e3o antiga da linguagem simplesmente copiando\/colando\/adaptando o c\u00f3digo correspondente da nova vers\u00e3o da linguagem.<\/p>\n
Por exemplo, a fun\u00e7\u00e3o str_contains<\/code> foi introduzida no PHP 8.0. A mesma fun\u00e7\u00e3o para o PHP 7.4 e abaixo pode ser facilmente implementada desta forma:<\/p>\n
if (!defined('PHP_VERSION_ID') || (defined('PHP_VERSION_ID') && PHP_VERSION_ID < 80000)) {\n  if (!function_exists('str_contains')) {\n    \/**\n     * Checks if a string contains another\n     *\n     * @param string $haystack The string to search in\n     * @param string $needle The string to search\n     * @return boolean Returns TRUE if the needle was found in haystack, FALSE otherwise.\n     *\/\n    function str_contains(string $haystack, string $needle): bool\n    {\n      return strpos($haystack, $needle) !== false;\n    }\n  }\n}\n<\/code><\/pre>\n
Porque backporting \u00e9 mais simples do que transpilar, n\u00f3s devemos optar por esta solu\u00e7\u00e3o sempre que o backporting fizer o trabalho.<\/p>\n
Com rela\u00e7\u00e3o \u00e0 faixa entre PHP 8.0 e 7.1, n\u00f3s podemos usar as bibliotecas polifill da Symfony<\/a>:<\/p>\n