データ移行プラグイン for EC-CUBE 4.2 / 4.3

このプラグインは、お使いのEC-CUBEを最新の4.2系または4.3系へバージョンアップする際に、サイトのデータを簡単に移行するためのデータ移行支援プラグインです。

🎯 このような方におすすめ

• 旧バージョンのEC-CUBEを利用しており、セキュリティ面や機能面で最新版にアップデートしたい方
• サイトをリニューアルするにあたり、既存の会員情報、商品、受注データをそのまま引き継ぎたい方
• 手作業でのデータ移行に不安がある方

🔄 対応バージョン

移行元:EC-CUBE 2.x / 3.x / 4.0 / 4.1
移行先:EC-CUBE 4.2 / 4.3

📦 移行できる主なデータ

• 会員データ(顧客情報・お届け先住所)
• 商品データ(商品情報・規格・商品画像)
• カテゴリ
• 受注データ(注文・配送・明細)
• 支払い方法・配送方法(受注との紐づけ用に移行)
• 税設定

✨ 特長

• EC-CUBE 2系の標準バックアップ機能で取得した .tar.gz ファイルをそのままアップロードするだけ
• EC-CUBE 3系はバックアッププラグインで取得したデータに対応
• 4.0 / 4.1 からの移行はすべてのデータを移行可能
• メルマガ管理プラグイン、ポイントプラグイン、ECCUBE2Downloads との連携に対応

📄 ライセンス

LGPL-3.0
GitHub: https://github.com/nobuhiko/data-migration-plugin

このプラグインは、データの移行を支援するものであり、EC-CUBE本体のプログラムをバージョンアップするものではありません。

サイトのデザイン(テンプレート)や、独自にカスタマイズした機能、追加した他のプラグインなどはデータ移行の対象外です。これらは別途、EC-CUBE 4.2/4.3系に対応したものを準備・設定いただく必要があります。

⚠ 移行を実行すると、移行先EC-CUBEの既存データは上書きされます。
必ず新規構築した環境、またはバックアップを取得した環境で実施してください。

バックアップデータの準備

移行元のバージョンに応じて、以下の方法でバックアップデータを取得してください。

• EC-CUBE 2系:管理画面の「システム設定>バックアップ管理」から標準のバックアップ機能で取得してください。プラグインのインストールは不要です。取得した .tar.gz ファイルをそのままアップロードします(.tar に展開する必要はありません)。
• EC-CUBE 3系:バックアッププラグインをインストールし、バックアップを取得してください。
• EC-CUBE 4.0 / 4.1:EC-CUBE4.2系移行用バックアッププラグイン(4.0/4.1系)をインストールし、バックアップを取得してください。

アップロードファイルの最大容量はPHPの設定(memory_limit, post_max_size, upload_max_filesize)に依存します。バックアップファイルが10MBを超える場合は、.htaccess や php.ini で上限値を引き上げてください。

PostgreSQLをご利用の場合は、super user 権限が必要です。
super user 権限が不要になりました!

会員

dtb_customer, dtb_customer_address, mtb_sex, mtb_job

管理者

dtb_member, mtb_authority

商品

dtb_product, dtb_product_class, dtb_class_category, dtb_class_name, dtb_product_image, mtb_sale_type

カテゴリ

dtb_category, dtb_product_category

受注

dtb_order, dtb_shipping, dtb_order_item

支払い方法

dtb_payment ※データは移行するが非表示設定

配送方法

dtb_delivery, dtb_delivery_fee, dtb_delivery_time ※データは移行するが非表示設定

税設定

dtb_tax_rule

4.0 / 4.1 → 4.3 への移行の場合

4.0 / 4.1 から 4.3 への移行は、すべてのデータが移行されます。

移行できないデータ

• カート(dtb_cart, dtb_cart_item)
• 決済と配送の紐づけ(dtb_payment_option)
• 決済モジュール
• 複数配送の受注データ
• 画像ファイルなど、ファイル一式

以下のプラグインがインストールされている場合、連携して追加データを移行できます。

