Перейти к основному содержимому

FAQ и устранение неполадок

Проблемы с установкой​

Страница пустая после установки​

Пустая белая страница почти всегда означает PHP-ошибку, которая подавляется без вывода сообщений.

  1. Откройте файл storage/logs/laravel.log в файловом менеджере (файловый менеджер панели управления хостингом или FTP). Посмотрите на последние строки — там будет сообщение об ошибке с объяснением причины.
  2. Распространённые причины:
    • Отсутствующие PHP-расширения (проверьте страницу требований)
    • Неверные права доступа к файлам (см. раздел о правах доступа ниже)
    • Неверные данные подключения к базе данных в файле конфигурации

Ошибка 500 Internal Server Error​

Это означает, что сервер столкнулся с ошибкой, от которой не смог восстановиться.

  1. Проверьте storage/logs/laravel.log для получения реального сообщения об ошибке.
  2. Проверьте журнал ошибок вашего веб-сервера — в 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-провайдером.
  • Добавьте записи SPF и DKIM в настройки DNS вашего домена. Ваш провайдер электронной почты (SendGrid, Mailgun и т. д.) подскажет, что именно нужно добавить.
  • Не используйте личный Gmail или бесплатные адреса электронной почты в качестве адреса отправителя для транзакционной почты. Используйте профессиональный сервис рассылки.

Тестовое письмо не отправляется​

  • Проверьте свои учётные данные SMTP — даже один неверный символ приводит к ошибке.
  • Для Gmail необходимо использовать пароль приложения, а не обычный пароль.
  • Порт 587 может быть заблокирован на общем хостинге. Попробуйте вместо него порт 465 с SSL.
  • Уточните у своего хостинг-провайдера, разрешён ли исходящий SMTP на используемом порту.

Проблемы с Cron Job​

Автоматизации не запускаются / Отчёты не доставляются​

LeadHub использует один cron job для обработки всей фоновой работы: автоматизации, отправка писем, доставка отчётов и запланированные задачи.

Команда cron job:

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

Замените /path/to/your/leadhub/ на реальный путь на вашем сервере.

Настройка в cPanel:

  1. Войдите в cPanel.
  2. Перейдите в Cron Jobs.
  3. Установите частоту Каждую минуту (заполните * для всех пяти полей).
  4. Команда: php /home/yourusername/public_html/cron.php
  5. Нажмите Добавить новый Cron Job.

Если вы не уверены в пути, уточните у хостинг-провайдера или посмотрите полный путь в файловом менеджере cPanel при переходе в корневую папку сайта.

Других команд запускать не нужно. Не пытайтесь запускать команды artisan из cron — используйте только cron.php.

Как проверить, запущен ли cron job​

В cPanel перейдите в Cron Jobs и найдите созданный вами cron job. Если он там отображается, значит он запланирован. Чтобы убедиться, что он действительно выполняется, можно временно добавить >> /tmp/crontest.log 2>&1 в конец команды, подождать минуту, а затем проверить файл на наличие вывода.

Проблемы с источниками лидов​

Webhook не получает лидов​

  1. Убедитесь, что URL-адрес webhook, настроенный во внешнем сервисе (Facebook, Typeform и т. д.), абсолютно верный, включая токен в конце.
  2. В LeadHub перейдите в настройки интеграции или источника лидов и найдите кнопку «Test» или «Ping» — используйте её для проверки подключения.
  3. Проверьте storage/logs/laravel.log на наличие ошибок входящих webhook-запросов.
  4. Убедитесь, что ваш сервер доступен из интернета (не за брандмауэром, блокирующим входящие подключения).

IMAP-ящик не опрашивается​

Опрос IMAP (проверка почтового ящика на наличие лидов) требует, чтобы cron job был запущен. Смотрите раздел Cron Job выше. Если cron job запущен, но IMAP всё равно не опрашивается:

  1. Проверьте настройки подключения IMAP в конфигурации интеграции.
  2. Убедитесь, что на вашем сервере установлено PHP-расширение php-imap.
  3. Проверьте storage/logs/laravel.log на наличие ошибок подключения IMAP.

Проблемы производительности на общем хостинге​

Приложение работает медленно или завершается по таймауту​

Общий хостинг имеет ограниченные ресурсы. Несколько вещей, которые можно сделать:

Увеличить лимит памяти 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