Руководство по общему хостингу
Это руководство описывает установку LeadHub на типичном cPanel аккаунте общего хостинга. SSH, терминал и root-доступ не требуются.
Что вам понадобится
- cPanel File Manager (или FTP)
- cPanel MySQL Databases
- cPanel Cron Jobs
- Веб-браузер
Шаг 1 — Создание базы данных
- В cPanel нажмите MySQL Databases.
- Создайте новую базу данных, например
username_leadhub. - Создайте нового пользователя базы данных, например
username_lhuser, с надёжным паролем. - Добавьте пользователя в базу данных и предоставьте All Privileges.
- Запишите: имя базы данных, имя пользователя, пароль и хост (обычно
localhost).
Шаг 2 — Загрузка файлов
Вариант А — File Manager:
- Перейдите в cPanel → File Manager.
- Перейдите в
public_html/(или в поддиректорию, если хотите устано вить LeadHub в папку). - Нажмите Upload и загрузите ZIP-файл LeadHub.
- После загрузки щёлкните правой кнопкой мыши по ZIP → Extract в
public_html/.
Вариант Б — FTP:
- Используйте FileZilla или любой FTP-клиент.
- Подключитесь к хостингу с FTP-учётными данными.
- Загрузите все файлы из распакованной папки LeadHub прямо в
public_html/.
⚠️ Убедитесь, что
index.phpнаходится непосредственно вpublic_html/, а не в подпапке.
Шаг 3 — Установка прав доступа
В cPanel File Manager:
- Выберите папку
storage/→ щёлкните правой кнопкой мыши → Change Permissions → установите755, отметьте Recurse into subdirectories. - Повторите то же самое для
bootstrap/cache/.
Шаг 4 — Запуск установщика
Откройте браузер и перейдите по адресу:
https://yourdomain.com/install
Завершите работу мастера, следуя Руководству по установке.
Шаг 5 — Настройка задания Cron
- В cPanel нажмите Cron Jobs.
- В разделе Add New Cron Job установите Common Settings на «Every Minute (
* * * * *)». - В поле Command введите:
/usr/bin/php /home/yourusername/public_html/cron.php >> /dev/null 2>&1Замените
yourusernameна ваше реальное имя пользователя cPanel и скорректируйте путь, если LeadHub установлен в поддиректорию. - Нажмите Add New Cron Job.
Шаг 6 — Проверка работы Cron
Через 2-3 минуты перейдите в панель суперадминистратора LeadHub в раздел System Health. Статус очереди должен отображаться зелёным. Если показывает «queue not running», перепроверьте путь cron.
Установка в поддиректорию
Если вы хотите установить LeadHub по адресу yourdomain.com/leadhub/ вместо корня:
- Загрузите файлы в
public_html/leadhub/. - При установке укажите App URL как
https://yourdomain.com/leadhub. - Путь для cron становится
/home/yourusername/public_html/leadhub/cron.php.
Установка на поддомен
Для установки LeadHub по адресу app.yourdomain.com:
- В cPanel → Domains (или Subdomains) создайте
app.yourdomain.com, указав, например,public_html/leadhub/. - Загрузите файлы в
public_html/leadhub/. - Укажите App URL как
https://app.yourdomain.com.
Проверка версии PHP
Если в вашей cPanel есть MultiPHP Manager:
- Перейдите в MultiPHP Manager.
- Найдите ваш домен/поддомен.
- Выберите PHP 8.4 (или наибольшую доступную версию 8.x).
- Сохраните.
Распространённые проблемы cPanel
| Проблема | Решение |
|---|---|
.htaccess не работает | Включите mod_rewrite через cPanel → Apache Handlers или обратитесь к хостинг-провайдеру |
| Ошибка 500 Internal Server Error | Проверьте storage/logs/laravel.log в File Manager |
| Отсутствует расширение PHP | cPanel → Select PHP Version → включите отсутствующее расширение |
| Очередь не работает | Проверьте путь cron — используйте точный путь из System Health |
| Отказано в доступе к файлам | Установите права storage/ и bootstrap/cache/ на 755 рекурсивно |