resumen: Las extensiones PHP añaden funciones y capacidades a los controladores PHP o mejoran el rendimiento de PHP. Es posible que el controlador no procese correctamente determinados códigos PHP a menos que se instalen una o más extensiones específicas. Plesk tiene preinstaladas algunas de las extensiones PHP más populares.

En Plesk para Linux, también puede instalar extensiones PHP en forma de paquetes disponibles en PECL (PHP Extension Community Library) a través de la interfaz gráfica (GUI) y de la línea de comandos (CLI).

En este tema aprenderá a instalar, actualizar y desinstalar extensiones PHP desde PECL en Plesk.

Requisitos mínimos y limitaciones

La capacidad de gestionar extensiones desde PECL en Plesk solo está disponible para los controladores PHP versión 7.3 y posteriores.

Nota: Las extensiones PHP en PECL son creadas y mantenidas por terceros. Plesk no las crea, mantiene ni controla. Instálelas bajo su propia responsabilidad.

Instalación de extensiones PHP

Cuando instala una extensión PHP desde PECL en Plesk, la asocia a un controlador PHP específico. Cualquier extensión puede instalarse y estar disponible para algunos controladores PHP, pero no para otros. La instalación de una extensión PHP desde PECL para un controlador PHP específico hace que esté disponible para todos los tipos de controladores PHP que utilicen la misma versión PHP, pero no para otros.

Por ejemplo, al instalar una extensión para el controlador aplicación FPM 8.3.14 también estará disponible para los controladores aplicación FastCGI 8.3.14 y aplicación FPM dedicada 8.3.14, pero no para el controlador aplicación FPM 8.2.25. Si desea que la extensión también esté disponible para el controlador aplicación FPM 8.2.25, deberá instalarla para ese controlador o cualquier otro controlador que utilice el mismo binario y versión de PHP.

Instalación de la última versión de una extensión

Se recomienda utilizar las últimas versiones de los componentes de software. De forma predeterminada, se instala la última versión stable disponible de una extensión.

Para instalar la última versión de una extensión a través de la GUI:

  1. Acceso a Plesk.

  2. Vaya a Herramientas y configuración y haga clic en Configuración de PHP (en «Configuración general»).

  3. Haga clic en el controlador PHP deseado y, a continuación, en Administrar paquetes PECL.

  4. Localice la extensión deseada (utilice la barra de búsqueda si es necesario) y haga clic en image ui lib plus.

    image ready to install

Una vez instalada la extensión, estará disponible para ese controlador y cualquier otro controlador que utilice el mismo binario y versión de PHP. Puede encontrarla en la lista de otras extensiones disponibles para esos controladores. Por ejemplo, aquí está la extensión ioncube_loader después de instalarse:

image installed extension

La extensión instalada está activada de forma predeterminada, pero se puede desactivar como cualquier otra extensión PHP.

Para instalar la última versión de una extensión a través de la CLI:

  1. Inicie sesión en el servidor Plesk mediante SSH como usuario root.

  2. Ejecute el siguiente comando:

    plesk bin php_handler --extension-install <extension name> -id <handler id>

    sustituyendo <extension name> por el nombre de la extensión, y <handler id>, por el ID del controlador PHP deseado. Por ejemplo, para instalar la extensión msgpack para el controlador aplicación FPM de PHP 8.3, ejecute el siguiente comando:

    plesk bin php_handler --extension-install msgpack -id plesk-php83-fpm

    Nota: Para saber cuál es el ID de un controlador PHP, ejecute el comando plesk bin php_handler --list.

Una vez instalada la extensión, podrá encontrarla en la lista de otras extensiones disponibles para el controlador PHP en cuestión.

Instalación de una versión específica de una extensión

En algunas circunstancias, es posible que necesite utilizar una versión anterior de una extensión; por ejemplo, por motivos de compatibilidad. También puede utilizar este procedimiento para instalar versiones beta de extensiones.

Para instalar una versión específica de una extensión a través de la GUI:

  1. Acceso a Plesk.

  2. Vaya a Herramientas y configuración y haga clic en Configuración de PHP (en «Configuración general»).

  3. Haga clic en el controlador PHP deseado y, a continuación, en Administrar paquetes PECL.

  4. Haga clic en Instalar paquete.

  5. Especifique el nombre del paquete deseado, además de la versión o el estado deseados y, a continuación, haga clic en ACEPTAR.

    Por ejemplo, para instalar la versión beta más reciente de la extensión msgpack, especifique lo siguiente:

    msgpack-beta

    Para instalar la versión 2.2.0 de la extensión msgpack, especifique lo siguiente:

    msgpack-2.2.0
    image ready to install beta

