ご注意
- 本番環境でバージョンアップを行う前に、テスト環境で事前検証を必ず行ってください。
- この手順では、ec-cube.netからダウンロードしたEC-CUBEのパッケージを利用していることを想定しています。
- EC-CUBE本体のコード(src,htmlディレクトリ)をカスタマイズしている場合、ファイルが上書きされてしまうため、この手順ではバージョンアップできません。各バージョンでの変更差分を確認して必要な差分を取り込んでください。
作業の流れ
- サイトのバックアップ
- 共通ファイル差し替え
- 個別ファイル差し替え
- マイグレーション
- テンプレートファイルの更新
- 不要ファイルの削除
手順詳細
1. サイトのバックアップ
EC-CUBEのインストールディレクトリ以下をすべてバックアップしてください。
2. 共通ファイル差し替え
src html vendorディレクトリを最新のファイルですべて上書きしてください。
[root]
│
├──[src]
├──[html]
├──[vendor]
│
3. 個別ファイル差し替え
対象となるバージョンごとに、個別のファイル差し替えが必要です。
下記から差し替え対象ファイルを確認して最新のファイルで上書きしてください。
| バージョンアップ対象 | 差し替え対象ファイル |
|---|---|
| 3.0.2 → 3.0.3 | なし |
| 3.0.3 → 3.0.4 | なし |
| 3.0.4 → 3.0.5 | autoload.php |
| 3.0.5 → 3.0.6 | なし |
| 3.0.6 → 3.0.7 | なし |
| 3.0.7 → 3.0.8 | なし |
| 3.0.8 → 3.0.9 | app/console cli-config.php composer.json composer.lock eccube_install.sh |
| 3.0.9 → 3.0.10 | autoload.php |
| 3.0.10 → 3.0.11 | autoload.php composer.lock composer.json eccube_install.sh web.config.sample .htaccess.sample |
| 3.0.11 → 3.0.12 | composer.json composer.lock eccube_install.php web.config.sample .htaccess.sample |
| 3.0.12 → 3.0.12-p1 | なし |
| 3.0.12-p1 → 3.0.13 | app/console composer.json composer.lock eccube_install.php |
| 3.0.13 → 3.0.14 | app/console composer.json composer.lock eccube_install.sh |
| 3.0.14 → 3.0.15 | composer.json composer.lock eccube_install.php web.config.sample |
| 3.0.15 → 3.0.16 | composer.json composer.lock |
| 3.0.16 → 3.0.17 | composer.json .htaccess |
| 3.0.17 → 3.0.18 | composer.json composer.lock |
※ 3.0.8 → 3.0.10 のように複数バージョンをまたぐバージョンアップを行う場合は、3.0.8 → 3.0.9→3.0.9 → 3.0.10 のように段階的なバージョンアップを行ってください。
4. マイグレーション
マイグレーション機能を利用して、データベースのバージョンアップを行います。
http://インストール先/install.php/migration
にアクセスするとマイグレーション画面が表示されますので、ページの指示に従ってマイグレーションを行ってください。
5. テンプレートファイルの更新
対象となるバージョンごとに、テンプレートファイル(twig)の更新が必要です。
管理画面のコンテンツ管理から、該当するページ/ブロックを編集してください。
3.0.10 → 3.0.11
twigファイルの更新
| 編集対象 | 変更差分 |
|---|---|
| 商品詳細ページ(Product/detail.twig) | 差分を表示 |
| MYページ/お気に入り一覧(Mypage/favorite.twig) | 差分を表示 |
eccube.jsの置き換え
管理画面>オーナーズストア>テンプレート管理>テンプレート一覧で、「デフォルト」以外のテンプレートを選択している場合はeccube.jsの置き換えが必要です。
html/template/default/js/eccube.jsをコピーして、各テンプレートフォルダのeccube.jsを置き換えてください。
※テンプレートフォルダは、テンプレート一覧の「保存先」の列に表示してあります。 (例) html/template/P3001
3.0.11 → 3.0.12
twigファイルの更新
| 編集対象 | 変更差分 |
|---|---|
| MYページ/ログイン(Mypage/login.twig) | 変更差分を表示 |
| 商品詳細ページ(Product/detail.twig) | 変更差分を表示 |
| 商品購入/お届け先の複数指定(Shopping/shipping_multiple.twig) | 変更差分を表示 |
| 商品購入ログイン(Shopping/login.twig) | 変更差分を表示 |
その他のファイルの置き換え
管理画面>オーナーズストア>テンプレート管理>テンプレート一覧で、「デフォルト」以外のテンプレートを選択している場合は以下のファイルの置き換えが必要です。
| 対象ファイル | 配置先 | 変更差分 |
|---|---|---|
| src/Eccube/Resource/template/default/Form/form_layout.twig | app/template/[テンプレートコード]/Form/form_layout.twig | 変更差分を表示 |
| src/Eccube/Resource/template/default/pagination.twig | app/template/[テンプレートコード]/pagination.twig | 変更差分を表示 |
| html/template/default/css/style.css | html/template/[テンプレートコード]/css/style.css | 変更差分を表示 |
※テンプレートフォルダは、テンプレート一覧の「保存先」の列に表示してあります。 (例) html/template/P3001
6. 不要ファイルの削除
アップデート後は以下のファイルを必ず削除してください。
- html/install.php
- html/index_dev.php (開発用途で使用する場合は残す)
EC-CUBEのバージョンアップ手順は以上です。
7. 税率設定の不具合について
EC-CUBE3.0.12からEC-CUBE3.0.13までのバージョンで、税率設定の課税規則に「切り捨て」「切り上げ」を設定されていた方は、共通税率設定により必ず「四捨五入」または「切り上げ」されるという不具合が発生しています。
こちらの不具合はEC-CUBE3.0.14で修正されています。
影響があるEC-CUBEバージョン
3.0.12、3.0.12-p1、3.0.13
対象者
上記のEC-CUBEのバージョンをお使いの方で、税率設定の課税規則を変更されている方。
不具合発生機能箇所
- 商品購入時、管理画面の受注データ登録・更新時
確認画面以降（メール、受注データも含む）において、価格の（端数）税率計算が全て四捨五入で計算される。
現象内容
課税規則に「切り捨て」、消費税率を8%と設定していた場合、 商品A : 649円 という商品を購入すると701円として購入されてしまう。
例えば、 649 * 1.08 = 700.92円となり切り捨てであれば700円だが、 四捨五入されて701円になる。
商品一覧、商品詳細、カート画面では700円として表示されているが、 購入画面では701円で計算され、購入金額も701円で購入される。
原因
https://github.com/EC-CUBE/ec-cube/issues/2005
対応方法
本体の税率設定と異なる金額の受注明細データを抽出するプラグインが用意されています。
このプラグインは抽出のみ行っていますので、 誤りのある受注データを修正する場合、手動にて修正を行うようにしてください。
バージョンアップが出来ないとき
EC-CUBE3.0.12、EC-CUBE3.0.12-p1、EC-CUBE3.0.13のそれぞれのバッチファイルを用意しています。
解凍後、それぞれお使いのバージョンに合わせて下記の比較内容を元に修正をお願い致します。
-
EC-CUBE3.0.12、EC-CUBE3.0.12-p1
src/Eccube/Controller/Admin/Order/EditController.php
src/Eccube/Service/ShoppingService.php
-
EC-CUBE3.0.13
src/Eccube/Service/ShoppingService.php
各バージョンでの変更差分
バージョンごとの詳細な変更差分は、以下のリンク先で確認することができます。