Résumé: Les extensions PHP ajoutent des fonctionnalités et des capacités aux gestionnaires PHP ou améliorent les performances de PHP. Le gestionnaire risque de ne pas traiter correctement certains codes sauf si une ou plusieurs extensions spécifiques sont installées. Dans Plesk, un certain nombre d’extensions PHP les plus populaires est préinstallé.

Dans Plesk pour Linux, vous pouvez également installer des extensions PHP sous la forme de packages disponibles à partir de PECL (PHP Extension Community Library) via les interfaces graphiques (GUI) et la ligne de commande (CLI).

Dans cette section, vous découvrirez comment installer, mettre à jour et désinstaller les extensions PHP de PECL dans Plesk.

Prérequis et limites

La gestion des extensions depuis PECL dans Plesk n’est disponible que pour les gestionnaires PHP version 7.3 et les versions ultérieures.

Note: Les extensions PHP dans PECL sont créées et maintenues par des tiers. Elles ne sont pas créées, maintenues ou contrôlées par Plesk. Leur installation est à vos propres risques.

Installer des extensions PHP

Lorsque vous installez une extension PHP de PECL dans Plesk, vous l’associez à un gestionnaire PHP particulier. Une extension donnée peut être installée et disponible pour certains gestionnaires PHP, mais pas pour d’autres. L’installation d’une extension PHP de PECL pour un gestionnaire PHP particulier la rend disponible pour tous les types de gestionnaires PHP utilisant la même version de PHP, mais pas pour les autres.

Par exemple, l’installation d’une extension pour le gestionnaire 8.3.14 FPM application la rend également disponible pour les gestionnaires 8.3.14 FastCGI application et 8.3.14 Dedicated FPM application, mais pas pour le gestionnaire 8.2.25 FPM application. Si vous voulez que l’extension soit aussi disponible pour le gestionnaire 8.2.25 FPM application, vous devez l’installer pour ce gestionnaire ou tout autre gestionnaire utilisant la même version de PHP et le même binaire.

Installer la dernière version d’une extension

La meilleure pratique consiste à utiliser les dernières versions des composants logiciels. Par défaut, la dernière version stable d’une extension est installée.

Pour installer la dernière version d’une extension via l’interface graphique :

  1. Connectez-vous à Plesk.

  2. Allez dans Outils & Paramètres. Cliquez sur Paramètres PHP (sous « Paramètres généraux »).

  3. Cliquez sur le gestionnaire PHP souhaité, puis cliquez sur Gérer les packages PECL.

  4. Localisez l’extension souhaitée (utilisez la barre de recherche si nécessaire), puis cliquez sur image ui lib plus.

    image ready to install

Une fois l’extension installée, elle devient disponible pour ce gestionnaire et pour tous les autres gestionnaires utilisant la même version PHP et le même binaire. Vous pouvez la trouver dans la liste des autres extensions disponibles pour ces gestionnaires. Par exemple, voici l’extension ioncube_loader après installation :

image installed extension

L’extension installée est activée par défaut, mais peut être désactivée comme toute autre extension PHP.

Pour installer la dernière version d’une extension via la CLI :

  1. Connectez-vous à votre serveur via SSH en tant qu’utilisateur root.

  2. Exécutez la commande suivante :

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

    Remplacez <extension name> par le nom de l’extension et <handler id> par l’ID du gestionnaire PHP souhaité. Par exemple, pour installer l’extension msgpack pour le gestionnaire PHP 8.3 FPM application, exécutez la commande suivante :

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

    Note: Pour connaître l’ID d’un gestionnaire PHP, exécutez la commande plesk bin php_handler --list.

Une fois l’extension installée, vous pourrez la retrouver dans la liste des autres extensions disponibles pour le gestionnaire PHP concerné.

Installer une version spécifique d’une extension

Dans certaines circonstances, vous devrez peut-être utiliser une version antérieure d’une extension. Par exemple, pour des raisons de compatibilité. Vous pouvez également utiliser cette procédure pour installer des versions beta d’extensions.

Pour installer une version spécifique d’une extension via l’interface graphique :

  1. Connectez-vous à Plesk.

  2. Allez dans Outils & Paramètres. Cliquez sur Paramètres PHP (sous « Paramètres généraux »).

  3. Cliquez sur le gestionnaire PHP souhaité, puis cliquez sur Gérer les packages PECL.

  4. Cliquez sur Installer le package.

  5. Spécifiez le nom du package souhaité, ainsi que la version ou l’état souhaité, puis cliquez sur OK.

    Par exemple, pour installer la dernière version beta de l’extension msgpack, indiquez ceci :

    msgpack-beta

    Pour installer la version 2.2.0 de l’extension msgpack, indiquez ceci :

    msgpack-2.2.0
    image ready to install beta