Una vez instalada la extensión, estará disponible para ese controlador y cualquier otro controlador que utilice el mismo binario y versión de PHP. Puede encontrarla en la lista de otras extensiones disponibles para esos controladores. Por ejemplo, aquí está la extensión ioncube_loader después de instalarse:

image installed extension

Para instalar una versión específica de una extensión a través de la CLI:

  1. Inicie sesión en el servidor Plesk mediante SSH como usuario root.

  2. Ejecute el siguiente comando:

    plesk bin php_handler --extension-install <extension name> -id <handler id>

    sustituyendo <extension name> por el nombre de la extensión más la versión o estado deseados, y <handler id>, por el ID del controlador PHP deseado. Por ejemplo, para instalar la versión beta más reciente de la extensión msgpack para el controlador aplicación FPM de PHP 8.3, ejecute el siguiente comando:

    plesk bin php_handler --extension-install msgpack-beta -id plesk-php83-fpm

    Para instalar la versión 2.2.0 de la extensión msgpack para el controlador de la aplicación FPM de PHP 8.3, ejecute el siguiente comando:

    plesk bin php_handler --extension-install msgpack-2.2.0 -id plesk-php83-fpm

    Nota: Para saber cuál es el ID de un controlador PHP, ejecute el comando plesk bin php_handler --list.

Una vez instalada la extensión, podrá encontrarla en la lista de otras extensiones disponibles para el controlador PHP en cuestión.

Actualización de extensiones PHP

Se recomienda mantener todos los componentes de software del servidor actualizados a la última versión. Esto incluye las extensiones PHP.

Cuando esté disponible una versión más nueva de una extensión instalada, la extensión antigua se marcará en la GUI de Plesk con el icono image ui lib triangle exclamation mark filled y podrá actualizarse a la última versión.

Para actualizar una extensión instalada a la última versión a través de la GUI:

  1. Acceso a Plesk.

  2. Vaya a Herramientas y configuración y haga clic en Configuración de PHP (en «Configuración general»).

  3. Haga clic en el controlador PHP deseado y, a continuación, en Administrar paquetes PECL.

  4. Localice la extensión deseada (utilice la barra de búsqueda si es necesario) y haga clic en image ui lib plus.

    image outdated extension

La extensión se actualizará a la última versión disponible en PECL.

También es posible actualizar una extensión instalada a través de la CLI. Para ello, utilice el mismo procedimiento que para instalar la última versión de la extensión. Por ejemplo, para actualizar la extensión msgpack instalada para el controlador aplicación FPM de PHP 8.3 a la última versión, ejecute el siguiente comando:

plesk bin php_handler --extension-install msgpack -id plesk-php83-fpm

La extensión se actualizará a la última versión disponible en PECL.

Eliminación de extensiones PHP

Cuando ya no necesita un componente de software, lo mejor es eliminarlo para evitar posibles conflictos o problemas de seguridad. Esto incluye las extensiones PHP. Si ya no necesita una extensión instalada, le recomendamos que la elimine. Si vuelve a necesitarla, puede volver a instalarla.

Para eliminar una extensión instalada a través de la GUI:

  1. Acceso a Plesk.

  2. Vaya a Herramientas y configuración y haga clic en Configuración de PHP (en «Configuración general»).

  3. Haga clic en el controlador PHP deseado y, a continuación, en Administrar paquetes PECL.

  4. Localice la extensión deseada (utilice la barra de búsqueda si es necesario), haga clic en image ui lib recycle y confirme la eliminación.

    image ready to remove

Una vez que se elimine la extensión, dejará de estar disponible para ese controlador y cualquier otro controlador que utilice el mismo binario y versión de PHP.

Para eliminar una extensión instalada a través de la CLI:

  1. Inicie sesión en el servidor Plesk mediante SSH como usuario root.

  2. Ejecute el siguiente comando:

    plesk bin php_handler --extension-uninstall <extension name> -id <handler id>

    sustituyendo <extension name> por el nombre de la extensión, y <handler id>, por el ID del controlador PHP deseado. Por ejemplo, para eliminar la extensión msgpack del controlador aplicación FPM de PHP 8.3, ejecute el siguiente comando:

    plesk bin php_handler --extension-uninstall msgpack -id plesk-php83-fpm

    Nota: Para saber cuál es el ID de un controlador PHP, ejecute el comando plesk bin php_handler --list.

Una vez que se elimine la extensión, dejará de estar disponible para ese controlador y cualquier otro controlador que utilice el mismo binario y versión de PHP.