EC-CUBEプラグインのインストール時、アップデート時にエラーが発生する
EC-CUBEにプラグインをインストールする際にエラーが発生したり、バージョンアップする際にエラーが発生することがあります。
- プラグイン・インストール時にエラーが発生
- プラグイン・アップデート時にエラーが発生
- プラグイン有効化時にエラーが発生
- プラグイン有効化は完了したが表示崩れが発生
プラグインをインストール、アップデートする際は必ずメンテナンスモードにする
エラーの原因・対策をご説明する前に、インストール時/アップデート時/有効化時に必ずして頂きたいことをご紹介します。
プラグインをインストールしたりアップデートする、もしくは有効化する際は必ずEC-CUBEをメンテナンスモードにしてください。
メンテナンスモードにすることで、キャッシュ関連のエラーを回避することができる為です。
尚、「メンテナンスモードにしたらシステムエラーが発生した」というご相談を頂いたこともありますので、十分にご注意ください。
エラーの原因
想定されるエラーの原因は以下です。
EC-CUBEをメンテナンスモードにしていない
プラグインのインストール、アップデート、有効化を行う際は、EC-CUBEをメンテナンスモードにすることが推奨されています。
弊社としては推奨ではなく必須と判断しています。
EC-CUBEをオープン状態にしておくと外部からのアクセスがある為、キャッシュファイルの処理が正常に行われない可能性があります。
キャッシュファイルの処理が失敗している
キャッシュファイルの処理が失敗すると、エラーが発生します。
メンテナンスモードでないとキャッシュファイルの処理が失敗することがありますが、それ以外でもキャッシュファイルの処理が失敗することがあります。
他プラグインとの競合
他のプラグインと競合してエラーが発生することがあります。
競合とは、複数のプラグイン同士が干渉し合って正常に処理が行えないことです。
直接の原因を究明する必要がある
しかし、上記が判明してもエラーは解決できません。
例えばエラーが発生したのが「キャッシュファイルの処理が失敗していた為」と考えられる場合、『ではなぜキャッシュファイルの処理が失敗したのか？』を突き止めないとエラーの対応策を検討することは不可能です。
エラーの対処法
エラーが発生した際の対応策です。
メンテナンスモードで作業する
メンテナンスモードにしておらずエラーが発生した場合、メンテナンスモードにして再度作業をしてみます。
キャッシュファイルを削除する
キャッシュファイルの処理が正常に行われないことで、エラーが発生します。
その場合は、キャッシュファイルを削除します。
キャッシュを削除すると新たにキャッシュが作成されますので、正常なキャッシュが生成されエラーが発生しなくなります。
すべてのプラグインを無効化する
プラグインが競合している可能性がある場合、すべてのプラグインを無効化し１つずつ有効化することで解決することがあります。
すべてのプラグインを削除する
プラグインが競合している可能性がある場合、すべてのプラグインを削除し１つずつインストールし直すことで解決することがあります。
コマンドラインで実行する
管理画面からインストールやアップデートを行うよりも、コマンドで実行する方が安定した処理を行えます。
システムに詳しい方がいない場合はEC-CUBEパートナーへ相談を
エラーおよび対応策に関する詳細内容が紹介されています。
EC-CUBE4系でのプラグインエラーの原因と予防対策 – Qiita
エラーに対処する際は、上記ページにある作業を行う必要があり、システムに詳しい方でないとプラグインのエラーに対応することは難易度が高いです。
その為、社内にシステムに詳しい方が不在の場合は、EC-CUBEパートナー制作会社にご相談することをおすすめします。
投稿者プロフィール
- CEO
- 株式会社サンクユー 代表取締役CEO。
基幹システムとECをつなぎ、受発注業務の最適化を支援する専門家。
関西大学卒業後、東証プライム上場のゼネコンにて人事総務を経験。
その後システムベンダーへ転職し、IBM AS/400環境における金融・物流・販売管理・経理・人事など、企業の基幹業務を支えるシステム開発に従事する。
プログラマからプロジェクトマネージャーまでを経験し、台湾・台北駐在として銀行システム構築プロジェクトにも参画。
この経験を通じて、「システムの質は要件定義の質に比例する」という思想を確立。
業務理解を起点としたシステム設計を強みとする。
その後、クレジット決済代行会社にて、決済システムの再構築や銀行連携、ECサイト構築を担当。
あわせて組織改革にも携わり、20名から60名規模への組織拡大を実現（退任時：常務取締役）。
2008年に株式会社サンクユーを創業、2010年に法人化。
現在は、基幹システムとECの両領域に精通した知見を活かし、BtoB企業における受発注業務のデジタル化・効率化を支援。
特に、FAX・電話・メールなどアナログ業務のEC化や、基幹システムとの連携を前提とした業務設計を得意とする。
単なるECサイト構築にとどまらず、業務フローの整理・要件定義・システム設計まで一貫して関与し、「現場で使われる仕組み」を実現することを重視している。
NTTレゾナント「goo Search Solution」にてEC関連コラムを執筆。
ECマーケティングレポート | goo Search Solution
■趣味・関心領域
BMW / WRC / ロードバイク / RIZIN / UFC / 大相撲
David Bowie / blur / MUSE / The Rolling Stones / XTC
機動戦士ガンダム（富野由悠季）
ベルセルク / 頭文字D / 進撃の巨人 / ジョジョの奇妙な冒険 / あしたのジョー
Mission: Impossible / Memento / ワイルド・スピード / ソナチネ
LOST / Game of Thrones / FRINGE / The Mentalist
上岡龍太郎 / ダウンタウン
