Развёртывание Laravel на хостинге GARMTECH (Plesk): чек‑лист

Эта инструкция поможет развернуть приложение Laravel на веб‑хостинге GARMTECH (Plesk).

Точка входа Laravel – public/index.php. Для безопасности document root сайта должен указывать на папку public (чтобы файл .env и внутренние файлы не были доступны извне).

1) Загрузите проект Laravel

Загрузить проект можно через:

• FTP‑SSL (FTPS) (рекомендуется для полного деплоя),
• Plesk File Manager (удобно для архивов),
• Git deployment (workflow разработчика).

Типовая структура на shared hosting:

• httpdocs/ – корень сайта в Plesk
• httpdocs/public/ – публичная папка Laravel

2) Установите правильный document root в Plesk

1. Plesk → Websites & Domains → ваш домен.
2. Откройте Hosting Settings.
3. Укажите Document root как httpdocs/public.
4. Сохраните изменения.

Примечание: если у вас несколько приложений, удобнее использовать субдомены (например app.example.com) и задавать document root отдельно для каждого.

3) Выберите версию PHP и включите необходимые расширения

• Plesk → домен → PHP Settings → выберите требуемую версию PHP для вашей версии Laravel.
• Включите популярные расширения (если доступны): mbstring, openssl, pdo, tokenizer, xml, ctype, json, fileinfo.

4) Создайте базу данных и пользователя

1. Plesk → домен → Databases → Add Database.
2. Создайте пользователя БД и сохраните его данные.
3. Обновите .env (DB_HOST/DB_DATABASE/DB_USERNAME/DB_PASSWORD).

5) Установите зависимости (Composer) и подготовьте приложение

Laravel требует папку vendor. Варианты:

• Запустить Composer install на сервере (через SSH или инструмент Composer в Plesk), или
• Установить зависимости локально и загрузить полный проект (включая vendor).

Типовые команды для первого запуска (SSH):

php artisan key:generate
php artisan config:cache

Если используется storage symlink:

php artisan storage:link

6) Права доступа (частая причина 500 ошибок)

Laravel должен иметь права на запись в:

• storage/
• bootstrap/cache/

Если в логах видны ошибки прав доступа, убедитесь, что эти папки доступны на запись для системного пользователя хостинга.

7) (Опционально) Планировщик задач (Cron)

Если приложение использует Laravel scheduler, добавьте задачу cron в Plesk:

• Plesk → домен → Scheduled Tasks

Типовая команда (каждую минуту):

* * * * * php /path/to/artisan schedule:run

Точный путь к PHP может отличаться. Если используете SSH, обычно достаточно php; иначе используйте путь к PHP CLI из вашего окружения.

8) Быстрый чек‑лист диагностики

• Белый экран / 500: проверьте Logs в Plesk – там будут детали ошибки Laravel.
• 404 на всех маршрутах: document root не указывает на public или не применяются rewrite‑правила.
• «APP_KEY missing»: выполните php artisan key:generate.
• Ошибки базы данных: перепроверьте настройки DB в .env и права пользователя БД.