{"id":44032,"date":"2021-09-24T08:37:16","date_gmt":"2021-09-24T06:37:16","guid":{"rendered":"https:\/\/kinsta.com\/?p=100177"},"modified":"2023-08-23T17:28:04","modified_gmt":"2023-08-23T15:28:04","slug":"transpilacion-php","status":"publish","type":"post","link":"https:\/\/kinsta.com\/es\/blog\/transpilacion-php\/","title":{"rendered":"La Gu\u00eda Definitiva para Transpilar C\u00f3digo PHP"},"content":{"rendered":"

En circunstancias ideales, deber\u00edamos utilizar PHP 8.0<\/a> (la \u00faltima versi\u00f3n en el momento de escribir este art\u00edculo) para todos nuestros sitios y actualizarlo tan pronto como se publique una nueva versi\u00f3n. Sin embargo, los desarrolladores a menudo necesitar\u00e1n trabajar con versiones anteriores de PHP, como cuando se crea un plugin p\u00fablico para WordPress<\/a> o se trabaja con c\u00f3digo heredado que impide actualizar el entorno del servidor web.<\/p>\n

En estas situaciones, podr\u00edamos renunciar a la esperanza de utilizar el \u00faltimo c\u00f3digo PHP. Pero hay una alternativa mejor: podemos seguir escribiendo nuestro c\u00f3digo fuente con PHP 8.0 y transpilarlo a una versi\u00f3n anterior de PHP – incluso a PHP 7.1.<\/p>\n

En esta gu\u00eda, te ense\u00f1aremos todo lo que necesita saber sobre la transpilaci\u00f3n de c\u00f3digo PHP.<\/p>\n

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

\u00bfQu\u00e9 es la transpilaci\u00f3n?<\/h2>\n

La transpilaci\u00f3n convierte el c\u00f3digo fuente de un lenguaje de programaci\u00f3n<\/a> en un c\u00f3digo fuente equivalente del mismo o de otro lenguaje de programaci\u00f3n.<\/p>\n

La transpilaci\u00f3n no es un concepto nuevo en el desarrollo web: los desarrolladores del lado del cliente probablemente est\u00e9n familiarizados con Babel<\/a>, un transpilador de c\u00f3digo JavaScript.<\/p>\n

Babel convierte el c\u00f3digo JavaScript de la versi\u00f3n moderna de ECMAScript 2015+ en una versi\u00f3n heredada compatible con los navegadores m\u00e1s antiguos. Por ejemplo, dada una funci\u00f3n de flecha de ES2015:<\/p>\n

[2, 4, 6].map((n) => n * 2);\n<\/code><\/pre>\n
…Babel lo convertir\u00e1 en su versi\u00f3n ES5:<\/p>\n
[2, 4, 6].map(function(n) {\n  return n * 2;\n});\n<\/code><\/pre>\n
\u00bfQu\u00e9 es la transpilaci\u00f3n de PHP?<\/h3>\n
Lo que es potencialmente nuevo dentro del desarrollo web es la posibilidad de transpilar el c\u00f3digo del lado del servidor, en particular PHP.<\/p>\n
La transpilaci\u00f3n de PHP funciona de la misma manera que la transpilaci\u00f3n de JavaScript: el c\u00f3digo fuente de una versi\u00f3n moderna de PHP<\/a> se convierte en un c\u00f3digo equivalente para una versi\u00f3n antigua de PHP.<\/p>\n
Siguiendo el mismo ejemplo que antes, una funci\u00f3n de flecha de PHP 7.4:<\/p>\n
$nums = array_map(fn($n) => $n * 2, [2, 4, 6]);\n<\/code><\/pre>\n
… se puede transpilar a su versi\u00f3n equivalente de 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
Las funciones flecha pueden transpilarse porque son az\u00facar sint\u00e1ctico<\/a>, es decir, una nueva sintaxis para producir un comportamiento existente. Esta es la fruta m\u00e1s f\u00e1cil de conseguir.<\/p>\n
Sin embargo, tambi\u00e9n hay nuevas caracter\u00edsticas que crean un nuevo comportamiento, y como tal, no habr\u00e1 c\u00f3digo equivalente para las versiones anteriores de PHP. Ese es el caso de los tipos de uni\u00f3n<\/a>, introducidos en PHP 8.0:<\/p>\n
function someFunction(float|int $param): string|float|int|null\n{\n  \/\/ ...\n}\n<\/code><\/pre>\n
En estas situaciones, se puede transpilar siempre que la nueva funci\u00f3n sea necesaria para el desarrollo pero no para la producci\u00f3n. En ese caso, podemos simplemente eliminar la funci\u00f3n del c\u00f3digo transpilado sin consecuencias graves.<\/p>\n
Un ejemplo de ello son los tipos de uni\u00f3n. Esta caracter\u00edstica se utiliza para comprobar que no hay un desajuste entre el tipo de entrada y su valor proporcionado, lo que ayuda a prevenir errores. Si hay un conflicto con los tipos, habr\u00e1 un error ya en el desarrollo, y debemos atraparlo y arreglarlo antes de que el c\u00f3digo llegue a producci\u00f3n.<\/p>\n
Por lo tanto, podemos permitirnos eliminar la funci\u00f3n del c\u00f3digo para la producci\u00f3n:<\/p>\n
function someFunction($param)\n{\n  \/\/ ...\n}\n<\/code><\/pre>\n
Si el error sigue ocurriendo en producci\u00f3n, el mensaje de error lanzado ser\u00e1 menos preciso que si tuvi\u00e9ramos tipos de uni\u00f3n. Sin embargo, esta posible desventaja se ve compensada por el hecho de poder utilizar tipos de uni\u00f3n en primer lugar.<\/p>\n\n
Ventajas de transpilar el c\u00f3digo PHP<\/h2>\n
La transpilaci\u00f3n permite codificar una aplicaci\u00f3n utilizando la \u00faltima versi\u00f3n de PHP y producir una versi\u00f3n que tambi\u00e9n funciona en entornos que ejecutan versiones anteriores de PHP.<\/p>\n
Esto puede ser especialmente \u00fatil para los desarrolladores que crean productos para sistemas de gesti\u00f3n de contenidos (CMS)<\/a> heredados. WordPress, por ejemplo, todav\u00eda soporta oficialmente PHP 5.6<\/a> (aunque recomienda PHP 7.4+). El porcentaje de sitios de WordPress que ejecutan las versiones de PHP 5.6 a 7.2 -que son todas End-of-Life (EOL), lo que significa que ya no reciben actualizaciones de seguridad- se sit\u00faa en un considerable 34,8%, y los que se ejecutan en cualquier versi\u00f3n de PHP distinta de la 8.0 se sit\u00faan en un enorme 99,5%:<\/p>\n
\"Estad\u00edsticas<\/a>
Estad\u00edsticas de uso de WordPress por versi\u00f3n. Fuente de la imagen: WordPress<\/a><\/figcaption><\/figure>\n
En consecuencia, los temas y plugins de WordPress dirigidos a un p\u00fablico global probablemente se codificar\u00e1n con una versi\u00f3n antigua de PHP para aumentar su posible alcance. Gracias a la transpilaci\u00f3n, estos podr\u00edan codificarse con PHP 8.0 y seguir siendo lanzados para una versi\u00f3n de PHP m\u00e1s antigua, dirigi\u00e9ndose as\u00ed al mayor n\u00famero de usuarios posible.<\/p>\n
De hecho, cualquier aplicaci\u00f3n que necesite soportar cualquier versi\u00f3n de PHP que no sea la m\u00e1s reciente (incluso dentro del rango de las versiones de PHP actualmente soportadas) puede beneficiarse.<\/p>\n
Este es el caso de Drupal, que requiere PHP 7.3<\/a>. Gracias a la transpilaci\u00f3n, los desarrolladores pueden crear m\u00f3dulos de Drupal disponibles p\u00fablicamente utilizando PHP 8.0, y publicarlos con PHP 7.3.<\/p>\n
Otro ejemplo es cuando se crea c\u00f3digo personalizado para clientes que no pueden ejecutar PHP 8.0 en sus entornos por una u otra raz\u00f3n. Sin embargo, gracias a la transpilaci\u00f3n, los desarrolladores pueden seguir codificando sus productos con PHP 8.0 y ejecutarlos en esos entornos heredados.<\/p>\n
Cu\u00e1ndo transpilar PHP<\/h3>\n
El c\u00f3digo PHP siempre se puede transpilar a menos que contenga alguna caracter\u00edstica de PHP que no tenga equivalente en la versi\u00f3n anterior de PHP.<\/p>\n
Ese es posiblemente el caso de los atributos<\/a>, introducidos en PHP 8.0:<\/p>\n
#[SomeAttr]\nfunction someFunc() {}\n\n#[AnotherAttr]\nclass SomeClass {}\n<\/code><\/pre>\n
En el ejemplo anterior en el que se utilizaban funciones de flecha, el c\u00f3digo pod\u00eda transpilarse porque las funciones de flecha son az\u00facar sint\u00e1ctico. Los atributos, en cambio, crean un comportamiento completamente nuevo. Este comportamiento tambi\u00e9n podr\u00eda ser reproducido con PHP 7.4 e inferior, pero solo codific\u00e1ndolo manualmente, es decir, no autom\u00e1ticamente basado en una herramienta o proceso (la IA podr\u00eda proporcionar una soluci\u00f3n, pero a\u00fan no estamos all\u00ed).<\/p>\n
Los atributos destinados al uso en desarrollo, como #[Deprecated]<\/a><\/code>, pueden eliminarse del mismo modo que los tipos de uni\u00f3n. Pero los atributos que modifican el comportamiento de la aplicaci\u00f3n en producci\u00f3n no se pueden eliminar, y tampoco se pueden transpilar directamente.<\/p>\n
A d\u00eda de hoy, ning\u00fan transpilador puede tomar c\u00f3digo con atributos de PHP 8.0 y producir autom\u00e1ticamente su c\u00f3digo equivalente de PHP 7.4. En consecuencia, si tu c\u00f3digo PHP necesita usar atributos, entonces transpilarlo ser\u00e1 dif\u00edcil o inviable.<\/p>\n
Funciones de PHP que se pueden transpilar<\/h3>\n
Estas son las caracter\u00edsticas de PHP 7.1 y superiores que actualmente pueden ser transpiladas. Si tu c\u00f3digo solo utiliza estas caracter\u00edsticas, puedes disfrutar de la certeza de que tu aplicaci\u00f3n transpilada funcionar\u00e1. De lo contrario, tendr\u00e1s que evaluar si el c\u00f3digo transpilado producir\u00e1 fallos.<\/p>\n\n\n\n\n\n\n\n\n\n
Versi\u00f3n PHP<\/th>\nCaracter\u00edsticas<\/th>\n<\/tr>\n<\/thead>\n
7.1<\/td>\nTodo<\/td>\n<\/tr>\n
7.2<\/td>\n– object<\/code>tipo<\/a>
\n– ampliaci\u00f3n del tipo de par\u00e1metro<\/a>
\n– PREG_UNMATCHED_AS_NULL<\/code> bandera en preg_match<\/code><\/a><\/td>\n<\/tr>\n
7.3<\/td>\n– Asignaciones de referencia en list()<\/code> \/ desestructuraci\u00f3n de arrays<\/a> (excepto dentro de foreach<\/code> – #4376<\/a>)<\/em>
\n– Sintaxis flexible de Heredoc y Nowdoc<\/a>
\n– Comas al final de las llamadas a funciones<\/a>
\n– set(raw)cookie<\/code> acepta el argumento $option 7.4 <\/a><\/td>\n<\/tr>\n
<\/td>\n– Propiedades escritas<\/a>
\n– Funciones de las flechas<\/a>
\n– Operador de asignaci\u00f3n coalescente nulo<\/a>
\n– Desembalaje dentro de las matrices<\/a>
\n– Separador literal num\u00e9rico<\/a>
\n– strip_tags()<\/code>con una matriz de nombres de etiquetas<\/a>
\n– tipos de retorno covariantes y tipos param contravariantes<\/a><\/td>\n<\/tr>\n
8.0<\/td>\n– Tipos de uni\u00f3n<\/a>
\n– mixed<\/code> pseudotipo<\/a>
\n– static<\/code> tipo de retorno<\/a>
\n– ::class<\/code>constante m\u00e1gica en los objetos<\/a>
\n– match<\/code> expresiones<\/a>
\n– catch<\/code> excepciones s\u00f3lo por tipo<\/a>
\n– Operador a prueba de nulidades<\/a>
\n– Promoci\u00f3n de la propiedad del constructor de la clase<\/a>
\n– Comas al final de las listas de par\u00e1metros y listas de use<\/code> de cierres lists\u00a0<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\u00a0<\/p>\n
Transpiladores PHP<\/h2>\n
Actualmente, existe una herramienta para transpilar c\u00f3digo PHP: Rector<\/a>.<\/p>\n
Rector es una herramienta de reconstrucci\u00f3n de PHP, que convierte el c\u00f3digo PHP basado en reglas programables. Introducimos el c\u00f3digo fuente y el conjunto de reglas<\/a> a ejecutar, y Rector transformar\u00e1 el c\u00f3digo.<\/p>\n
Rector se maneja a trav\u00e9s de la l\u00ednea de comandos, instalada en el proyecto a trav\u00e9s de Composer. Cuando se ejecuta, Rector mostrar\u00e1 un \u00abdiff\u00bb (adiciones en verde, eliminaciones en rojo) del c\u00f3digo antes y despu\u00e9s de la conversi\u00f3n:<\/p>\n
\"Salida<\/a>
Salida \u00abdiff\u00bb de Rector<\/figcaption><\/figure>\n
Qu\u00e9 versiones de PHP hay que transpilar<\/h2>\n
Para transpilar el c\u00f3digo a trav\u00e9s de las versiones de PHP, se deben crear las reglas correspondientes.<\/p>\n
Hoy en d\u00eda, la biblioteca Rector incluye la mayor\u00eda de las reglas para transpilar c\u00f3digo dentro del rango de PHP 8.0 a 7.1. Por lo tanto, podemos transpilar de forma fiable nuestro c\u00f3digo PHP hasta la versi\u00f3n 7.1.<\/p>\n
Tambi\u00e9n hay reglas para transpilar de PHP 7.1a7.0<\/a> y de 7.0 a 5.6<\/a>, pero no son exhaustivas. Se est\u00e1 trabajando para completarlas, por lo que eventualmente podremos transpilar c\u00f3digo PHP hasta la versi\u00f3n 5.6.<\/p>\n
Transpilaje vs. Backporting<\/h2>\n
El backporting es similar al transpiling, pero m\u00e1s sencillo. La backporting de c\u00f3digo no depende necesariamente de las nuevas caracter\u00edsticas de un lenguaje. En su lugar, se puede proporcionar la misma funcionalidad a una versi\u00f3n anterior del lenguaje simplemente copiando\/pegando\/adaptando el c\u00f3digo correspondiente de la nueva versi\u00f3n del lenguaje.<\/p>\n
Por ejemplo, la funci\u00f3n str_contains<\/code> se introdujo en PHP 8.0. La misma funci\u00f3n para PHP 7.4 e inferior se puede implementar f\u00e1cilmente as\u00ed:<\/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
Dado que el backporting es m\u00e1s sencillo que la transpilaci\u00f3n, deber\u00edamos optar por esta soluci\u00f3n siempre que el backporting haga el trabajo.<\/p>\n
En cuanto al rango entre PHP 8.0 y 7.1, podemos utilizar las librer\u00edas polyfill de Symfony<\/a>:<\/p>\n