【EC-CUBE 4】オリジナルテーブルの保存データ（レコード）を削除する方法

2025年2月14日

データベースに追加したオリジナルテーブルのデータ（レコード）を削除するには？

この記事では、データベースに新規作成したテーブルのデータ（レコード）を、Web上から削除する方法について解説しています。
（こちらの記事の続き（オリジナルテーブル『dtb_Maker』を新規作成し、いくつかレコードを追加した状態）からの手順となります。）

レコードの追加 / 更新についてはこちら

【EC-CUBE 4】オリジナルテーブルに新規データ（レコード）を追加する方法

【EC-CUBE 4】オリジナルテーブルの保存データ（レコード）を更新する方法

開発前にデバッグモードの設定をお薦めします

デバッグモードを設定しておくと、エラーが起きたときに詳細情報が表示されるようになります。
エラー箇所を探しやすくなるので、開発前に設定しておくのをオススメします。
デバッグモードの設定方法については以下記事で解説しています。

【EC-CUBE 4】デバッグモードの設定/解除方法

カスタマイズ後は、デバッグモードの解除を忘れないように。

【動作環境】
EC CUBEのバージョン：4.3.0
サーバー：XServer

実装後の状態

オリジナルテーブル『dtb_Maker』に、3つのレコードが格納されています。このうち、ID = 1のレコードを削除します。

「(ドメイン名)/maker_delete/(数字)」にアクセスすると、末尾に指定した数字と同じIDのレコードを削除するページが表示されます。
なお、アクセス時には現在格納されている値が表示されます。

レコード削除後のデータベース — 『dtb_Maker』テーブルから、id = 1 のレコードが消えています。

『Delete』ボタンをクリックすると、該当のレコードがテーブルから削除されました。

実装までの手順

新規作成と同様に、エンティティ削除のためのフォームを用意します。フォームには削除したいレコードの中身が表示されており、ボタンをクリックするとそのレコードが削除されます。（前項の通り。）

データ（レコード）を削除するためのページを作成する

まずは削除するためのページを作成します。

新規ページはEC-CUBE管理画面から簡単に作成できますが、あとでControllerを修正する必要があり、Controllerも合わせて用意しなければなりません。具体的には以下記事で解説していますので、本記事では省きます。

作成したページのControllerを修正する

新しくページを用意できたら、「app/Customize/Controller」に保存してあるControllerを以下の通り修正します。

<?php

namespace Customize\Controller;

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\Routing\Annotation\Route;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
use Eccube\Controller\AbstractController;
use Customize\Entity\Maker;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\Extension\Core\Type\SubmitType;
use Doctrine\ORM\EntityManagerInterface;

class MakerDeleteController extends AbstractController
{
  /**
   * @Route("/maker_delete/{id}", name="maker_delete")
   * @Template("maker_delete.twig")
   */
  public function delete(Request $request, Maker $maker, EntityManagerInterface $entityManager)
  {
    $form = $this->createFormBuilder($maker)
      ->add('name', TextType::class, array('label' => 'メーカー名'))
      ->add('code', TextType::class, array('label' => 'メーカーコード'))
      ->add('save', SubmitType::class, array('label' => 'Delete'))
      ->getForm();

      if ($request->isMethod('POST')) {
        $form->handleRequest($request);
  
        if ($form->isSubmitted() && $form->isValid()) {
          $maker = $form->getData();
          $entityManager->remove($maker);
          $entityManager->flush();
          return $this->redirect('/maker_register');
        } else {
          return [
            'message' => 'メーカー情報を削除できませんでした。',
            'form' => $form->createView(),
          ];
        }
      }
      
      return [
        'message' => 'ID: ' . $maker->getId() . ' のメーカー情報を削除します。',
        'form' => $form->createView(),
      ];
  }
}

長々としたコードですが、削除したいデータ（レコード）の取得はエンティティの自動フェッチ機能を利用し、フォームの生成やレコードの削除はレコードの追加（こちらの記事で解説）または更新（こちらの記事で解説）とほぼ同じです。

エンティティの自動フェッチ

@Route("/maker_delete/{id}"

public function delete(Request $request, Maker $maker, EntityManagerInterface $entityManager)

URL末尾({id})の数字と同じIDをもつエンティティを、Maker $makerとして引数に渡すことができます。
これによってURL末尾の数字と同じIDのレコードを抽出でき、レコード別に削除ページが生成されます。

自動フェッチの詳細はこちら

【EC-CUBE 4】ID毎に詳細情報を表示するページの作り方（自動フェッチ）指定IDのエンティティを取得できる『自動フェッチ』機能を使ってID別ページを作成しよう！この記事では、URLの末尾にIDを指定することで、そのIDに対応するエンティテ…

フォームの作成

use Customize\Entity\Maker;

まず、新規データを追加したいEntityを宣言します。
今回は、こちらの記事で用意した「Maker.php」を使用します。

use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\Extension\Core\Type\SubmitType;

次に、使いたいフォームのタイプを宣言します。今回用意したTextTypeとSubmitTypeの他、ChoiceTypeなど多数用意されているので、フォームの種類に応じて追加・修正してください。

【EC-CUBE 4】ドロップダウンリスト / ラジオボタン / チェックボックスの実装方法

【EC-CUBE 4】お問い合わせに日付のフォームを実装する方法

【EC-CUBE 4】入力フォームの初期値または入力例を設定する方法

use Doctrine\ORM\EntityManagerInterface;

public function delete(Request $request, Maker $maker, EntityManagerInterface $entityManager)

Symfony 5.3 以降ではgetDoctrine() メソッドが非推奨になり、Symfony 6 では削除されました。そのため、EntityManagerInterface をインジェクションする必要があります。MakerRegisterController の delete メソッドの引数に EntityManagerInterface を追加します。

$form = $this->createFormBuilder($maker)
  ->add('name', TextType::class, array('label' => 'メーカー名'))
  ->add('code', TextType::class, array('label' => 'メーカーコード'))
  ->add('save', SubmitType::class, array('label' => 'Delete'))
  ->getForm();

こちらの記述でフォームを作成します。
addメソッドの第一引数はテーブルの項目と一致するようにし、第二引数にフォームタイプを、第三引数にラベル名を配列で指定します。登録したい項目の数だけ->でaddメソッドを繋ぎます。

createFormBuilderの引数である$makerには、自動フェッチによって取得したレコードが代入されています。そのため、最終的に表示されるフォームには現在格納されている値が設定された状態で表示されます。

データ（レコード）の削除

if ($request->isMethod('POST'))

POST送信時（フォーム送信時）、レコードを削除する処理をこちらに記載します。

$form->handleRequest($request);
$maker = $form->getData();

フォームから受け取ったデータを取り扱うときの決まり文句。
まずhandleRequest($request)で、送信されたフォーム情報を取り扱えるようにします。続いて、getData()で送信されたフォームの値が$makerに格納されます。

$entityManager->remove($maker);
$entityManager->flush();

「マネージャ」というクラスを使うことで、データ（レコード）の追加や更新、削除ができます。removeメソッドを使って、引数に指定したエンティティを削除します。最後に、flush()メソッドで変更内容をデータベースに反映させます。

作成したページのTwigを修正する

レコードの新規追加時に作成したTwigと同様に、Controllerから渡されたmessageとformを表示するだけのシンプルなテンプレートを作成します。
Controllerから渡された情報をTwigで表示する方法についてはこちらの記事にて。

{% extends 'default_frame.twig' %}

{% block main %}

<h1>{{ message }}</h1>
{{ form_start(form) }}
{{ form_widget(form) }}
{{ form_end(form) }}

{% endblock %}

フォームの表示