0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

EC-CUBEバージョンアップ-エラー少なめの方法

0
Last updated at Posted at 2026-11-03

EC-CUBE、PHP、各バージョンの互換性を確認

現行バージョンを確認

EC-CUBE
PHP
MySQL

目標バージョンを設定

EC-CUBE
PHP
MySQL

格納サーバーで対応しているか確認

PHP
MySQL

目標バージョンを決定

EC-CUBE
PHP
MySQL

プラグイン適合

現行プラグインが目標EC-CUBEバージョンに適合しているか確認
不適合なら目標EC-CUBEバージョンに適合しているプラグインがあるか調査
現行プラグインの設定情報を保存

メンテナンスモード

管理画面よりメンテナンスモードを有効
フロントで確認

バックアップ

ファイルバックアップ

コントロールパネルからバックアップ
/home/アカウント名/www/EC-CUBEルート という構造の場合

cd /home/アカウント名/www(EC-CUBEルート直属ディレクトリ)
tar -cvf www.tar EC-CUBEルート名

/home/アカウント名/www/www.tar が作成される
FTPダウンロード
ローカルで解凍

データベースバックアップ

PhpMyAdminでバックアップ

プラグインバックアップ

データベースプラグインテーブルを個別バックアップ

プラグインクリア

プラグイン無効化
プラグインアンインストール

「開発者向けドキュメントサイト」で流れを確認

https://doc4.ec-cube.net/update423_43x
以下の違いに注意
バージョン内での本体バージョンアップ
バージョン移行の本体バージョンアップ

カスタマイズしたファイルを確認