メルマガ管理プラグイン

会員のメールマガジン送付設定を移行

ポイントプラグイン

会員のポイントを移行(2.x のみ対応)

ダウンロード販売プラグイン for 4.3系

ダウンロード商品の移行に対応

• 2.x の mtb_product_type から「ダウンロード」販売種別を自動検出
• dtb_product_class と dtb_delivery の sale_type_id を ダウンロード販売プラグイン for 4.3系 の販売種別ID(222)に書き換え
• down_filename / down_realfilename も自動的に移行

ダウンロード販売プラグイン for 4.3系 がインストールされていない場合、ダウンロード商品は移行されません。

会員項目追加プラグイン for EC-CUBE4.2～4.3

• 2系からの移行のみに対応しています
• データのみの移行になります
• 会員項目追加プラグイン for EC-CUBE4.2～4.3 がインストールされている必要があります

パスワード・ログインについて

移行後は管理者・会員のパスワードも旧環境のものに置き換わります。
移行完了後、EC-CUBE 4.3 の .env ファイル内の ECCUBE_AUTH_MAGIC を旧環境の AUTH_MAGIC 値に書き換え、旧環境のID・パスワードでログインしてください。

古い EC-CUBE からの移行の場合、eccube_password_hash_algos: SHA256 への変更が必要な場合があります。

支払い方法・配送方法

支払い方法と配送方法は、受注データとの紐づけを維持するために移行されますが、非表示設定となります。
これらを有効化してそのまま利用することはできません。新規に作成・設定することを推奨します。

ポイントについて

ポイントは受注時点の 1pt あたりの金額が判別できないため、1pt = 1円として計算されます。
パラメータ設定で POINT_VALUE を変更している場合、正確な金額を移行できません。

受注ステータスについて

存在しない受注ステータスを利用している受注は、受注ステータスが null の状態で移行されます。
受注検索画面では表示されないため、移行後に適切な受注ステータスを紐付ける必要があります。

インストールについて

プラグイン内で composer を使用しているため、オーナーズストア経由でのインストールが必要です。

Q. ライセンスについて教えてください。テスト環境と本番環境で別途購入が必要ですか?

本プラグインのライセンスは LGPL-3.0 です。
オーナーズストアの登録サイト(認証キー)は、基本的に構築されたサイト一つにつき一つ発行してください。テスト環境と本番環境は同一サイトとして扱いますので、1つのご購入でテスト環境・本番環境の両方でご利用いただけます。

Q. EC-CUBE 2系のバックアップファイルの形式に指定はありますか?

2系の標準バックアップ機能で取得した .tar.gz ファイルをそのままアップロードしてください。
.tar に展開する必要はありません。プラグインが .tar.gz 形式を直接読み込みます。

Q. 移行後にログインできなくなりました。

データ移行により、管理者の認証情報も旧環境のものに置き換わります。
EC-CUBE 4.3 の .env ファイルにある ECCUBE_AUTH_MAGIC の値を、旧環境(2系)の AUTH_MAGIC 値に書き換えてから、旧環境のID・パスワードでログインしてください。

Q. アップロード時にエラーが出ます / 何も動きません。

バックアップファイルがデフォルトの上限(10MB)を超えている可能性があります。
EC-CUBE の .htaccess にある post_max_size / upload_max_filesize の値を引き上げてください。
また、php.ini の memory_limit も十分な値(512MB〜1024MB程度)に設定してください。

Q. カスタマイズしている環境からでも移行できますか?

本プラグインは標準テーブルのデータのみを対象としています。
独自カスタマイズで追加したテーブルや、対応していないプラグインのデータ(レビュー、新着情報、メーカー等)は移行されません。
カスタマイズが多い場合は、プラグインでの移行後に手動での追加対応が必要になる場合があります。

Q. 標準のバックアップ機能が使えない場合はどうすればよいですか?

phpMyAdminで代用が可能です。phpMyAdminからのエクスポートデータでもインポートすることは可能ですが、自己責任でお願いします。