メインコンテンツまでスキップ

共有ホスティングガイド

このガイドでは、一般的な cPanel 共有ホスティングアカウントへの LeadHub のインストール手順を説明します。SSH、ターミナル、root アクセスは不要です。


使用するもの

  • cPanel ファイルマネージャー(または FTP)
  • cPanel MySQL Databases
  • cPanel Cron Jobs
  • ウェブブラウザ

ステップ 1 — データベースの作成

  1. cPanel で MySQL Databases をクリックします。
  2. 新しいデータベースを作成します(例:username_leadhub)。
  3. 強力なパスワードで新しいデータベースユーザーを作成します(例:username_lhuser)。
  4. ユーザーをデータベースに追加し、All Privileges を付与します。
  5. データベース名、ユーザー名、パスワード、ホスト(通常は localhost)をメモしておきます。

ステップ 2 — ファイルのアップロード

オプション A — ファイルマネージャー:

  1. cPanel → File Manager に移動します。
  2. public_html/ に移動します(LeadHub をフォルダ内に配置したい場合はサブディレクトリに移動)。
  3. Upload をクリックして LeadHub の ZIP ファイルをアップロードします。
  4. アップロード後、ZIP を右クリック → Extractpublic_html/ に解凍します。

オプション B — FTP:

  1. FileZilla または任意の FTP クライアントを使用します。
  2. FTP 認証情報でホスティングに接続します。
  3. 解凍した LeadHub フォルダからすべてのファイルを直接 public_html/ にアップロードします。

⚠️ index.phppublic_html/ に直接あることを確認してください — サブフォルダ内に入れないでください。


ステップ 3 — 権限の設定

cPanel ファイルマネージャーで:

  1. storage/ フォルダを選択 → 右クリック → Change Permissions755 に設定し、Recurse into subdirectories にチェックを入れます。
  2. bootstrap/cache/ についても同様に行います。

ステップ 4 — インストーラーを実行する

ブラウザを開いて以下に移動します。

https://yourdomain.com/install

インストールガイド に従ってウィザードを完了させます。


ステップ 5 — Cron ジョブのセットアップ

  1. cPanel で Cron Jobs をクリックします。
  2. Add New Cron Job の下で、Common Settings を「Every Minute (* * * * *)」に設定します。
  3. Command フィールドに以下を入力します:
    /usr/bin/php /home/yourusername/public_html/cron.php >> /dev/null 2>&1

    yourusername を実際の cPanel ユーザー名に置き換え、LeadHub がサブディレクトリにある場合はパスを調整してください。

  4. Add New Cron Job をクリックします。

ステップ 6 — Cron が動作していることを確認する

2〜3 分後、LeadHub スーパーアドミンパネルの System Health に移動します。キューのステータスが緑色で表示されるはずです。「queue not running」と表示される場合は、cron のパスを再確認してください。


サブディレクトリへのインストール

LeadHub をルートではなく yourdomain.com/leadhub/ で使いたい場合:

  1. public_html/leadhub/ にファイルをアップロードします。
  2. インストール時に App URLhttps://yourdomain.com/leadhub に設定します。
  3. cron のパスは /home/yourusername/public_html/leadhub/cron.php になります。

サブドメインへのインストール

LeadHub を app.yourdomain.com にインストールする場合:

  1. cPanel → Domains(または Subdomains)で、app.yourdomain.com を作成し、例えば public_html/leadhub/ を指定します。
  2. public_html/leadhub/ にファイルをアップロードします。
  3. App URLhttps://app.yourdomain.com に設定します。

PHP バージョンの確認

cPanel に MultiPHP Manager がある場合:

  1. MultiPHP Manager に移動します。
  2. ドメイン/サブドメインを見つけます。
  3. PHP 8.4(または利用可能な最高の 8.x)を選択します。
  4. 保存します。

よくある cPanel の問題

問題解決方法
.htaccess が機能しないcPanel → Apache Handlers で mod_rewrite を有効にするか、ホストに連絡
500 Internal Server Errorファイルマネージャーで storage/logs/laravel.log を確認
PHP 拡張機能が不足cPanel → Select PHP Version → 不足している拡張機能を有効化
キューが動作しないcron のパスを確認 — System Health の正確なパスを使用
ファイル権限が拒否されるstorage/bootstrap/cache/ を再帰的に 755 に設定