ECCUBEをインストールまたは運用する際に、「apc拡張モジュールが有効になっていません」というエラーメッセージが表示されることがあります。これは、PHPの「apcu」モジュールがインストールされていない、または有効になっていないことが原因です。本記事では、この問題を解決するための手順を詳しく解説します。

apc拡張モジュールとは？

APC（Alternative PHP Cache）は、PHPのパフォーマンスを向上させるためのキャッシュ機能を提供するモジュールです。現在では「apcu」として提供されており、PHPアプリケーションの速度を向上させるために重要な役割を果たしています。ECCUBEではこのモジュールが必須です。

エラーの確認方法

ECCUBEのインストールや実行中に「apc拡張モジュールが有効になっていません」というエラーが表示される場合、以下のコマンドでAPCuモジュールがインストールされているか確認できます。

php -m | grep apcu

何も表示されなければ、APCuモジュールがインストールされていないことになります。

APCuモジュールのインストール方法

PHPのAPCuモジュールは、簡単にインストールできます。以下の手順でAPCuモジュールをインストールしてください。

1. パッケージリストの更新

まず、システムのパッケージリストを最新に更新します。

sudo apt update

2. PHP用APCuモジュールのインストール

PHPのAPCuモジュールをインストールするには、以下のコマンドを実行します。

sudo apt install -y php-apcu

これで「apcu」モジュールがインストールされます。

3. Webサーバーの再起動

APCuモジュールを有効化するため、Webサーバー（ApacheやPHP-FPM）を再起動します。

sudo systemctl restart apache2

または

sudo systemctl restart php8.x-fpm

インストール後の確認

インストールが成功したか確認するため、以下のコマンドを再度実行します。

php -m | grep apcu

「apcu」と表示されれば、インストールは成功です。有効になっていないと上記のメッセージが表示されます。

PHP設定ファイルの確認

PHPの設定ファイルで、APCu拡張が有効になっているかを確認します。設定ファイル（例: /etc/php/8.x/apache2/php.ini）を開き、次の行がコメントアウトされていないか確認します。

extension=apcu.so

もしコメントアウトされていた場合、行の先頭にある「;」を削除し、設定を保存してWebサーバーを再起動します。

PHPバージョンに応じたモジュールのインストール

APCuモジュールはPHPバージョンに依存する場合があるため、バージョンに応じたパッケージをインストールする必要があります。例えば、PHP7.4を使用している場合は、以下のコマンドを実行します。

sudo apt install -y php7.4-apcu

PHPのバージョンはphp -vで確認できるため、適切なバージョンのパッケージをインストールしてください。

エラーが解決しない場合の対処方法

もし上記の手順を試してもエラーが解決しない場合、以下の点を確認してください。

• PHPの設定ファイルでapcu拡張が正しく有効になっているか。
• PHPのバージョンがECCUBEの推奨バージョンと一致しているか。
• Webサーバー（ApacheやNginxなど）が再起動されているか。
• 他のキャッシュ拡張（例えばopcacheなど）と競合していないか。

まとめ

「apc拡張モジュールが有効になっていません」というエラーは、APCuモジュールがインストールされていないことが原因です。正しい手順でAPCuモジュールをインストールし、有効にすることで、ECCUBEのインストールと運用がスムーズになります。

適切に設定されたAPCuモジュールは、ECCUBEのパフォーマンスを大きく向上させ、快適なユーザー体験を提供するために重要です。