Riassunto: Le estensioni PHP aggiungono funzionalità e capacità ai gestori PHP o migliorano le prestazioni PHP. Un certo codice PHP potrebbe non essere elaborato correttamente dal gestore a meno che non siano installate una o più estensioni specifiche. In Plesk sono preinstallate le estensioni PHP più diffuse.

In Plesk per Linux, è anche possibile installare estensioni PHP sotto forma di pacchetti disponibili da PECL (PHP Extension Community Library) tramite l’interfaccia grafica (GUI) e quella della riga di comando (CLI).

In questo argomento imparerai come installare, aggiornare e disinstallare le estensioni PHP da PECL in Plesk.

Prerequisiti e limitazioni

La possibilità di gestire le estensioni da PECL in Plesk è disponibile solo per i gestori PHP versione 7.3 e successive.

Nota: Le estensioni PHP in PECL sono create e gestite da terze parti. Non sono create, gestite o verificate da Plesk. Installale a tuo rischio e pericolo.

Installazione delle estensioni PHP

Quando si installa un’estensione PHP da PECL in Plesk, è necessario associarla a un particolare gestore PHP. Una data estensione può essere installata e disponibile per alcuni gestori PHP, ma non per altri. L’installazione di un’estensione PHP da PECL per un particolare gestore PHP la rende disponibile per tutti i tipi di gestori PHP che utilizzano la stessa versione PHP, ma non per altri.

Ad esempio, l’installazione di un’estensione per il gestore 8.3.14 FPM application la rende disponibile anche per i gestori 8.3.14 FastCGI application e 8.3.14 Dedicated FPM application, ma non per il gestore 8.2.25 FPM application. Se vuoi che l’estensione sia disponibile anche per il gestore 8.2.25 FPM application, devi installarla per quel gestore o per qualsiasi altro gestore che utilizzi la stessa versione di PHP e lo stesso binario.

Installazione della versione più recente di un’estensione

È buona norma utilizzare le versioni più recenti dei componenti software. Per impostazione predefinita, viene installata l’ultima versione stable disponibile di un’estensione.

Per installare la versione più recente di un’estensione tramite l’interfaccia grafica:

  1. Accedi a Plesk.

  2. Vai su Strumenti e impostazioni, quindi fai clic su Impostazioni PHP (in «Impostazioni Generali»).

  3. Fai clic sul gestore PHP desiderato, poi su Gestire pacchetti PECL.

  4. Individua l’estensione desiderata (se necessario, usa la barra di ricerca), quindi fai clic su image ui lib plus.

    image ready to install

Una volta installata l’estensione, questa diventa disponibile per quel gestore e per tutti gli altri gestori che utilizzano la stessa versione PHP e binario. Puoi trovarla nell’elenco delle altre estensioni disponibili per quei gestori. Ad esempio, ecco come si presenta l’estensione ioncube_loader dopo essere stata installata:

image installed extension

L’estensione installata è abilitata per impostazione predefinita, ma può essere disabilitata come qualsiasi altra estensione PHP.

Per installare la versione più recente di un’estensione tramite CLI:

  1. Accedi al server Plesk tramite SSH come utente root.

  2. Esegui il seguente comando:

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

    sostituendo <extension name> con il nome dell’estensione e <handler id> con l’ID del gestore PHP desiderato. Ad esempio, per installare l’estensione msgpack per il gestore PHP 8.3 FPM application, esegui il seguente comando:

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

    Nota: Per scoprire l’ID di un gestore PHP, esegui il comando plesk bin php_handler --list.

Una volta installata l’estensione, la potrai trovare nell’elenco delle altre estensioni disponibili per il gestore PHP in questione.

Installazione di una versione specifica di un’estensione

In alcuni casi, potrebbe essere necessario utilizzare una versione precedente di un’estensione, ad esempio per motivi di compatibilità. Puoi utilizzare questa procedura anche per installare versioni beta delle estensioni.

Per installare la versione specifica di un’estensione tramite l’interfaccia grafica:

  1. Accedi a Plesk.

  2. Vai su Strumenti e impostazioni, quindi fai clic su Impostazioni PHP (in «Impostazioni Generali»).

  3. Fai clic sul gestore PHP desiderato, poi su Gestire pacchetti PECL.

  4. Fai clic su Installa pacchetto.

  5. Specifica il nome del pacchetto desiderato, più la versione o lo stato desiderati, quindi fai clic su OK.

    Ad esempio, per installare l’ultima versione beta dell’estensione msgpack, inserisci quanto segue:

    msgpack-beta

    Per installare la versione 2.2.0 dell’estensione msgpack, indica quanto segue:

    msgpack-2.2.0
    image ready to install beta

