概要: PHP 拡張は、PHP ハンドラに機能を追加したり、PHP のパフォーマンスを改善したりします。PHP コードによっては、1 つ以上の特定の拡張がインストールされていないと、ハンドラによって正しく処理されない場合があります。Plesk には、最も一般的な PHP 拡張がいくつかプリインストールされています。

Plesk for Linux では、PECL (PHP Extension Community Library) から入手可能なパッケージの形で、グラフィカル (GUI) とコマンドライン (CLI) の両方のインターフェースから PHP 拡張をインストールすることもできます。

このトピックでは、Plesk で PECL から PHP 拡張をインストール、アップデート、アンインストールする方法を説明します。

前提条件と制限事項

Plesk で PECL の拡張を管理する機能は、PHP ハンドラのバージョンが 7.3 以降の場合のみ使用できます。

注釈: PECL の PHP 拡張は、サードパーティによって作成および管理されており、Plesk によって作成、管理、検査されているものではありません。インストールは自己責任で行ってください。

PHP 拡張をインストールする

Plesk に PECL の PHP 拡張をインストールするには、拡張を特定の PHP ハンドラに関連付けます。特定の拡張機能は、すべての拡張をインストールして使用できる PHP ハンドラもありますが、PHP ハンドラによっては使用できません。特定の PHP ハンドラ用の PHP 拡張を PECL からインストールすると、同じ PHP バージョンを使用するすべての PHP ハンドラタイプで使用できるようになりますが、それ以外のハンドラでは使用できません。

たとえば、 8.3.14 FPM application ハンドラ用の拡張をインストールすると、 8.3.14 FastCGI application ハンドラと 8.3.14 専用 FPM application ハンドラでも使用できるようになりますが、 8.2.25 FPM application ハンドラでは使用できません。この拡張を 8.2.25 FPM application ハンドラでも使用できるようにするには、そのハンドラまたは同じ PHP バージョンとバイナリを使用する他のハンドラ用の拡張をインストールする必要があります

最新バージョンの拡張をインストールする

ベストプラクティスとして、ソフトウェアコンポーネントの最新バージョンを使用することをお勧めします。デフォルトで、拡張の最新の stable バージョンがインストールされます。

GUI 経由で最新バージョンの拡張をインストールするには:

  1. Plesk にログインします。

  2. [ツールと設定] > [PHP 設定] ([一般設定] の下) の順に移動します。

  3. 目的の PHP ハンドラをクリックして、 [PECL パッケージを管理] をクリックします。

  4. 目的の拡張を見つけて (必要に応じて検索バーを使用)、 image ui lib plus をクリックします。

    image ready to install

インストールした拡張は、そのハンドラと、同じ PHP バージョンおよびバイナリを使用する他のハンドラで使用できるようになります。この拡張は、これらのハンドラで使用可能な他の拡張のリストで見つけることができます。たとえば、 ioncube_loader 拡張をインストールすると、次のように表示されます。

image installed extension

インストールされた拡張はデフォルトで有効になりますが、他の PHP 拡張と同様に無効にすることができます。

CLI 経由で最新バージョンの拡張をインストールするには:

  1. SSH 経由で root ユーザとして Plesk サーバにログインします。

  2. 以下のコマンドを実行します。

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

    <extension name> を拡張の名前に置き換え、 <handler id> を目的の PHP ハンドラの ID に置き換えます。たとえば、PHP 8.3 FPM application ハンドラ用の msgpack 拡張をインストールするには、次のコマンドを実行します。

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

    注釈: PHP ハンドラの ID を確認するには、 plesk bin php_handler --list コマンドを実行します。

拡張がインストールされると、問題の PHP ハンドラで使用可能な他の拡張のリストに表示されます。

特定のバージョンの拡張をインストールする

状況によっては、互換性などの理由から、以前のバージョンの拡張を使用する必要がある場合があります。この手順を使用して、拡張の beta バージョンをインストールすることもできます。

GUI 経由で特定のバージョンの拡張をインストールするには:

  1. Plesk にログインします。

  2. [ツールと設定] > [PHP 設定] ([一般設定] の下) の順に移動します。

  3. 目的の PHP ハンドラをクリックして、 [PECL パッケージを管理] をクリックします。

  4. [パッケージをインストール] をクリックします。

  5. 必要なパッケージの名前と、必要なバージョンまたは状態を指定して、 [OK] をクリックします。

    たとえば、 msgpack 拡張の最新の beta バージョンをインストールするには、次のように指定します。

    msgpack-beta

    msgpack 拡張のバージョン 2.2.0 をインストールするには、次のように指定します。

    msgpack-2.2.0
    image ready to install beta

