EC-CUBE4.0系でプラグインインストール時にシステムエラー「plugin-installer not found」エラーが出たときの対処方法

EC-CUBE4.0系のサイトで、管理画面からプラグインをインストールしようとした際に「システムエラー」が発生し、インストールができない事象に遭遇しました。

キャッシュ削除など一般的な対処を試しても改善せず、エラーログを確認したところ Composer 1 のサポート終了に関連するエラー が出ていました。

最終的には プラグインファイルを手動でアップロードすることで解決 できたため、本記事ではこの際の内容をまとめています。

同様のトラブルで困っている方の参考になれば幸いです。

EC-CUBE4.0系でプラグインインストール時にシステムエラーが発生

EC-CUBE4.0系のサイトで、管理画面からプラグインをインストールしようとした際にシステムエラーが発生しました。

今回の手順は以下です。

1. 管理画面
   コンテンツ管理 ＞ メンテナンス管理
   より、メンテナンスモードを有効化
2. オーナーズストア ＞ インストールプラグイン一覧
   [オーナーズストアのプラグイン] から対象プラグインのインストールを実行

しかし、インストール処理中にシステムエラーが発生しました。

なお、

• 管理画面にはアクセス可能
• フロントサイトの表示にも問題なし

という状態でした。

環境

今回の環境は以下の通りです。

• EC-CUBEバージョン：4.0.4
• PHPバージョン：7.4.33
• サーバー：エックスサーバー

EC-CUBE4.0系はやや古いバージョンのため、現在の環境との互換性問題が発生するケースも考えられます。

キャッシュ削除を試してもエラーは解消せず

管理画面には引き続きアクセスできたため、まずは一般的な対処としてキャッシュ削除を試しました。

手順

管理画面
コンテンツ管理 ＞ キャッシュ管理 ＞ キャッシュ削除

その後、再度プラグインインストールを実行しましたが、結果は変わらずシステムエラーが発生しました。

なお、キャッシュ削除はEC-CUBEでプラグインインストールに失敗した際の対処法としてよく紹介されている方法で、まず最初に試すことが多いです。

エラーログを確認

次に、エラーの原因を特定するためサーバー内のエラーログを確認しました。

ログの確認方法

FTPソフトを使用し、以下のディレクトリを確認します。

/var/log/prod/

この配下に以下のようなログファイルがあります。

admin-YYYY-MM-DD.log

ログに表示されたエラー内容

今回のエラー発生日時に該当するログを確認したところ、次のようなメッセージが出力されていました。

このログから、次の可能性が考えられます。

• サーバー環境がComposer 1 系を使用している
• Composer 1 は2025年9月1日にサポート終了
• そのためパッケージ取得に失敗している可能性

また、ログ内の

というメッセージから、必要なパッケージを取得できずインストール処理が失敗している可能性も考えられます。

Composer1サポート終了の影響の可能性

EC-CUBEでは オーナーズストア経由でプラグインをインストールする際に、内部でComposer処理が実行されます。
そのため、今回ログに出ていた Composer1のサポート終了がインストール処理に影響している可能性 が考えられます。

エラー内容を元に調べたところ、同様の事例の対処法として次のような情報が見つかりました。

• Composer2へアップデートしても解決しないケース
• SSHでコマンドインストールすると解決するケース
• 手動インストールで回避できるケース

しかし今回は

• SSH操作の知識が不足している
• サーバー環境の変更はすぐに実施できない

という状況だったため、まずはすぐ実行できる方法として手動インストールを試すことにしました。

オーナーズストアの購入履歴からプラグインをダウンロード可能か確認

EC-CUBEオーナーズストアの購入履歴には、プラグインファイルをダウンロードできる場合があります。

購入履歴に 「ダウンロード」リンクが表示されていれば、そこからプラグインファイルを取得できます。

プラグイン開発元へファイル提供を依頼

今回のプラグインでは、購入履歴にダウンロードリンクが表示されていませんでした。

そのため、プラグイン開発元に問い合わせを行い、プラグインファイルの提供が可能か相談しました。

結果として、開発元よりプラグインファイルを提供いただくことができました。

手動アップロードでプラグインをインストール

プラグインファイルを取得できたため、EC-CUBE管理画面から手動インストールを実施しました。

管理画面
オーナーズストア ＞ プラグイン一覧
[ユーザー独自プラグイン] から「アップロードして新規追加」を実行

アップロード後、インストール・有効化ともに問題なく完了しました。

補足：キャッシュ削除でプラグインの管理画面メニューが表示

プラグインのインストールと有効化は完了しましたが、管理画面にプラグインの設定メニューが表示されなかったため、キャッシュ削除を行いました。

管理画面
コンテンツ管理 ＞ キャッシュ管理 ＞ キャッシュ削除

キャッシュ削除後、管理画面にプラグインの設定メニューが表示され、正常に操作できるようになりました。

まとめ

EC-CUBE4.0系でプラグインインストール時にシステムエラーが発生した場合、今回のように Composer環境の影響 が原因になっている可能性があります。

今回確認したエラーログには Composer1のサポート終了に関するメッセージ が出力されており、オーナーズストア経由のインストール時に実行されるComposer処理が影響していた可能性が考えられます。

そのため、結果として プラグインファイルを手動アップロードすることで問題を回避できました。
手動インストールではComposer処理が行われないため、正常にインストールできた可能性があります。

EC-CUBE4.0系はやや古い環境のため、今後もComposer関連の問題が発生する可能性があります。
同様のエラーが発生した場合は、まずエラーログを確認したうえで、プラグインの手動インストールを一度試してみるとよいかもしれません。