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

FAQ とトラブルシューティング

インストールの問題​

インストール後にページが空白になる​

真っ白なページは、PHP エラーが静かに抑制されていることをほぼ常に意味します。

  1. ファイルマネージャー（ホスティングコントロールパネルのファイルマネージャーまたは FTP）で storage/logs/laravel.log を開いてください。最後の数行を確認してください——何が問題だったかを説明するエラーメッセージがあります。
  2. よくある原因：
    • PHP 拡張機能が不足している（要件ページを確認してください）
    • ファイルのパーミッションが間違っている（下のパーミッションセクションを参照）
    • 設定ファイルのデータベース認証情報が間違っている

500 Internal Server Error​

サーバーが回復できないエラーに遭遇したことを意味します。

  1. 実際のエラーメッセージについては storage/logs/laravel.log を確認してください。
  2. Web サーバーのエラーログを確認してください——cPanel ではログ → エラーログにあります。
  3. 最も一般的な原因：
    • データベース認証情報が間違っている
    • 設定ファイルの APP_KEY の値が不足しているか短すぎる
    • 必要な PHP 拡張機能が有効になっていない

インストーラーが最初に戻り続ける​

これは通常、インストーラーがディスクに書き込めないことを意味します。インストールプロセスは完了時に storage/installed.lock というファイルを作成します。このファイルを作成できない場合、インストールが完了していないと判断します。

修正方法：storage/ フォルダーとその中のすべてのものが書き込み可能であることを確認してください。ホスティングのファイルマネージャーで storage フォルダーを右クリックし、パーミッションを 755 または 775 に設定してください。

データベース接続に失敗する​

インストーラーのエラーメッセージには「Connection refused」または「Access denied」と表示されます。

  • データベースのホスト名、データベース名、ユーザー名、パスワードをもう一度確認してください。これらはすべて cPanel でデータベースを作成するときに設定されます。
  • cPanel ホスティングのデータベースホスト名はほぼ常に localhost です。
  • データベースユーザーがデータベースに対して完全なパーミッションを持っていることを確認してください。

パーミッションエラー（storage または cache に書き込めない）​

LeadHub は特定のフォルダーに書き込む必要があります。ファイルを書き込めないというエラーが表示される場合：

ホスティングのファイルマネージャーで、これらのフォルダーがパーミッション 755 に設定されていることを確認してください（一部のホストでは 775 が必要です）：

  • storage/
  • storage/logs/
  • storage/framework/
  • storage/app/
  • bootstrap/cache/

メールの問題​

メールが送信されない​

  1. 設定 → メールに移動し、すべてのフィールドが正しく入力されていることを確認してください。
  2. テストメールを送信をクリックして自分のメールアドレスを入力してください。
  3. テストメールが届かない場合、storage/logs/laravel.log ファイルに SMTP エラーがないか確認してください。
  4. cron job が実行されていることを確認してください——メールはジョブキューを通じて送信されますが、処理するには cron job が必要です。下の Cron Job セクションを参照してください。

メールがスパムに入る​

  • 最も一般的な原因は、「From Email」アドレスが SMTP プロバイダーによって承認されたドメインと一致していないことです。
  • ドメインの DNS 設定に SPF および DKIM レコードを追加してください。メールプロバイダー（SendGrid、Mailgun など）が正確に何を追加すべきかを教えてくれます。
  • トランザクションメールの送信元アドレスに個人の Gmail や無料のメールアドレスを使用しないでください。プロフェッショナルな送信サービスを使用してください。

テストメールが失敗する​

  • SMTP 認証情報を確認してください——1 文字でも間違っていると失敗します。
  • Gmail の場合、通常のパスワードではなくアプリパスワードを使用する必要があります。
  • 共有ホスティングではポート 587 がブロックされている場合があります。代わりに SSL でポート 465 を試してください。
  • 使用しているポートで送信 SMTP が許可されているかどうかをホスティングプロバイダーに確認してください。

Cron Job の問題​

オートメーションが実行されない / レポートが配信されない​

LeadHub はすべてのバックグラウンド作業を処理するために 1 つの cron job を使用します：オートメーション、メール送信、レポート配信、スケジュールされたタスク。

cron job コマンドは：

php /path/to/your/leadhub/cron.php

/path/to/your/leadhub/ をサーバー上の実際のパスに置き換えてください。

cPanel でのセットアップ方法：

  1. cPanel にログインします。
  2. Cron Jobs に移動します。
  3. 頻度を毎分に設定します（5 つのフィールドすべてに * を入力）。
  4. コマンド：php /home/yourusername/public_html/cron.php
  5. 新しい Cron Job を追加をクリックします。

パスがわからない場合は、ホスティングプロバイダーに確認するか、サイトのルートフォルダーに移動したときに cPanel ファイルマネージャーに表示されるフルパスを確認してください。

実行する他のコマンドはありません。cron から artisan コマンドを実行しようとしないでください——cron.php のみを使用してください。

Cron job が実行されているか確認する方法​

