【EC-CUBE 4】遭遇したエラー＆対処法まとめ

EC-CUBE 4のカスタマイズ中に遭遇したエラーと、その対処法をまとめています。エラーメッセージから逆引きできるよう早見表を用意しました。同じ画面で止まってしまったときの参考になれば幸いです。（随時更新中）

APP_ENV=dev
APP_DEBUG=1

エラーメッセージ早見表

出ているメッセージに近いものを探して、右端のリンクから該当箇所へ飛んでください。

1. 名前空間と保存先、ファイル名とクラス名の食い違い

Compile Error: Cannot declare class Customize\Controller\Admin\SampleController,
because the name is already in use

名前空間と保存先が食い違っているケース

namespace に書かれたディレクトリと、実際のファイルの置き場所が違うときに出ます。上の例では名前空間が Customize\Controller\Admin なのに、ファイルは app/Customize/Controller/SampleController.php に置かれています。

Compile Error: Cannot declare class Customize\Controller\SamplePageController,
because the name is already in use

ファイル名とクラス名が食い違っているケース

同じメッセージが、ファイル名とクラス名が一致していないときにも出ます。オートローダーはクラス名から対応するファイルを探すため、名前が違うと正しく読み込めません。

2. use ステートメントの書き忘れ

Attempted to load class "AbstractController" from namespace "Customize\Controller".
Did you forget a "use" statement for e.g. "Symfony\Bundle\FrameworkBundle\Controller\AbstractController"
or "Eccube\Controller\AbstractController"?

クラスが見つからないと、候補まで提示してくれる

Could not load type "Customize\Form\Type\Admin\TextType": class does not exist.

フォームの型が見つからないケース

ファイル内で使っているクラス（この例では AbstractController や TextType）が use に書かれていないときに出ます。既存のControllerなどを Customize へ複製してカスタマイズしたときに起きやすいエラーです。

use Eccube\Controller\AbstractController;
use Symfony\Component\Form\Extension\Core\Type\TextType;

3. URLに対応するルートが見つからない

No route found for "GET https://xxxx/yyyy"

そのURLを受け持つController が見つからない

Controllerの @Route に対応するルートが無いときに出ます。打ち込んだURLか、Controllerの記述が間違っている可能性があります。

bin/console cache:clear --no-warmup

4. Twigに渡っていない変数を使っている

Variable "sample" does not exist

変数名がそのまま表示されるので特定しやすい

Twigテンプレート内で使っている変数（この例では sample）が定義されていないときに出ます。Controllerから渡し忘れているか、単にスペルを間違えているかのどちらかがほとんどです。

5. for や if を閉じ忘れている

Unexpected "endblock" tag (expecting closing tag for the "for" tag defined near line 87).

開いたタグの行番号まで教えてくれる

for を開いたまま endblock で閉じようとしたときに出ます。「87行目で開いた for の閉じタグが要る」と行番号まで書いてあるので、そこを見ればすぐ分かります。

6. 同じメソッドを2回宣言している

Compile Error: Cannot redeclare Customize\Controller\SampleController::index()

クラス名とメソッド名が明示される

1つのクラスの中で、同じ名前のメソッドを2回以上宣言したときに出ます。既存のメソッドをコピーして新しいメソッドを作り、名前を変え忘れたときに起きやすいエラーです。

7. 削除された RegistryInterface を使っている

Cannot autowire service "Customize\Repository\FaqRepository":
argument "$registry" of method "__construct()"
has type "Symfony\Bridge\Doctrine\RegistryInterface" but this class was not found.

古いRepositoryを流用したときに起きやすい

古いバージョン向けに書かれたRepositoryをコピーしてきたときに出ます。RegistryInterface は Symfony 4.3 で非推奨になり、その後完全に削除されました。

use Doctrine\Persistence\ManagerRegistry as RegistryInterface;

8. FormTypeExtension が古い書き方のまま

Error: Class Customize\Form\Extension\Front\ContactTypeExtension contains 1 abstract method
and must therefore be declared abstract or implement the remaining methods
(Symfony\Component\Form\FormTypeExtensionInterface::getExtendedTypes)

実装すべきメソッド名がそのまま出ている

これも古いバージョン向けのコードを流用したときに出ます。getExtendedType()（単数形）は Symfony 4.2 で非推奨となり、getExtendedTypes()（複数形）を staticメソッドとして実装する必要があります。

public static function getExtendedTypes(): iterable
{
    return [ContactType::class];
}

まとめ

ここまでのエラーを、原因の系統でまとめるとこうなります。

EC-CUBEのカスタマイズに関する記事

• カスタマイズのまとめ
• デバッグモードの設定/解除方法
• 変数の中身を確認する方法（dump関数）
• 新規ページの作成方法（user_dataなし）
• Repositoryの新規作成およびデータを表示する方法
• お問い合わせフォームに新しい項目を追加する方法
• ショップメールがGmailなどで受信できない問題について

この記事に出てきた用語

• EC-CUBEとは？
• デバッグとは？
• エラーハンドリングとは？
• 構文エラーとは？
• Symfonyとは？
• ルーティングとは？
• リポジトリとは？
• キャッシュとは？