Una volta installata l’estensione, questa diventa disponibile per quel gestore e per tutti gli altri gestori che utilizzano la stessa versione PHP e binario. Puoi trovarla nell’elenco delle altre estensioni disponibili per quei gestori. Ad esempio, ecco come si presenta l’estensione ioncube_loader dopo essere stata installata:

image installed extension

Per installare la versione specifica di un’estensione tramite CLI:

  1. Accedi al server Plesk tramite SSH come utente root.

  2. Esegui il seguente comando:

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

    sostituendo <extension name> con il nome dell’estensione più la versione o lo stato desiderato e <handler id> con l’ID del gestore PHP desiderato. Ad esempio, per installare la versione beta dell’estensione msgpack per il gestore PHP 8.3 FPM application, esegui il seguente comando:

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

    Per installare la versione 2.2.0 dell’estensione msgpack per il gestore PHP 8.3 FPM application, esegui il seguente comando:

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

    Nota: Per scoprire l’ID di un gestore PHP, esegui il comando plesk bin php_handler --list.

Una volta installata l’estensione, la potrai trovare nell’elenco delle altre estensioni disponibili per il gestore PHP in questione.

Aggiornamento delle estensioni PHP

È buona norma mantenere ogni componente software sul server aggiornato all’ultima versione. Ciò include le estensioni PHP.

Quando diventa disponibile una versione più recente di un’estensione installata, l’estensione obsoleta viene contrassegnata nell’interfaccia utente di Plesk con l’icona image ui lib triangle exclamation mark filled e può essere aggiornata alla versione più recente.

Per aggiornare un’estensione installata all’ultima versione tramite l’interfaccia grafica:

  1. Accedi a Plesk.

  2. Vai su Strumenti e impostazioni, quindi fai clic su Impostazioni PHP (in «Impostazioni Generali»).

  3. Fai clic sul gestore PHP desiderato, poi su Gestire pacchetti PECL.

  4. Individua l’estensione desiderata (se necessario, usa la barra di ricerca), quindi fai clic su image ui lib arrow up.

    image outdated extension

L’estensione verrà aggiornata all’ultima versione disponibile in PECL.

È anche possibile aggiornare un’estensione installata tramite CLI. Per farlo, usa la stessa procedura usata per installare l’ultima versione dell’estensione. Ad esempio, per aggiornare l’estensione msgpack installata per il gestore PHP 8.3 FPM application all’ultima versione, esegui il seguente comando:

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

L’estensione verrà aggiornata all’ultima versione disponibile in PECL.

Rimozione di estensioni PHP

Quando non hai più bisogno di un componente software, è buona norma rimuoverlo per evitare potenziali conflitti e/o problemi di sicurezza. Ciò include le estensioni PHP. Se non hai più bisogno di un’estensione installata, ti consigliamo di rimuoverla. Se l’estensione diventa di nuovo necessaria, puoi reinstallarla.

Per rimuovere un’estensione installata tramite l’interfaccia grafica:

  1. Accedi a Plesk.

  2. Vai su Strumenti e impostazioni, quindi fai clic su Impostazioni PHP (in «Impostazioni Generali»).

  3. Fai clic sul gestore PHP desiderato, poi su Gestire pacchetti PECL.

  4. Individua l’estensione desiderata (se necessario, usa la barra di ricerca), clicca su image ui lib recycle, quindi conferma la rimozione.

    image ready to remove

Una volta rimossa, l’estensione non sarà più disponibile per quel gestore e per tutti gli altri gestori che utilizzano la stessa versione di PHP e lo stesso binario.

Per rimuovere un’estensione installata tramite CLI:

  1. Accedi al server Plesk tramite SSH come utente root.

  2. Esegui il seguente comando:

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

    sostituendo <extension name> con il nome dell’estensione e <handler id>con l’ID del gestore PHP desiderato. Ad esempio, per rimuovere l’estensione msgpack dal gestore PHP 8.3 FPM application, esegui il seguente comando:

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

    Nota: Per scoprire l’ID di un gestore PHP, esegui il comando plesk bin php_handler --list.

Una volta rimossa, l’estensione non sarà più disponibile per quel gestore e per tutti gli altri gestori che utilizzano la stessa versione di PHP e lo stesso binario.