EC-CUBE /ec-cube
EC-CUBE is the most popular e-commerce solution in Japan
★ 792⑂ 713👁 83⑃ 4,920● 2,281▤ 99
+0
日增长
792
stars
713
forks
83
watchers
4,920
prs
2,281
issues
99
releases
README
EC-CUBE 4.4
4.4のリリース内容・計画はロードマップをご確認ください。
+ 本ドキュメントはEC-CUBEの開発者を主要な対象者としております。
+ パッケージ版はEC-CUBEオフィシャルサイトで配布しています。
+ カスタマイズやEC-CUBEの利用、仕様に関しては開発コミュニティをご利用ください。
+ 本体開発にあたって不明点などあればIssueをご利用下さい。
+ EC-CUBE 3系の保守については、 EC-CUBE/ec-cube3にて開発を行っております。
+ EC-CUBE 2系の保守については、 EC-CUBE/ec-cube2にて開発を行っております。
インストール
EC-CUBE 4.4のインストール方法
開発ドキュメントの インストール方法 の手順に従ってインストールしてください。
CSS の編集・ビルド方法
Sass を使用して記述されています。
Sass のソースコードは html/template/{admin,default}/assets/scss にあります。
前提として [https://nodejs.org/ja/] より、 Node.js をインストールしておいてください。
以下のコマンドでビルドすることで、 html/template//assets/css に CSS ファイルが出力されます。
shell
npm ci 初回およびpackage-lock.jsonに変更があったとき
npm run build Sass のビルド
docker compose を使用している場合は以下のコマンドを実行してください
shell
初回および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 のライブラリは esbuild でバンドル/minifyされます。
バンドルするライブラリを変更する場合は、テンプレートごとに以下の bundle.js を修正し、リビルドしてください。
- html/template/admin/assets/js/bundle.js
- html/template/default/assets/js/bundle.js
- html/template/install/assets/js/bundle.js
shell
npm ci 初回およびpackage-lock.jsonに変更があったとき
npm run build Sass 及び JavaScript のビルド
ファイルの変更を監視して差分ビルドする場合は以下を実行してください。
shell
npm start
docker compose を使用している場合は以下のコマンドを実行してください
shell
初回および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 及び JavaScript のビルド
docker compose -f docker-compose.yml -f docker-compose.dev.yml -f docker-compose.nodejs.yml run --rm -T nodejs npm run build
動作確認環境
Apache 2.4.x (mod_rewrite / mod_ssl 必須)
PHP 8.2.x / 8.3.x / 8.4.x / 8.5.x
PostgreSQL 13.x 〜 18.x / MySQL 8.4.x (LTS)
ブラウザー: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.4の不具合の修正、機能のブラッシュアップを目的として、継続的に開発を行っております。
コードのリファクタリング、不具合修正以外のPullRequestを送る際は、Pull Requestのコメントなどに意図を明確に記載してください。
開発環境の構築・ブランチ運用(PR の宛先は 4.4)・PR を出す前に通すべき CI チェック(コードスタイル / 静的解析 / Rector / テスト)・ライセンスヘッダなど、コントリビューションの具体的な手順は CONTRIBUTING.md を参照してください。レイヤ別の実装規約は AGENTS.md に集約しています。
Pull Requestの送信前に、Issueにて提議いただく事も可能です。
Issuesの利用方法については、こちらをご確認ください。
Slackでも本体の開発に関する意見交換などを行っております。
コピーライトポリシーへの同意
コードの提供・追加、修正・変更その他「EC-CUBE」への開発の御協力(Issue投稿、Pull Request投稿など、GitHub上での活動)を行っていただく場合には、
EC-CUBEのコピーライトポリシーをご理解いただき、ご了承いただく必要がございます。
Issueの投稿やPull Requestを送信する際は、EC-CUBEのコピーライトポリシーに同意したものとみなします。
English
What is EC-CUBE?
EC-CUBE is Japan's leading open-source e-commerce platform, powering over 35,000 online stores. It provides a full-featured, highly customizable solutiTop issues
#4595【週刊】取り込んだプルリクエスト56 comments · 2020-06-26#4142プラグインのインストールに失敗する問題22 comments · 2019-04-19#4447Web API仕様19 comments · 2020-01-22#5696インストールし直したのに、プラグインが有効なまま12 comments · 2022-08-29#4554MySQL5.5/5.6 利用時に EA10PluginCest test_install_error の E2E テストが落ちる12 comments · 2020-06-05#4831キャッシュの手動生成機能11 comments · 2021-01-08#2569商品一覧・詳細ページのURLをスラッグ化10 comments · 2017-10-16#4811docker-composeのインストールは失敗する9 comments · 2020-12-19
Discussions
#7288How to find cheap flights under $100?0 comments · 2026-11-13#7287EC-CUBE 4系のバージョンアップ時の影響範囲の把握方法・注意点について、知見を共有いただけませんか1 comments · 2026-11-12#72862027年4月消費税減税 EC-CUBE対応方法まとめ (2系/3系/4系)0 comments · 2026-11-11#7285【初めての方へ】EC-CUBE開発コミュニティ(GitHub Discussions)の使い方ガイド1 comments · 2026-11-11#7284開発コミュニティの GitHub discussion への移行につきまして0 comments · 2026-11-11
Latest release
4.3.1-p1 4.3.1-p1 2026-03-04EC-CUBE 4.3.1-p1 Released! EC-CUBE 4.3.1-p1をリリースいたしました。 What's Changed 脆弱性対応 [4.3.1] バージョン更新 by @dotani1111 in https://github.com/EC-CUBE/ec-cube/pull/6649 Full Changelog: https://github.com/EC-CUBE/ec-cube/compare/4.3.1...4.3.1-p1 参考情報 :orange_book: - 脆弱性の詳細について - 開発ドキュメント