Instalar extensiones PHP tradicionalmente implicaba desafíos como encontrar binarios precompilados, usar administradores de paquetes del sistema operativo o compilar manualmente desde la fuente. Estos métodos podían ser inconsistentes entre plataformas y requerían diferentes comandos, haciendo el proceso complejo y propenso a errores.

PECL, aunque útil, se siente anticuado. No es tan fácil poner tu extensión en PHP como lo es con Composer. PIE (PHP Installer for Extensions) es una iniciativa de la Fundación PHP para solucionar esto tratando las extensiones como paquetes Composer. Simplifica el proceso, ofrece una mejor consistencia entre plataformas y asegura actualizaciones y administración más fáciles para las extensiones PHP.

Requisitos previos

Antes de comenzar, asegúrate de tener PHP 8.1 o superior para ejecutar PIE. Sin embargo, PIE puede instalar extensiones para cualquier versión de PHP instalada. Para verificar la versión de PHP en tu computadora, puedes ejecutar: php -v

Captura de pantalla de una terminal mostrando la versión de PHP instalada.
Verifica tu versión de PHP.

Instalación

Para instalar el instalador de extensiones PHP (PIE), puedes seguir estos pasos:

  1. Descarga el paquete PHAR

Primero, necesitas descargar el archivo pie.phar desde el repositorio o sitio web oficial. Este es el archivo principal necesario para usar PIE.

  1. Instalación PHAR

Mueve pie.phar a la ruta de tu computadora, como /usr/local/bin/, para que puedas ejecutarlo desde cualquier lugar. Puedes renombrarlo por conveniencia, por ejemplo:

mv pie.phar /usr/local/bin/pie

En Windows, puedes moverlo a C:\Program Files o cualquier otro directorio en tu ruta. Sin embargo, recomiendo usar Composer y su CLI con el Subsistema de Windows para Linux (WSL) para una mejor experiencia.

  1. Hazlo ejecutable

En máquinas que no son Windows, necesitas cambiar los permisos para hacerlo ejecutable.

chmod +x /usr/local/bin/pie

Eso es todo. Puedes intentar ejecutar pie en tu terminal para ver si está instalado correctamente.

Terminal mostrando la versión de PIE instalada en el sistema.
Versión de PIE instalada.

Comprobando la versión de PIE después de la instalación

Ahora podemos usar PIE para instalar extensiones PHP fácilmente usando el comando pie.

pie install <vendor>/<package>

Por ejemplo, digamos que quieres instalar la extensión xdebug para realizar la depuración en tu aplicación PHP. Puedes ejecutar:

pie install xdebug/xdebug

Este comando extraerá la extensión xdebug de Packagist, la compilará y la instalará en tu instalación de PHP. PIE también agregará la extensión a tu archivo php.ini, por lo que no tendrás que hacerlo manualmente.

Puedes encontrar todas las extensiones que puedes instalar a través de PIE en Packagist.

Nota para Windows

💡
PIE actualmente no admite la compilación de extensiones en Windows. Depende del autor de la extensión para proporcionar el archivo DLL precompilado para su extensión, por lo que probablemente haya algunas extensiones que no puedas instalar en Windows.

Conclusión

PIE es una gran iniciativa para simplificar la instalación de extensiones PHP. Me gusta cómo trata las extensiones como paquetes Composer, lo que facilita su administración y actualización. Creo que es un paso en la dirección correcta para modernizar el ecosistema PHP y hacerlo más amigable para los desarrolladores.

Categorizado en:

Novedades, PHP,