cPanel で Cron Jobs に移動し、作成した cron job を確認してください。そこに表示されている場合はスケジュールされています。実際に実行されているか確認するには、コマンドの末尾に一時的に >> /tmp/crontest.log 2>&1 を追加し、1 分待ってからファイルの出力を確認してください。

リードソースの問題​

Webhook がリードを受信しない​

  1. 外部サービス（Facebook、Typeform など）で設定した webhook URL が、末尾のトークンを含めて正確に正しいか確認してください。
  2. LeadHub で、インテグレーションまたはリードソース設定に移動し、「Test」または「Ping」ボタンを探してください——それを使って接続を確認してください。
  3. 受信 webhook のエラーがないか storage/logs/laravel.log を確認してください。
  4. サーバーがインターネットからアクセス可能であることを確認してください（受信接続をブロックするファイアウォールの後ろにない）。

IMAP 受信トレイがポーリングされない​

IMAP ポーリング（リードのためのメール受信トレイの確認）には cron job の実行が必要です。上の Cron Job セクションを参照してください。cron job が実行されているのに IMAP がまだポーリングされない場合：

  1. インテグレーション設定の IMAP 接続設定を確認してください。
  2. サーバーに php-imap PHP 拡張機能がインストールされていることを確認してください。
  3. IMAP 接続エラーがないか storage/logs/laravel.log を確認してください。

共有ホスティングでのパフォーマンスの問題​

アプリが遅い、またはタイムアウトする​

共有ホスティングはリソースが限られています。いくつかできることがあります：

PHP メモリ制限を増やす： サイトのルートフォルダーの .htaccess ファイルにこの行を追加してください：

php_value memory_limit 256M

またはホスティングプロバイダーに PHP 設定で増やすよう依頼してください。

キャッシュを有効にする： 設定ファイルに CACHE_DRIVER=file または CACHE_DRIVER=database があることを確認してください。これらは共有ホスティングで追加設定なしに動作します。

キューのバッチサイズを減らす： 大きなインポートや一括操作でサーバーが苦労している場合は、より小さなバッチを処理してください。

ログの確認方法​

メインのログファイルは次の場所にあります：

storage/logs/laravel.log

ホスティングのファイルマネージャーでそこに移動してクリックして開くことで確認できます。ファイルの下部を確認してください——そこに最新のエラーが表示されます。

ログファイルは時間とともに大きくなる場合があります。安全に削除できます（アプリが自動的に新しいものを作成します）。

キャッシュのクリア方法​

古いデータや最近の変更が反映されていないページが表示される場合、キャッシュをクリアすると改善されることがあります。

ホスティングのファイルマネージャーを使って行ってください：

  1. bootstrap/cache/ に移動します
  2. このフォルダー内のすべてのファイルを削除します（フォルダー自体は削除しないでください）
  3. storage/framework/cache/data/ に移動します
  4. このフォルダー内のすべてのファイルとサブフォルダーを削除します

キャッシュは次のページ読み込み時に自動的に再構築されます。

フォルダー自体は削除しないでください——内容だけを削除してください。

インストーラーの再実行方法​

インストールウィザードを再度実行する必要がある場合（たとえば新しいデータベースに移行した後など）：

  1. ホスティングのファイルマネージャーで storage/ フォルダーに移動します。
  2. installed.lock というファイルを削除します。
  3. ブラウザーでサイトにアクセスしてください——インストーラーが自動的に起動します。

これはデータを削除しません。インストーラーを再実行できるようにするだけです。データベースとファイルはそのまま残ります。

設定ファイルのよくある間違い​

サイトのルートフォルダーにある設定ファイル（.env）は多くの設定を制御しています。よくある間違い：

  • APP_KEY が不足している — これは 32 文字のランダムな文字列でなければなりません。不足しているか間違っている場合、アプリは起動しません。
  • DB_HOST が間違っている — 共有ホスティングでは、これはほぼ常に localhost です。ドメイン名を使用しないでください。
  • = の周りにスペースがある — フォーマットはスペースなしの KEY=value です。KEY = value は機能しません。
  • 特殊文字を含む値が引用符で囲まれていない — データベースパスワードに # または & が含まれている場合、値全体をダブルクォートで囲んでください：DB_PASSWORD="my#p@ss&word"

サポートを受ける​

このドキュメントで問題を解決できない場合：

  1. まずログファイル storage/logs/laravel.log を確認してください。そこのエラーメッセージが正確に何が問題かを教えてくれることが多いです。
  2. CodeCanyon のコメントを検索してください LeadHub 製品ページで——多くの一般的な問題がそこで回答されています。
  3. CodeCanyon でサポートチケットを開いてください LeadHub 製品ページに移動してサポートをクリックしてください。ログファイルの関連セクションを添付してください。

サポートに連絡する際は、常に以下を含めてください：

  • ホスティング環境（共有ホスティング / VPS、どのプロバイダー）
  • サーバーが実行している PHP バージョン
  • storage/logs/laravel.log の最後の数行