インストールした拡張は、そのハンドラと、同じ PHP バージョンおよびバイナリを使用する他のハンドラで使用できるようになります。この拡張は、これらのハンドラで使用可能な他の拡張のリストで見つけることができます。たとえば、 ioncube_loader 拡張をインストールすると、次のように表示されます。

image installed extension

CLI 経由で特定のバージョンの拡張をインストールするには:

  1. SSH 経由で root ユーザとして Plesk サーバにログインします。

  2. 以下のコマンドを実行します。

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

    <extension name> を拡張の名前と必要なバージョンまたは状態に置き換え、 <handler id> を目的の PHP ハンドラの ID に置き換えます。たとえば、PHP 8.3 FPM application ハンドラ用の msgpack 拡張の最新の beta バージョンをインストールするには、次のコマンドを実行します。

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

    PHP 8.3 FPM application ハンドラ用の msgpack 拡張のバージョン 2.2.0 をインストールするには、次のコマンドを実行します。

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

    注釈: PHP ハンドラの ID を確認するには、 plesk bin php_handler --list コマンドを実行します。

拡張がインストールされると、問題の PHP ハンドラで使用可能な他の拡張のリストに表示されます。

PHP 拡張をアップデートする

ベストプラクティスとして、サーバ上のすべてのソフトウェアコンポーネントを最新バージョンにアップデートしておくことが推奨されます。これには PHP 拡張も含まれます。

インストールされている拡張の新しいバージョンが利用可能になると、古くなった拡張には Plesk GUI で image ui lib triangle exclamation mark filled アイコンが表示され、最新バージョンにアップデートすることができます。

GUI を使用してインストールされた拡張を最新バージョンにアップデートするには:

  1. Plesk にログインします。

  2. [ツールと設定] > [PHP 設定] ([一般設定] の下) の順に移動します。

  3. 目的の PHP ハンドラをクリックして、 [PECL パッケージを管理] をクリックします。

  4. 目的の拡張を見つけて (必要に応じて検索バーを使用)、 image ui lib arrow up をクリックします。

    image outdated extension

拡張が PECL で提供されている最新バージョンにアップデートされます。

インストールされた拡張を CLI 経由でアップデートすることもできます。これを行うには、 最新バージョンの拡張をインストールする場合と同じ手順 を使用します。たとえば、PHP 8.3 FPM application ハンドラ用にインストールされた msgpack 拡張を最新バージョンにアップデートするには、次のコマンドを実行します。

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

拡張が PECL で提供されている最新バージョンにアップデートされます。

PHP 拡張を削除する

ソフトウェア コンポーネントが不要になったら、ベストプラクティスとして、潜在的な競合やセキュリティ上の問題を回避するために削除することをお勧めします。これには PHP 拡張も含まれます。インストールした拡張が不要になった場合、削除することが推奨されます。拡張が再び必要になった場合は、 再インストール できます。

インストールされた拡張を GUI 経由で削除するには:

  1. Plesk にログインします。

  2. [ツールと設定] > [PHP 設定] ([一般設定] の下) の順に移動します。

  3. 目的の PHP ハンドラをクリックして、 [PECL パッケージを管理] をクリックします。

  4. 目的の拡張を見つけて (必要に応じて検索バーを使用)、 image ui lib recycle をクリックし、削除を確認します。

    image ready to remove

拡張を削除すると、そのハンドラおよび同じ PHP バージョンとバイナリを使用する他のハンドラで、この拡張が使用できなくなります。

インストールされた拡張を CLI 経由で削除するには:

  1. SSH 経由で root ユーザとして Plesk サーバにログインします。

  2. 以下のコマンドを実行します。

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

    <extension name> を拡張の名前に置き換え、 <handler id> を目的の PHP ハンドラの ID に置き換えます。たとえば、PHP 8.3 FPM application ハンドラ用の msgpack 拡張を削除するには、次のコマンドを実行します。

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

    注釈: PHP ハンドラの ID を確認するには、 plesk bin php_handler --list コマンドを実行します。

拡張を削除すると、そのハンドラおよび同じ PHP バージョンとバイナリを使用する他のハンドラで、この拡張が使用できなくなります。