サーバー要件
FeedbackPulse SaaS をインストールする前に、サーバーが以下のすべての要件を満たしていることを確認してください。
必要なソフトウェア
| ソフトウェア | 最低バージョン | 推奨 | 備考 |
|---|---|---|---|
| PHP | 8.4 | 8.4 以上 | 必要なエクステンションが必要(下記参照) |
| MySQL | 8.0 | 8.0 以上 | または MariaDB 10.6 以上 |
| Web サーバー | Apache 2.4 以上または Nginx 1.18 以上 | Nginx | Apache は mod_rewrite が必要 |
| Composer | 2.0 以上 | 最新版 | PHP 依存関係マネージャー(またはビルド済み vendor/ をアップロード) |
| Node.js | 不要 | — | アセットはあらかじめコンパイル済みです |
共有ホスティングの場合:
composer installを実行できない場合は、ダウンロードパッケージからvendor/フォルダー全体をアップロードしてください。Web インストーラーはvendor/autoload.phpを確認し、見つからない場合はインストールをブロックします。
必要な PHP エクステンション
以下の PHP エクステンションがインストールされ、有効になっている必要があります:
| エクステンション | 用途 | 確認コマンド |
|---|---|---|
pdo_mysql | MySQL データベース接続 | php -m | grep pdo_mysql |
mbstring | マルチバイト文字列処理 | php -m | grep mbstring |
openssl | 暗号化と HTTPS | php -m | grep openssl |
tokenizer | PHP コードのトークン化 | php -m | grep tokenizer |
xml | XML パース | php -m | grep xml |
ctype | 文字タイプチェック | php -m | grep ctype |
json | JSON エンコード/デコード | php -m | grep json |
bcmath | 任意精度演算 | php -m | grep bcmath |
fileinfo | ファイルタイプ検出 | php -m | grep fileinfo |
curl | HTTP リクエスト(決済、AI、Webhook) | php -m | grep curl |
gd または imagick | 画像処理 | php -m | grep gd |
zip | バックアップ圧縮 | php -m | grep zip |
Ubuntu/Debian への PHP エクステンションのインストール
sudo apt update
sudo apt install php8.4-mysql php8.4-mbstring php8.4-xml php8.4-bcmath \
php8.4-curl php8.4-gd php8.4-zip php8.4-fileinfo php8.4-tokenizer
CentOS/RHEL への PHP エクステンションのインストール
sudo dnf install php-mysqlnd php-mbstring php-xml php-bcmath \
php-curl php-gd php-zip php-fileinfo
Windows(XAMPP/Laragon)の場合
ほとんどのエクステンションはあらかじめインストールされています。php.ini を編集して以下の行をコメント解除してください:
extension=pdo_mysql
extension=mbstring
extension=openssl
extension=curl
extension=gd
extension=zip
extension=fileinfo
extension=bcmath
ヒント: Laragon では、すべてのエクステンションがデフォルトで有効になっています。PHP 8.4 以上を使用していることを確認してください。
ディレクトリパーミッション
Web サーバー(Apache/Nginx)のユーザーは以下のディレクトリへの書き込みアクセスが必要です:
| ディレクトリ | パーミッション | 用途 |
|---|---|---|
storage/ | 775 | ログ、キャッシュ、セッション、アップロードされたファイル |
storage/app/public/ | 775 | 公開ファイルアップロード(ロゴ、写真) |
storage/framework/cache/ | 775 | アプリケーションキャッシュ |
storage/framework/sessions/ | 775 | セッションファイル |
storage/framework/views/ | 775 | コンパイル済み Blade テンプレート |
storage/logs/ | 775 | アプリケーションログ |
bootstrap/cache/ | 775 | フレームワークブートストラップキャッシュ |
.env | 644 | 環境設定(インストーラーが作成) |
パーミッションの設定(Linux)
cd /var/www/feedbackpulse-saas
# Web サーバーユーザーに所有権を設定
sudo chown -R www-data:www-data storage bootstrap/cache
# ディレクトリパーミッションの設定
sudo chmod -R 775 storage bootstrap/cache
セキュリティ: パーミッションを
777に設定しないでください。正しいユーザー/グループ所有権で775を使用してください。
ネットワーク要件
| 要件 | 用途 | 必須? |
|---|---|---|
| ドメイン名 | プラットフォームの URL | はい |
| SSL 証明書 | HTTPS 暗号化 | 強く推奨 |
| ワイルドカード DNS(オプ ション) | テナントサブドメイン(*.yourdomain.com) | オプション |
| アウトバウンド HTTPS(ポート 443) | Stripe、PayPal、OpenAI、OAuth API | はい(統合機能用) |
| アウトバウンド SMTP(ポート 587/465) | メール送信 | はい |
推奨サーバースペック
| テナント数 | CPU | RAM | ディスク | 備考 |
|---|---|---|---|---|
| 1〜10 | 1 vCPU | 1 GB | 20 GB | 共有ホスティングでも可 |
| 10〜100 | 2 vCPU | 2 GB | 40 GB | VPS 推奨 |
| 100〜1,000 | 4 vCPU | 4 GB | 80 GB | キャッシュ/キュー用に Redis を検討 |
| 1,000 以上 | 8 vCPU 以上 | 8 GB 以上 | 160 GB 以上 | Redis 必須、キューワーカー推奨 |
サポートされるホスティング環境
完全サポート
- VPS プロバイダー: DigitalOcean、Linode、Vultr、AWS EC2、Hetzner
- マネージドサーバー: Laravel Forge、Ploi、RunCloud、ServerPilot
- 共有ホスティング: cPanel、Plesk、DirectAdmin、CyberPanel、HestiaCP、CloudPanel、AAPanel
- ローカル開発: Laragon(Windows)、Valet(macOS)、Sail(Docker)
共有ホスティングの場合: FeedbackPulse SaaS は共有ホスティングと 100% 互換性があります —
exec()が無効になっていてシンリンクがサポートされていない場合でも問題ありません。詳しいステップバイステップの手順については 共有ホスティングガイド をご覧ください。
部分的なサポート(注意事項あり)
- マネージド WordPress ホスティング: 通常は動作しません(PHP CLI アクセスなし、cron 制限あり)
非サポート
- 静的ホスティング: Netlify、Vercel、GitHub Pages(FeedbackPulse は PHP アプリで静的ではありません)
- サーバーレス: AWS Lambda、Cloudflare Workers(永続ファイルシステムが必要)
サーバーの確認
このコマンドですべての要件を一度に確認します:
php -v # 8.4 以上である必要があります
php -m # すべてのエクステンションを確認
mysql --version # 8.0 以上(または MariaDB 10.6 以上)である必要があります
composer --version # 2.0 以上である必要があります
ls -la storage/ # パーミッションを確認
または https://yourdomain.com/install にアクセスしてください — Web インストーラーには自動要件チェッカーが含まれており、不足しているものを正確に教えてくれます。
次のステップ
すべての要件が満たされましたか?次へ進んでください:
- インストールガイド — 完全なステップバイステップセットアップ