ec-cube/eccube-update-plugin

EC-CUBE 4.3

4.1からの更新内容はリリースノートをご確認ください。

• 本ドキュメントはEC-CUBEの開発者を主要な対象者としております。
• パッケージ版はEC-CUBEオフィシャルサイトで配布しています。
• カスタマイズやEC-CUBEの利用、仕様に関しては開発コミュニティをご利用ください。
• 本体開発にあたって不明点などあればIssueをご利用下さい。
• EC-CUBE 3系の保守については、 EC-CUBE/ec-cube3にて開発を行っております。
• EC-CUBE 2系の保守については、 EC-CUBE/ec-cube2にて開発を行っております。

インストール

EC-CUBE 4.2のインストール方法

開発ドキュメントの インストール方法 の手順に従ってインストールしてください。

CSS の編集・ビルド方法

Sass を使用して記述されています。 Sass のソースコードは html/template/{admin,default}/assets/scss にあります。 前提として [https://nodejs.org/ja/] より、 Node.js をインストールしておいてください。

以下のコマンドでビルドすることで、 html/template/**/assets/css に CSS ファイルが出力されます。

npm ci # 初回およびpackage-lock.jsonに変更があったとき
npm run build # Sass のビルド

docker compose を使用している場合は以下のコマンドを実行してください

# 初回およびpackage-lock.jsonに変更があったとき
docker compose -f docker-compose.yml -f docker-compose.dev.yml -f docker-compose.nodejs.yml run --rm -T nodejs npm ci
# Sass のビルド
docker compose -f docker-compose.yml -f docker-compose.dev.yml -f docker-compose.nodejs.yml run --rm -T nodejs npm run build

JavaScript のビルド方法

フロントエンドで使用する JavaScript のライブラリは npm で管理されています。 JavaScript のライブラリは webpack でバンドル/minifyされます。 バンドルするライブラリを変更する場合は、テンプレートごとに以下の bundle.js を修正し、リビルドしてください。

• html/template/admin/assets/js/bundle.js
• html/template/default/assets/js/bundle.js
• html/template/install/assets/js/bundle.js

npm ci # 初回およびpackage-lock.jsonに変更があったとき
npm run build # Sass 及び JavaScript のビルド

JavaScript ライブラリのみをビルドしたい場合は以下でも可能です。

npx webpack

docker compose を使用している場合は以下のコマンドを実行してください

# 初回およびpackage-lock.jsonに変更があったとき
docker compose -f docker-compose.yml -f docker-compose.dev.yml -f docker-compose.nodejs.yml run --rm -T nodejs npm ci
# Sass のビルド
docker compose -f docker-compose.yml -f docker-compose.dev.yml -f docker-compose.nodejs.yml run --rm -T nodejs npm run build
# JavaScript ライブラリのみのビルド
docker compose -f docker-compose.yml -f docker-compose.dev.yml -f docker-compose.nodejs.yml run --rm -T nodejs npx webpack

動作確認環境

• Apache 2.4.x (mod_rewrite / mod_ssl 必須)
• PHP 7.4.x / 8.0.x / 8.1.x
• PostgreSQL 10.x or higher / MySQL 5.7.x or 8.0.x
• ブラウザー：Google Chrome

詳しくは開発ドキュメントの システム要件 をご確認ください。

ドキュメント

EC-CUBE 4.x 開発ドキュメント@doc4.ec-cube.net

EC-CUBE 4.x 系の仕様や手順、開発Tipsに関するドキュメントを掲載しています。 修正や追記、新規ドキュメントの作成をいただく場合、以下のレポジトリからPullRequestをお送りください。 https://github.com/EC-CUBE/doc4.ec-cube.net

開発への参加

EC-CUBE 4.2の不具合の修正、機能のブラッシュアップを目的として、継続的に開発を行っております。
コードのリファクタリング、不具合修正以外のPullRequestを送る際は、Pull Requestのコメントなどに意図を明確に記載してください。

Pull Requestの送信前に、Issueにて提議いただく事も可能です。 Issuesの利用方法については、こちらをご確認ください。

Slackでも本体の開発に関する意見交換などを行っております。

コピーライトポリシーへの同意

コードの提供・追加、修正・変更その他「EC-CUBE」への開発の御協力（Issue投稿、Pull Request投稿など、GitHub上での活動）を行っていただく場合には、 EC-CUBEのコピーライトポリシーをご理解いただき、ご了承いただく必要がございます。 Issueの投稿やPull Requestを送信する際は、EC-CUBEのコピーライトポリシーに同意したものとみなします。

eccube-update-plugin's Issues

アップデートプラグインの試験についてのメモ

テスト環境

EC-CUBE：パッケージ版を利用。gitからのcloneは利用しない。
DB：PostgreSQL、MySQLの2種で確認。SQLiteは実施不要。
Webサーバ：任意で可。PHPビルトインサーバでも問題ない。

テスト内容

• プラグインのインストール・アンインストール・有効・無効
• アップデートを実行し正常終了することを確認する
• システム情報からバージョン番号を確認する
• 会員・商品・受注の機能をフロント・管理画面ともに操作し、エラー等発生しないことを確認する
• プラグインのインストール・アンインストールが正常に行えることを確認する
• 新規追加された機能を操作し、エラー等発生しないことを確認する

EC-CUBEアップデートプラグイン(4.0.4〜4.0.5)でインストールができない

管理画面のプラグイン一覧よりインストール
クリックするとインストールが完了となります。

プラグイン一覧へ戻るとインストールボタンが有効のままとなり
バージョンも4.04のままとなります。
キャッシュクリア等を行っても変化はありませんでした。

何が原因でアップデートが行われないのでしょうか
対応方法をご存じの方がいらっしゃいましたらご教授いただけますでしょうか

下記にインストール完了と出ているダイアログの詳細の内容を添付いたします

**************** EccubeUpdater404to405 ****************
Deprecation warning: require.ec-cube/EccubeUpdater404to405 is invalid, it should not contain uppercase characters. Please use ec-cube/eccubeupdater404to405 instead. Make sure you fix this as Composer 2.0 will error.
[13.3MiB/1.35s] Warning from https://repo.packagist.org: Support for Composer 1 is deprecated and some packages will not be available. You should upgrade to Composer 2. See https://blog.packagist.com/deprecating-composer-1-support/
[206.8MiB/2.68s] Using version ^1.0 for ec-cube/EccubeUpdater404to405
[206.8MiB/2.69s] ./composer.json has been updated
[207.1MiB/2.85s] Deprecation warning: require.ec-cube/EccubeUpdater404to405 is invalid, it should not contain uppercase characters. Please use ec-cube/eccubeupdater404to405 instead. Make sure you fix this as Composer 2.0 will error.
[210.9MiB/3.26s] Dependency "ec-cube/plugin-installer" is also a root requirement, but is not explicitly whitelisted. Ignoring.
[210.7MiB/3.26s] Loading composer repositories with package information
[212.1MiB/4.59s] Warning from https://repo.packagist.org: Support for Composer 1 is deprecated and some packages will not be available. You should upgrade to Composer 2. See https://blog.packagist.com/deprecating-composer-1-support/
[212.2MiB/4.65s] Updating dependencies (including require-dev)
[678.6MiB/62.01s] Nothing to install or update
[675.8MiB/62.15s] Package doctrine/doctrine-cache-bundle is abandoned, you should avoid using it. No replacement was suggested.
[675.8MiB/62.15s] Package doctrine/reflection is abandoned, you should avoid using it. Use roave/better-reflection instead.
[675.8MiB/62.15s] Package easycorp/easy-log-handler is abandoned, you should avoid using it. No replacement was suggested.
[675.8MiB/62.15s] Package facebook/webdriver is abandoned, you should avoid using it. Use php-webdriver/webdriver instead.
[675.8MiB/62.15s] Package fzaninotto/faker is abandoned, you should avoid using it. No replacement was suggested.
[675.8MiB/62.15s] Package phpunit/php-token-stream is abandoned, you should avoid using it. No replacement was suggested.
[675.8MiB/62.15s] Package phpunit/phpunit-mock-objects is abandoned, you should avoid using it. No replacement was suggested.
[675.8MiB/62.15s] Package sensio/generator-bundle is abandoned, you should avoid using it. Use symfony/maker-bundle instead.
[675.8MiB/62.15s] Package setasign/fpdi-tcpdf is abandoned, you should avoid using it. No replacement was suggested.
[675.8MiB/62.15s] Package symfony/inflector is abandoned, you should avoid using it. Use use EnglishInflector from the String component instead instead.
[675.8MiB/62.15s] Package twig/extensions is abandoned, you should avoid using it. No replacement was suggested.
[675.8MiB/62.15s] Package zendframework/zend-code is abandoned, you should avoid using it. Use laminas/laminas-code instead.
[675.8MiB/62.15s] Package zendframework/zend-eventmanager is abandoned, you should avoid using it. Use laminas/laminas-eventmanager instead.
[676.6MiB/62.18s] Generating optimized autoload files
[679.4MiB/77.93s] Warning: Ambiguous class resolution, "Eccube\Entity\Customer" was found in both "$baseDir . '/app/proxy/entity/src/Eccube/Entity/Customer.php" and "/home/gunmadesco/www/shop/src/Eccube/Entity/Customer.php", the first will be used.
[679.4MiB/77.93s] Warning: Ambiguous class resolution, "Eccube\Entity\Product" was found in both "$baseDir . '/app/proxy/entity/src/Eccube/Entity/Product.php" and "/home/gunmadesco/www/shop/src/Eccube/Entity/Product.php", the first will be used.
[679.4MiB/77.93s] Warning: Ambiguous class resolution, "Eccube\Entity\ProductClass" was found in both "$baseDir . '/app/proxy/entity/src/Eccube/Entity/ProductClass.php" and "/home/gunmadesco/www/shop/src/Eccube/Entity/ProductClass.php", the first will be used.

テンプレートにfavicon.icoがない状態でアップデートするとエラーになる

概要(Overview)

テンプレートにfavicon.icoがない状態でプラグイン(EccubeUpdater401to402)を実行するとエラーが発生した。

期待する内容(Expect) or 要望 (Requirement)

ファイルがなくても、エラーが発生ないようにして欲しい。
ちなみに、EccubeUpdater400to401ではエラーは発生しなかった。

環境 (environment)

• EC-CUBE: 4.0.1
• PHP: 7.1.20
• DB: 5.7.25

4.0.2→4.0.3がMySQLでエラーになる

元Issue) EC-CUBE/ec-cube#4463

概要(Overview)

EccubeUpdater402to403を使用するとmysqlでエラーになる

dtb_order_item のtax_adjustは4.03で追加されたカラムが追加されず存在しないというエラーになります。

暫定回避策）
php bin/console eccube:schema:update --force --dump-sql
というコマンドを実行すればカラムが追加されると思います。

期待する内容(Expect) or 要望 (Requirement)

Updatepluginで正しくtax_adjustが追加される

再現手順(Procedure)

環境 (environment)

• EC-CUBE: 4.0.x
• PHP: 7.x.x
• DB:
  • PostgreSQL x.x.x
  • MySQL x.x.x

関連情報 (Ref)

https://xoops.ec-cube.net/modules/newbb/viewtopic.php?topic_id=23352&forum=10&post_id=96327#forumpost96327