共有ホスティング(cPanel)でのデプロイ
Store ConsoleはVPS(DockerまたはLEMP)を推奨しますが、十分なスペックを備えた共有ホストでも動作します。共有ホスティングではrootアクセスがなく、通常はPostgreSQLではなくMySQL、Redisも使えず、長時間実行するプロセスも利用できません。このページでは、それによって変更される点についてのみ説明します。
ホストの最小要件
- PHP 8.4と標準のLaravel拡張機能(多くのcPanel PHPセレクターに含まれています)
- MySQL 8.0以降またはMariaDB 10.6以降(利用可能な場合はPostgreSQLを推奨)
- Cronジョブ(少なくとも1分ごと)
- SSHアクセスを強く推奨します
composerおよびartisan
ステップ1:アップロードしてドキュメントルートを設定
ライセンス済みのzipをアプリのディレクトリの外でアップロード・展開し public_html、その後、cPanel → Domainsから(サブ)ドメインのドキュメントルートをアプリの public/ ディレクトリに設定します。アプリケーションのルートディレクトリ自体は公開しないでください。
ステップ2:共有ホスティング向けに.envを設定
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=cpaneluser_storeconsole
DB_USERNAME=cpaneluser_sc
DB_PASSWORD=your_password
QUEUE_CONNECTION=database
CACHE_STORE=database
SESSION_DRIVER=database
BROADCAST_CONNECTION=null
これらのドライバーは第一級対応です。queue、cache、session用のテーブルはデフォルトのmigrationに含まれているため、Redisは不要です。
ステップ3: 移行とビルド
php artisan migrate --seed
npm run build # or build locally and upload public/build
ステップ4: cron エントリ(Horizon と systemd を置き換え)
cPanel → Cron Jobs に cron ジョブを2つ追加します。
* * * * * php /home/USER/storeconsole/artisan schedule:run
* * * * * php /home/USER/storeconsole/artisan queue:work database --stop-when-empty --max-time=55
2つ目のエントリは、1分ごとにすべてのキューを処理して終了します。共有ホストのプロセス制限の範囲で問題なく動作します。Horizon とその dashboard は共有ホスティングでは使用しません。
何が遅くなるか — とその対処
- AI セマンティック機能 (vector search、embeddings)は PostgreSQL + pgvector が必要ですが、MySQL の場合は自動的に無効化されます。AI chat、生成、report ツールは、設定済みの provider 経由でそのまま動作します。
- リアルタイムの chat と通知 VPS では Reverb/WebSockets を使用します — これを導入しない場合、UI は自動的に定期的なポーリングにフォールバックします(
BROADCAST_CONNECTION=null) - バックグラウンドジョブ 専用ワーカーを使う場合より最大1分遅れて実行されます — mail、invoice、report なら問題ありません。負荷の高いストアでは VPS への移行を推奨します。
VPS へのアップグレード时机
POS や Delivery dispatch を有効にする場合(レイテンシ重視)、AI search に依存する場合、1分あたり数件を超える order を処理する場合は VPS へ移行してください。データは標準の database dump で移行でき、再インストールは不要です。
最終更新:11/19/2026