商品画像
.htaccess
app/config/eccube/services.yaml
app/Customize/
app/template/
html/upload/save_image/***.jpg
html/user_data/
html/template/

ソースファイルダウンロード

https://github.com/EC-CUBE/ec-cube/releases/
目標バージョンのソースファイルZipをダウンロード
解凍

ファイル総入れ替え

ルート以下ファイルを全削除

rm -r ルート/*

sudo chmod 777 /var/www/ルート

新バージョンソースeccube-x.x.x.tar.gzをアップロード

cd /var/www/ルート
tar -xvf eccube-x.x.x.tar.gz
mv ec-cube 新ルート名

さくらレンタルサーバーはtarに対応していないのでFTPアップロード

旧主要データを復元

.env
html/upload/

コマンド実行

パーミッションを一時的にオープン

cd /var/www/
chmod 777 ルート
cd /var/www/ルート
chmod -R 777 app
chmod -R 777 html
chmod -R 777 var
chmod -R 777 vendor
chmod 777 composer.json
chmod 777 composer.lock
```-R 777 var html app/Plugin app/PluginData app/proxy app/template

プロキシファイルを再生成

php bin/console eccube:generate:proxies

キャッシュファイルの再生成

php bin/console cache:warmup --env=prod

スキーマ更新

php bin/console doctrine:schema:update --dump-sql 

php bin/console doctrine:schema:update --force

キャッシュ削除

rm -rf var/cache/*
php bin/console cache:clear --no-warmup
php bin/console cache:warmup --env=prod    

セッションの削除

rm -rf var/sessions

ブラウザ管理画面を確認

プレーンファイルと旧データベースのEC-CUBEにアクセスできればOK

システムエラーなら

ls -lt var/log/prod/ | head
tail -n 50 var/log/prod/prod-$(date +%Y-%m-%d).log

よりログ確認

旧カスタムデータを復元

アップロード復元

app/Customize/

インストールファイル src/Eccube/対象ファイルをapp/Customizeへアップロード
コード書き換え

キャッシュ削除とプロキシ再生成

rm -rf var/cache/*
php bin/console cache:clear --no-warmup
php bin/console eccube:generate:proxies
php bin/console cache:warmup --env=prod

アップロード復元

app/template/

インストールファイル src/Eccube/Resource/template/default/対象ファイルをapp/template/default/へアップロード
コード書き換え

キャッシュ削除とプロキシ再生成

rm -rf var/cache/*
php bin/console cache:clear --no-warmup
php bin/console eccube:generate:proxies
php bin/console cache:warmup --env=prod

アップロード復元

app/config/eccube/services.yaml

キャッシュ削除とプロキシ再生成

rm -rf var/cache/*
php bin/console cache:clear --no-warmup
php bin/console eccube:generate:proxies
php bin/console cache:warmup --env=prod

html/user_data/
html/template/
.htaccess(ルート/html/) 独自に追記している場合のみ。

ブラウザ管理画面を確認

システムエラーなら

ls -lt var/log/prod/ | head
tail -n 50 var/log/prod/prod-$(date +%Y-%m-%d).log

よりログ確認

プラグイン復旧

プラグインインストール 設定 有効化

?同じバージョンのプラグインを再インストールする場合は、事前にテーブルを削除?

旧Appデータを復元

app/PluginData/

?同じバージョンのプラグインを再インストールする場合は、旧テーブルを復元?
initialized 初回インストール処理
• 0(未初期化)
• 1(初期化済み)
enwbled 有効化
• 0(無効)
• 1(有効)

パーミッション設定

サイト稼働確認

フロントページ遷移
購入テスト
マイページ機能
管理画面の各機能

バックアップ

ファイルバックアップ

コントロールパネルからバックアップ
FTPでファイルを直ダウンロード

データベースバックアップ

PhpMyAdminでバックアップ

PHPバージョンアップ

同一サーバーにインストールされているすべてのサイトへの影響を確認
コントロールパネルからバージョンアップ
WordPress・EC-CUBE管理画面からPHPバージョンを確認

MySQLバージョンアップ

同一サーバーにインストールされているすべてのサイトへの影響を確認
すべてのデータベースをバックアップ
すべてのサイトの管理ページをダウンロード
(WordPress:wp-config.php, EC-CUBE:.env)
コントロールパネルからバージョンアップ
管理ページのデータベース名を書き換え
WordPress・EC-CUBE管理画面からMySQLバージョンを確認

メンテナンスモード無効

バージョンアップ確認

管理画面 > システム

フロント確認

正常動作を確認

つまずきポイント

スキーマ更新でエラー

bin/console doctrine:schema:update --force --dump-sql

 CRITICAL  [console] Error thrown while running command "'doctrine:schema:update' --force --dump-sql". Message: "An exception occurred while executing a query: SQLSTATE[23000]: Integrity constraint violation: 1452 Cannot add or update a child row: a foreign key constraint fails (`my-system_pw2023`.`#sql-41e_bfb6cb9e`, CONSTRAINT `FK_6C38C0F89395C3F3` FOREIGN KEY (`customer_id`) REFERENCES `dtb_customer` (`id`))" ["exception" => Doctrine\DBAL\Exception\ForeignKeyConstraintViolationException^ { …},"command" => "'doctrine:schema:update' --force --dump-sql","message" => "An exception occurred while executing a query: SQLSTATE[23000]: Integrity constraint violation: 1452 Cannot add or update a child row: a foreign key constraint fails (`my-system_pw2023`.`#sql-41e_bfb6cb9e`, CONSTRAINT `FK_6C38C0F89395C3F3` FOREIGN KEY (`customer_id`) REFERENCES `dtb_customer` (`id`))"] ["file" => "/home/my-system/www/pw_poster/shelter/vendor/symfony/console/EventListener/ErrorListener.php","line" => 48,"class" => "Symfony\Component\Console\EventListener\ErrorListener","callType" => "->","function" => "onConsoleError","uid" => "155a692","user_id" => "N/A","session_id" => "N/A"]

In ExceptionConverter.php line 56:

  An exception occurred while executing a query: SQLSTATE[23000]: Integrity constraint violation: 1452 Cannot add or
  update a child row: a foreign key constraint fails (`my-system_pw2023`.`#sql-41e_bfb6cb9e`, CONSTRAINT `FK_6C38C0F8
  9395C3F3` FOREIGN KEY (`customer_id`) REFERENCES `dtb_customer` (`id`))


In Exception.php line 28:

  SQLSTATE[23000]: Integrity constraint violation: 1452 Cannot add or update a child row: a foreign key constraint fa
  ils (`my-system_pw2023`.`#sql-41e_bfb6cb9e`, CONSTRAINT `FK_6C38C0F89395C3F3` FOREIGN KEY (`customer_id`) REFERENCE
  S `dtb_customer` (`id`))


In Connection.php line 69:

  SQLSTATE[23000]: Integrity constraint violation: 1452 Cannot add or update a child row: a foreign key constraint fa
  ils (`my-system_pw2023`.`#sql-41e_bfb6cb9e`, CONSTRAINT `FK_6C38C0F89395C3F3` FOREIGN KEY (`customer_id`) REFERENCE
  S `dtb_customer` (`id`))

データベース内のどこかのテーブルにあるcustomer_idの外部キーがテーブルdtb_customerを参照したが、そこのidに同じ値がない

PhpMyAdminでSQLコマンド

SELECT COUNT(*) FROM dtb_customer_address
WHERE customer_id IS NOT NULL
  AND customer_id NOT IN (SELECT id FROM dtb_customer);

-- 中身も確認
SELECT * FROM dtb_customer_address
WHERE customer_id IS NOT NULL
  AND customer_id NOT IN (SELECT id FROM dtb_customer);

問題の値を修正

autoloadファイルの再生成でエラー

composer dump-autoload
-bash: composer: command not found

rootにcomposer.pharがある場合

ls composer.phar
which -a composer composer.phar
ls ~/composer* /usr/local/bin/composer* 2>/dev/null

rootにcomposer.pharがない場合、生成する

cd /home/my-system/www/pw_poster/shelter
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"

参考記事

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?