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

共有ホスティングガイド

このガイドでは、一般的な 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 を右クリック → Extract で public_html/ に解凍します。

オプション B — FTP：

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

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

ステップ 3 — 権限の設定​

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

  1. storage/ フォルダを選択 → 右クリック → Change Permissions → 755 に設定し、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 URL を https://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 URL を https://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 に設定