Une fois l’extension installée, elle devient disponible pour ce gestionnaire et pour tous les autres gestionnaires utilisant la même version PHP et le même binaire. Vous pouvez la trouver dans la liste des autres extensions disponibles pour ces gestionnaires. Par exemple, voici l’extension ioncube_loader après installation :

image installed extension

Pour installer une version spécifique d’une extension via la CLI :

  1. Connectez-vous à votre serveur via SSH en tant qu’utilisateur root.

  2. Exécutez la commande suivante :

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

    Remplacez <extension name> par le nom de l’extension plus la version ou l’état souhaité, et <handler id> par l’ID du gestionnaire PHP souhaité. Par exemple, pour installer la dernière version beta de l’extension msgpack pour le gestionnaire PHP 8.3 FPM application, exécutez la commande suivante :

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

    Pour installer la version 2.2.0 de l’extension msgpack pour le gestionnaire PHP 8.3 FPM application, exécutez la commande suivante :

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

    Note: Pour connaître l’ID d’un gestionnaire PHP, exécutez la commande plesk bin php_handler --list.

Une fois l’extension installée, vous pourrez la retrouver dans la liste des autres extensions disponibles pour le gestionnaire PHP concerné.

Mettre à jour les extensions PHP

La meilleure pratique consiste à mettre à jour tous les composants logiciels du serveur avec la version la plus récente. Cela inclut les extensions PHP.

Lorsqu’une version plus récente d’une extension installée est disponible, l’icône image ui lib triangle exclamation mark filled s’affiche à côté de l’extension obsolète dans l’interface graphique de Plesk. Vous pouvez alors mettre à jour l’extension vers la dernière version.

Pour mettre à jour une extension installée vers la dernière version via l’interface graphique :

  1. Connectez-vous à Plesk.

  2. Allez dans Outils & Paramètres. Cliquez sur Paramètres PHP (sous « Paramètres généraux »).

  3. Cliquez sur le gestionnaire PHP souhaité, puis cliquez sur Gérer les packages PECL.

  4. Localisez l’extension souhaitée (utilisez la barre de recherche si nécessaire), puis cliquez sur image ui lib arrow up.

    image outdated extension

L’extension sera mise à jour vers la dernière version disponible dans PECL.

Vous pouvez également mettre à jour une extension installée via la CLI. Pour cela, utilisez la même procédure que pour l’installation de la dernière version de l’extension. Par exemple, pour mettre à jour l’extension msgpack installée pour le gestionnaire PHP 8.3 FPM application vers la dernière version, exécutez la commande suivante :

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

L’extension sera mise à jour vers la dernière version disponible dans PECL.

Supprimer des extensions PHP

Une fois que vous n’avez plus besoin d’un composant logiciel, il est recommandé de le supprimer pour éviter d’éventuels conflits et/ou problèmes de sécurité. Cela inclut les extensions PHP. Si vous n’avez plus besoin d’une extension installée, nous vous recommandons de la supprimer. Si vous avez à nouveau besoin de l’extension, vous pouvez la réinstaller.

Pour supprimer une extension installée via l’interface graphique :

  1. Connectez-vous à Plesk.

  2. Allez dans Outils & Paramètres. Cliquez sur Paramètres PHP (sous « Paramètres généraux »).

  3. Cliquez sur le gestionnaire PHP souhaité, puis cliquez sur Gérer les packages PECL.

  4. Localisez l’extension souhaitée (utilisez la barre de recherche si nécessaire), cliquez sur image ui lib recycle, puis confirmez la suppression.

    image ready to remove

Une fois l’extension supprimée, elle n’est plus disponible pour ce gestionnaire ni pour tous les autres gestionnaires utilisant la même version PHP et le même binaire.

Pour supprimer une extension installée via la CLI :

  1. Connectez-vous à votre serveur via SSH en tant qu’utilisateur root.

  2. Exécutez la commande suivante :

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

    Remplacez <extension name> par le nom de l’extension et <handler id> par l’ID du gestionnaire PHP souhaité. Par exemple, pour supprimer l’extension msgpack pour le gestionnaire PHP 8.3 FPM application, exécutez la commande suivante :

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

    Note: Pour connaître l’ID d’un gestionnaire PHP, exécutez la commande plesk bin php_handler --list.

Une fois l’extension supprimée, elle n’est plus disponible pour ce gestionnaire ni pour tous les autres gestionnaires utilisant la même version PHP et le même binaire.