🌐 言語: 🇻🇳 Tiếng Việt · 🇬🇧 English · 🇯🇵 日本語(現在)
composer create-project gp247/s-cart my-shop
GP247 と Laravel で構築された無料のオープンソース EC ソフトウェア
🏠 ホーム · 🚀 デモ · 📚 ドキュメント · 🤖 AI エージェント用スキル · 💬 Facebook グループ

概要
S-Cart は、ストアオーナー、企業、開発者のための無料・オープンソース(MIT ライセンス)のネットショップ構築ソフトウェアです。インストールするだけで、商品、カート、注文、顧客、コンテンツページを備えた完成済みのオンラインストアと管理画面がすぐに使えます。S-Cart はすべて無料で利用・改変でき、自社システムにも組み込めます。Pro プラグインは、複数ストアや複数の販売者が出店するマーケットプレイスなど、ストアを拡張したいときの任意の追加機能です。
S-Cart は 4 つの原則に基づいて作られています:
| 原則 | 得られること |
|---|---|
| 🎯 販売者の実務に応える | SEO、バックアップと復元、権限管理、レポートがインストール直後から使え、プラグインは不要です。インストールもアップデートも数個のコマンドで完了します。 |
| 🌍 さまざまな環境で動く | cron のない共有ホスティングから VPS、Docker まで。 |
| 🔐 安全 | 管理画面、API、AI エージェントに共通の権限管理と操作ログ。パスワードや外部サービスのキーは暗号化して保存されます。 |
| 🧩 カスタマイズしやすい | プラグインとテンプレートで拡張でき、元のコードに手を加えずに画面や処理をオーバーライドできます — アップデートしても編集した内容は失われません。 |
このページを読み終えると、S-Cart を手元のパソコンやサーバーにインストールし、アップデートやカスタマイズの方法がわかるようになります。
S-Cart 3.x の技術スタック: PHP ≥ 8.3 · Laravel 13 · GP247 · Tailwind CSS 3 · MySQL / MariaDB
S-Cart と GP247
S-Cart = GP247/core + GP247/front + GP247/shop + GP247/mcp
GP247 は、業務向け Web アプリケーションを構築するための Laravel ベースのオープンソース・エコシステムです。S-Cart はその上に構築された EC 製品で、4 つのパッケージで構成されています:
| パッケージ | 役割 |
|---|---|
gp247/core |
コア:管理画面、権限管理、設定、プラグインとテンプレート |
gp247/front |
ストアフロント、コンテンツ(CMS) |
gp247/shop |
商品、カート、注文、顧客 |
gp247/mcp |
AI エージェント向けの MCP サーバー |
インストールするのは S-Cart だけです — 4 つのパッケージはすべて一緒に入り、GP247 を別途インストールする必要はありません。
✨ S-Cart の機能
| 分類 | 機能 |
|---|---|
| 🛍️ 販売 | 商品、カート、注文、顧客 |
| 🌏 多国対応 | 多言語、多通貨 |
| 📰 コンテンツ(CMS) | カテゴリー、コンテンツページ、ニュース(無料の News プラグイン) |
| 💳 決済と配送 | 決済プラグイン、配送方法、クーポンコード、税計算 |
| 🔐 管理とセキュリティ | ロールによる権限管理(管理者、マネージャー、マーケティング…)、操作ログ、CAPTCHA |
| 📊 ビジネスツール | 注文処理、顧客管理、統計とレポート |
| 🤖 AI 対応(MCP サーバー) | 組み込みの MCP サーバー(有効にするまでオフ):AI エージェント(Claude、Cursor、VS Code…)を Model Context Protocol 標準でストアに接続し、自然な言葉で質問できます —「今週の売上はいくら?」「在庫切れが近い商品は?」「注文 OR-1024 は支払い済み?」。エージェントは 1 つの管理者アカウントの代理として、そのアカウントと同じ権限で動作し、トークンで認証され、顧客情報はマスクされ、すべての呼び出しがログに記録されます |
| 🧩 拡張性 | HMVC モデルのプラグイン、オンラインのプラグイン/テンプレートマーケットプレイス、モバイルアプリ向けのセキュアな API |
| ⭐ Pro プラグイン | Multi-vendor(複数の販売者が出店するマーケットプレイス)· Multi-store(複数ストア)· 入出金管理(仕入れ、返品、入出金と債権債務) |
🧰 システム要件
| 項目 | 要件 |
|---|---|
| PHP | 8.3 以上 |
| Composer | 2.x 系 |
| データベース | MySQL または MariaDB — 空のデータベースを事前に作成してください |
| 書き込み権限が必要なディレクトリ | storage · bootstrap/cache · app/GP247 · public/GP247 · public/vendor · resources/views/vendor · vendor |
💡 Docker を使う場合、パソコンに PHP、Composer、MySQL をインストールする必要はありません — 方法 3 をご覧ください。
🚀 インストール
📘 インストールの詳しいガイド — インストール構成の選び方(S-Cart、GP247 CMS、core のみ)、コマンドラインのないホスティング、既存サイトへの front/shop 追加、トラブルシューティング:GP247 と S-Cart のインストール。
次の 3 つの方法からいずれか 1 つを選んでください:
| 方法 | 適しているケース |
|---|---|
| 1. Composer ⭐ | レンタルサーバー、VPS、または Laragon/XAMPP を使っているパソコンにインストールする場合 — 推奨 |
| 2. Git clone | 開発やコントリビュートのために GitHub から最新のソースコードを取得したい場合 |
| 3. Docker | パソコンに PHP/MySQL をインストールしたくない場合 |
方法 1 — Composer(推奨)
-
ターミナル(Windows では「コマンドプロンプト」または Laragon のターミナル)を開き、Composer がどの PHP で動いているかを確認します:
composer diagnosePHP versionの行が 8.3 以上である必要があります。⚠️ PHP が 8.3 より古い場合、Composer はエラーを出さず、非常に古い S-Cart 1.x を黙ってインストールしてしまいます。手順 2 に進む前に、Composer を PHP 8.3 以上に切り替えてください。
-
プロジェクトを作成します(
my-shopは任意のディレクトリ名に置き換えてください):composer create-project gp247/s-cart my-shop cd my-shop -
プロジェクトディレクトリ内の
.envファイルを開き、作成したデータベースに合わせてデータベースの項目を編集します:DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=your_database DB_USERNAME=your_username DB_PASSWORD=your_passwordデフォルト値の
DB_HOST=mysql-localは Docker 専用です — 直接インストールする場合は127.0.0.1に変更してください。 -
S-Cart を初期化します:
php artisan gp247:install確認を求められたら
yesと入力します。インストールが完了すると、画面の最後のブロックに管理画面の URL、ユーザー名admin、ランダムなパスワードが表示されます。⚠️ パスワードはインストール成功の直後に一度だけ表示されます — どこにも保存されず、再表示もされません。ターミナルを 閉じる前にパスワードマネージャーへ保存してください。
-
(任意) 試しに見てみるためのサンプルデータを追加します:
php artisan gp247:shop-sample -
ブラウザを開きます:
ページ アドレス ログイン ストア http://your-domain— 管理画面 http://your-domain/gp247_adminadmin/ 手順 4 で表示されたパスワード🔑 ログインしたら、アカウントのメールを実際のアドレスに変更してください(右上の「アカウント設定」)。「パスワードをお忘れの方」が使えるようになります。
方法 2 — Git clone
git clone https://github.com/gp247net/s-cart.git
cd s-cart
cp .env.example .env
composer install
その後、方法 1 の手順 3 → 6 を続けて行います(.env の編集、gp247:install の実行、ブラウザで開く)。
方法 3 — Docker
別々の 2 つの設定ファイルがあります — 必ず環境に合ったファイルを使ってください:
| ファイル | 環境 |
|---|---|
docker-compose.yml |
dev — 個人のパソコン |
docker-compose.prod.yml |
prod — 本番サーバー |
個人のパソコン(dev):
git clone https://github.com/gp247net/s-cart.git
cd s-cart
cp .env.example .env
docker compose up -d --build
docker compose exec app php artisan key:generate
docker compose exec app php artisan gp247:install
docker compose exec app php artisan gp247:shop-sample # 任意
http://localhost:8000 でサイトを開きます。
本番サーバー(prod):
git clone https://github.com/gp247net/s-cart.git
cd s-cart
cp .env.example .env
# .env を編集:APP_ENV=production, APP_DEBUG=false, DB_*, SC_DOCKER_WWWUSER/SC_DOCKER_WWWGROUP — DOCKER.md を参照
docker compose -f docker-compose.prod.yml up -d --build
docker compose -f docker-compose.prod.yml exec app php artisan key:generate
docker compose -f docker-compose.prod.yml exec app php artisan gp247:install
docker compose -f docker-compose.prod.yml run --rm node # build CSS/JS
⚠️ 本番環境では必ず
-f docker-compose.prod.ymlを付けてください。付け忘れると dev 用の設定で動いてしまいます(デバッグ有効、root 権限で実行、Xdebug がインストールされる…)。
📘 手順ごとのガイドと Docker のトラブルシューティング:DOCKER.md。
🔄 バージョンアップデート
📘 詳しいガイド:GP247 と S-Cart の更新 · 2.x 系のサイト:3.x 系へのアップグレード。
-
アップデートの前に、データベースと
app/GP247、public/GP247ディレクトリをバックアップしてください。 -
新しいソースコードを取得します:
composer update gp247/core gp247/front gp247/shop gp247/mcpS-Cart 3.5 より前にインストールしたサイト(MCP サーバーがまだない場合):
composer require gp247/mcp -Wを 1 回だけ実行します。 -
変更をサイトに反映します(安全です:データは削除されず、編集済みの翻訳やテンプレートも上書きされません):
php artisan gp247:update -
結果を確認します:
php artisan gp247:info
⚠️
composer updateを実行するだけでは不十分です — 必ず手順 3 も実行してください。
高度なオプション(--overwrite-lang による翻訳の上書き、--publish=… によるアセット/ビューの更新)は、あなたのカスタマイズを上書きする可能性があります — 使用する前に GP247 と S-Cart の更新 — 上級者向けオプション をよくお読みください。
🎨 カスタマイズと拡張
| やりたいこと | 方法 |
|---|---|
| 新しいプラグインを作成する | php artisan gp247:make-plugin --name=PluginName |
| 新しいテンプレートを作成する | php artisan gp247:make-template --name=TemplateName |
| 配布用の zip ファイルにパッケージ化する | 上記 2 つのコマンドに --download=1 を追加 |
| デフォルトテンプレートの画面を 1 つだけ 編集する | php artisan gp247:template-publish GP247Front --file=screen/home.blade.php を実行し、app/GP247/Templates/GP247Front/ のファイルを編集 |
| 管理画面の UI を編集する | php artisan vendor:publish --tag=gp247:core-view(core)· --tag=gp247:front-admin(front)· --tag=gp247:shop-view-admin(shop) |
| ファイルアップロード設定(lfm)を変更する | php artisan vendor:publish --tag=config-lfm |
ヘルパー関数 gp247_* をオーバーライドする |
config/gp247_functions_except.php に関数名を宣言し、app/GP247/Helpers/*.php に新しい関数を記述 |
| コントローラーをオーバーライドする | 下記 を参照 |
| 管理画面にルートを追加する | 定数 GP247_ADMIN_PREFIX と GP247_ADMIN_MIDDLEWARE を使用 — core の routes.php を参照 |
💡 デフォルトテンプレート
GP247Frontはパッケージから直接読み込まれるため、publish していないファイルはアップデート時に自動で新しいバージョンになります。編集が必要なファイルだけを publish してください。
コントローラーのオーバーライド
GP247/Core、GP247/Front、GP247/Shop のすべてのコントローラー(API を含む)に適用できます:
-
app/GP247/{Core|Front|Shop}/...に、同じサブパスと同じ名前のファイルを作成します。 -
新しいクラスを、
vendor/gp247/...にある元のコントローラーからextendsさせます。 -
元の名前空間の先頭に
App\を追加し、残りはそのままにします:元の名前空間 新しい名前空間 GP247\Core\ControllersApp\GP247\Core\ControllersGP247\Core\Api\ControllersApp\GP247\Core\Api\ControllersGP247\Front\.../GP247\Shop\...App\GP247\Front\.../App\GP247\Shop\...
📘 詳細ドキュメント:プラグインの作成 · テンプレートの作成 · CLI コマンド一覧
📂 ディレクトリ構成
(+) = GP247 が作成・管理するディレクトリ。
my-shop/
├── app/GP247/
│ ├── Core(+) ← Core のコントローラーのオーバーライド
│ ├── Front(+) ← Front のコントローラーのオーバーライド
│ ├── Shop(+) ← Shop のコントローラーのオーバーライド
│ ├── Helpers(+) ← ここにある *.php ファイルは自動で読み込まれる
│ ├── Plugins(+) ← プラグイン(gp247:make-plugin)
│ └── Templates(+) ← テンプレート(gp247:make-template)+ 編集用に publish したテンプレートファイル
├── public/GP247/
│ ├── Core(+) ← 管理画面の CSS/JS
│ ├── Plugins(+)
│ └── Templates(+)
├── resources/views/vendor/
│ ├── gp247-admin(+) ← publish 済みの Core 管理画面ビュー
│ ├── gp247-front-admin(+) ← publish 済みの Front 管理画面ビュー
│ └── gp247-shop-admin(+) ← publish 済みの Shop 管理画面ビュー
└── vendor/gp247/
├── core ← コア:管理画面、権限管理、設定
├── front ← ストアフロント、CMS
├── shop ← 商品、カート、注文
└── mcp ← AI エージェント向けの MCP サーバー
🔧 よく使う環境変数
.env ファイルで設定します:
| 変数 | デフォルト | 意味 |
|---|---|---|
GP247_ADMIN_PREFIX |
gp247_admin |
管理画面のパス。例:your-domain.com/gp247_admin |
GP247_API_MODE |
1 |
API を有効(1)/無効(0)にする |
GP247_DB_PREFIX |
gp247_ |
テーブル名のプレフィックス — ⚠️ インストール後は変更できません |
GP247_ADMIN_LOG |
1 |
管理画面へのアクセスログを記録する |
GP247_SEO_LANG |
0 |
ストアの URL に言語コードを付ける(/vi/...、/en/...) |
GP247_ENCRYPTION_KEY |
(空) | SMTP パスワードやライセンスなどを暗号化するための専用キー — .env.example の注記を参照 |