🌐 言語: 🇻🇳 Tiếng Việt · 🇬🇧 English · 🇯🇵 日本語（現在）

composer create-project gp247/s-cart my-shop "^3.0"

概要

S-Cart は、企業、個人事業主、開発者、学生のための無料・オープンソースのネットショップ構築ソフトウェアです。商品、カート、注文、顧客、ニュースを備えた完成済みのオンラインストアと管理画面がすぐに使え、プラグインやテンプレートで機能を拡張できます。このページを読み終えると、S-Cart を手元のパソコンやサーバーにインストールし、アップデートやカスタマイズの方法がわかるようになります。

S-Cart 3.x の技術スタック： PHP ≥ 8.3 · Laravel 13 · GP247 · Tailwind CSS 4 · MySQL / MariaDB

✨ S-Cart の機能

🧰 システム要件

💡 Docker を使う場合、パソコンに PHP、Composer、MySQL をインストールする必要はありません — 方法 3 をご覧ください。

🚀 インストール

次の 3 つの方法からいずれか 1 つを選んでください：

方法 1 — Composer（推奨）

1. ターミナル（Windows では「コマンドプロンプト」または Laragon のターミナル）を開き、Composer がどの PHP で動いているかを確認します：

   composer diagnose
   

   PHP version の行が 8.3 以上である必要があります。

   ⚠️ PHP が古い場合、Composer はエラーを出さず、非常に古い S-Cart 1.x を黙ってインストールしてしまいます。誤ったバージョンがインストールされる代わりに Composer がはっきりエラーを出すよう、手順 2 のコマンドでは必ず "^3.0" を付けたままにしてください。

2. プロジェクトを作成します（my-shop は任意のディレクトリ名に置き換えてください）：

   composer create-project gp247/s-cart my-shop "^3.0"
   cd my-shop
   

3. プロジェクトディレクトリ内の .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 に変更してください。

4. S-Cart を初期化します：

   php artisan gp247:install
   

   確認を求められたら yes と入力します。完了すると、管理画面の URL とログイン用アカウントが表示されます。

5. （任意） 試しに見てみるためのサンプルデータを追加します：

   php artisan gp247:shop-sample
   

6. ブラウザを開きます：

   ページ	アドレス	ログイン
   ストア	http://your-domain	—
   管理画面	http://your-domain/gp247_admin	admin / admin

   🔑 初回ログイン後、すぐに admin のパスワードを変更してください。

方法 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 つの設定ファイルがあります — 必ず環境に合ったファイルを使ってください：

個人のパソコン（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。

🔄 バージョンアップデート

1. アップデートの前に、データベースと app/GP247、public/GP247 ディレクトリをバックアップしてください。

2. 新しいソースコードを取得します：

   composer update gp247/core gp247/front gp247/shop
   

3. 変更をサイトに反映します（安全です：データは削除されず、編集済みの翻訳やテンプレートも上書きされません）：

   php artisan gp247:update
   

4. 結果を確認します：

   php artisan gp247:info
   

⚠️ composer update を実行するだけでは不十分です — 必ず手順 3 も実行してください。

高度なオプション（--overwrite-lang による翻訳の上書き、--publish=… によるアセット／ビューの更新）は、あなたのカスタマイズを上書きする可能性があります — 使用する前に GP247 アップデートガイド をよくお読みください。

🎨 カスタマイズと拡張

💡 デフォルトテンプレート GP247Front はパッケージから直接読み込まれるため、publish していないファイルはアップデート時に自動で新しいバージョンになります。編集が必要なファイルだけを publish してください。

コントローラーのオーバーライド

GP247/Core、GP247/Front、GP247/Shop のすべてのコントローラー（API を含む）に適用できます：

1. app/GP247/{Core|Front|Shop}/... に、同じサブパスと同じ名前のファイルを作成します。

2. 新しいクラスを、vendor/gp247/... にある元のコントローラーから extends させます。

3. 元の名前空間の先頭に App\ を追加し、残りはそのままにします：

   元の名前空間	新しい名前空間
   GP247\Core\Controllers	App\GP247\Core\Controllers
   GP247\Core\Api\Controllers	App\GP247\Core\Api\Controllers
   GP247\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           ← 商品、カート、注文

🔧 よく使う環境変数

.env ファイルで設定します：

❓ よくある質問（Q&A）

Q1：Composer でインストールが終わった後に Access denied for user 'root' と表示されました。どういうことですか？

→ Composer が 8.3 より古い PHP で動いていたため、誤って S-Cart 1.x がインストールされています。作成したディレクトリを削除し、Composer を PHP 8.3 以上に切り替えて（composer diagnose で確認）、"^3.0" を付けて再インストールしてください。

Q2：管理画面はどこにあり、何でログインしますか？

→ http://your-domain/gp247_admin、ユーザー admin／パスワード admin です。すぐにパスワードを変更してください。

Q3：使っているバージョンを確認するにはどうすればよいですか？

→ php artisan gp247:info を実行してください。

Q4：サイトでエラーが出る、またはインストールできない場合、まず何を確認すればよいですか？

→ php artisan gp247:doctor を実行してください。環境（PHP、ディレクトリの書き込み権限、設定…）をチェックし、修正すべき箇所を示してくれます。システム要件 に記載したディレクトリの書き込み権限も忘れずに確認してください。

Q5：バージョンアップデートでデータや自分で編集した部分が失われることはありますか？

→ php artisan gp247:update はデータを削除せず、編集済みの翻訳やテンプレートもそのまま保持します。上書きする可能性があるのは --overwrite-lang と --publish=… オプションだけです — 使用する前にバックアップを取ってください。

Q6：デフォルトテンプレートを編集しましたが、アップデートで消えてしまいますか？

→ gp247:template-publish GP247Front --file=... で編集が必要なファイルだけを publish していれば、消えません。編集したファイルはそのまま保持され、残りのファイルはパッケージから自動で新しいバージョンになります。

Q7：管理画面のパスを変更するにはどうすればよいですか？

→ .env の GP247_ADMIN_PREFIX を変更します（例：backoffice）。public/ に既にあるディレクトリ名（vendor、GP247 など）と同じ名前にしないでください。同じにすると、ページが 403 エラーになります。

Q8：インストール後にテーブル名のプレフィックス（GP247_DB_PREFIX）を変更できますか？

→ できません。このプレフィックスは gp247:install を実行する前に決めておく必要があります。

Q9：モバイルアプリを使っていませんが、API は無効にしたほうがよいですか？

→ 無効にしてもかまいません。.env で GP247_API_MODE=0 を設定してください。

Q10：ほかに質問がある場合はどこで聞けばよいですか？

→ GP247 ドキュメント を読むか、DeepWiki に質問するか、S-Cart の Facebook グループ に質問を投稿してください。

_{📅 最終更新: 2026-10-22 · ✍️ 作成者 (Author): GP247}