ECCUBEをインストールすると、エラーメッセージ「[必須] intl拡張モジュールが有効になっていません」が表示されることがあります。これは、PHPの「intl」拡張モジュールがインストールされていないか、有効になっていないためです。本記事では、この問題を解決する方法を詳しく解説します。

intl拡張モジュールとは？

「intl」拡張モジュールは、PHPで多言語対応のアプリケーションを構築するために使用されるライブラリです。主に、国際化対応のための文字列操作や、日付、時刻のローカライズ、言語ごとの変換処理などをサポートします。

ECCUBEはこの拡張モジュールを必須としており、これがインストールされていないと、インストールや運用時にエラーが発生します。

エラーの確認

ECCUBEをインストールまたは実行中に、「[必須] intl拡張モジュールが有効になっていません」というエラーメッセージが表示された場合、この拡張モジュールがインストールされていないか、有効になっていないことが原因です。

以下のコマンドで、PHPにintl拡張がインストールされているか確認できます。

php -m | grep intl

何も表示されなければ、intl拡張がインストールされていないことになります。

intl拡張モジュールのインストール方法

intl拡張モジュールは、PHPの標準ライブラリとして提供されています。以下の手順でインストールできます。

1. パッケージの更新

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

sudo apt update

2. PHP intl拡張モジュールのインストール

次に、PHPのintl拡張モジュールをインストールします。以下のコマンドを実行します。

sudo apt install -y php-intl

これで、「intl」拡張モジュールがインストールされます。

3. PHPの再起動

モジュールをインストールした後、PHP-FPMやApacheなど、Webサーバーを再起動して変更を反映させます。

sudo systemctl restart apache2

または

sudo systemctl restart php8.x-fpm

インストール後の確認

intl拡張モジュールが正しくインストールされたか確認するために、再度次のコマンドを実行します。

php -m | grep intl

「intl」と表示されれば、インストールは成功です。

PHPの設定ファイルの確認

PHPの設定ファイルで、intlモジュールが有効になっているかを確認します。設定ファイル/etc/php/8.x/apache2/php.iniを開き、以下の行がコメントアウトされていないか確認します。

extension=intl.so

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

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

PHPのバージョンによっては、モジュールのインストール方法が異なる場合があります。バージョンに応じたパッケージ名を確認し、インストールを行ってください。

例えば、PHP7.4を使用している場合は、以下のコマンドを実行します。

sudo apt install -y php7.4-intl

PHPのバージョンが異なる場合は、php -vコマンドでバージョンを確認し、適切なパッケージをインストールしてください。

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

もし上記の手順を試しても「intl拡張モジュールが有効になっていません」というエラーが解決しない場合は、以下の点を確認してください。

• PHPの設定ファイルでintl拡張が正しく有効になっているか。
• PHPのバージョンが適切か（特に、ECCUBEが推奨するPHPバージョンを確認）。
• Webサーバー（ApacheやNginxなど）が再起動されているか。
• 他のPHP拡張が競合していないか。

まとめ

「[必須] intl拡張モジュールが有効になっていません」というエラーは、PHPのintl拡張モジュールがインストールされていないことが原因です。正しくインストールし、設定を確認することで、この問題を解決できます。

ECCUBEをスムーズに運営するためには、intl拡張を正しくインストールし、有効にすることが非常に重要です。