RU

Веб-хостинг

Разместить сайт Laravel в Plesk

Опубликуйте приложение Laravel в Plesk с Laravel Toolkit или без него: версия PHP, база данных, файл .env, миграции, запланированные задачи и распространенные ошибки.

9 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

В этом руководстве описано, как опубликовать приложение Laravel на вашем хостинге Plesk. Рассматриваются два способа: с помощью Laravel Toolkit, инструмента Plesk для работы с Laravel, или вручную, если этот инструмент недоступен.

Предварительные требования

  • Доступ к панели Plesk (см. Подключение к интерфейсу Plesk).
  • Домен, привязанный к вашему хостингу и направленный на него.
  • Версия PHP, совместимая с вашим приложением. Для Laravel 13 требуется PHP 8.3 или выше. Для другой версии Laravel см. строку php в файле composer.json.
  • Расширения PHP, необходимые Laravel: Ctype, cURL, DOM, Fileinfo, Filter, Hash, Mbstring, OpenSSL, PCRE, PDO, Session, Tokenizer и XML, а также pdo_mysql для MySQL или MariaDB.
  • Ваш проект в репозитории Git или на вашем компьютере.

В этом руководстве используется папка httpdocs, стандартная для основного домена. У дополнительного домена папка может быть другой: проверьте значение Корневая папка в разделе Хостинг и DNS > Хостинг.

Важный момент: папка public

Из интернета должна быть доступна только папка public приложения Laravel. В остальной части проекта, в частности, находится файл .env с вашими паролями и ключом шифрования. Никогда не перемещайте index.php в корень проекта: корневая папка домена должна указывать на public.

Для проекта, размещенного в httpdocs, используйте значение /httpdocs/public.

Шаг 1: выберите версию PHP

  1. Перейдите в раздел Сайты и домены и найдите ваш домен.
  2. Откройте PHP (или Настройки PHP, в зависимости от версии Plesk).
  3. Выберите совместимую версию и сохраните изменения.

Шаг 2: создайте базу данных

Создайте базу и отдельного пользователя, следуя руководству Создать базу данных. Запишите имя базы, имя пользователя, пароль и хост, указанный Plesk в информации о подключении к базе.

Способ 1: с Laravel Toolkit

Установка приложения

В разделе Сайты и домены для вашего домена нажмите Создать сайт > Laravel и выберите один из вариантов:

  • Установить из удаленного репозитория: введите URL вашего репозитория. Если он приватный, добавьте в него открытый ключ, показанный в Plesk (порядок действий описан в руководстве Развернуть сайт из GitHub или GitLab). Затем нажмите Установить приложение.
  • Установить скелет: Plesk установит пустое приложение Laravel. Нажмите Установить приложение, а затем, если у вас уже есть проект, замените файлы своими через FTP или файловый менеджер.

Если ваше приложение уже находится на хостинге:

  1. В разделе Хостинг и DNS > Хостинг задайте для параметра Корневая папка значение /httpdocs/public и нажмите Сохранить.
  2. Вернитесь на вкладку Dashboard, нажмите Создать сайт > Laravel, затем Cancel.
  3. Нажмите Scan, чтобы Plesk обнаружил приложение.

Настройка файла .env

Откройте Laravel для вашего домена. Рядом с пунктом Переменные среды (.env) нажмите Изменить, укажите следующие значения и нажмите Обновить:

Конфигурация
APP_NAME="Мое приложение"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://ваш-домен.com

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=database_name
DB_USERNAME=database_user
DB_PASSWORD=database_password

Запуск команд Artisan

На вкладке Artisan вводите каждую команду без префикса php artisan и выполняйте ее:

Текст
key:generate --force
migrate --force
storage:link
optimize
  • key:generate --force создает ключ APP_KEY. Запускайте эту команду, только если значение пустое: смена ключа на работающем сайте делает зашифрованные данные нечитаемыми и завершает сеансы пользователей.
  • migrate --force создает таблицы. По умолчанию Laravel хранит в них также сеансы, кэш и очереди.
  • storage:link открывает доступ к файлам диска public.
  • optimize кэширует конфигурацию, маршруты, события и представления.

Развертывание обновлений

На вкладке Развертывание:

  1. Выберите Режим развертывания: Вручную или Автоматически.
  2. В разделе Сценарий развертывания снимите флажки с ненужных шагов.
  3. Нажмите Развернуть.

Кнопка Изменить сценарий позволяет настроить развертывание, если для домена разрешен доступ по SSH.

Включение запланированных задач

Задачи определяются в коде приложения, обычно в файле routes/console.php. Создать их из Plesk нельзя. Если существует хотя бы одна задача, появляется вкладка Запланированные задачи: переведите ее переключатель в положение Включено.

Включение очередей

Очереди в Laravel Toolkit работают на основе базы данных и запланированных задач, поэтому задачи должны быть включены.

  1. Добавьте пакет интеграции Plesk в раздел require файла composer.json, проверив его совместимость с вашей версией Laravel:

    JSON
    "plesk/ext-laravel-integration": "^7.0"
  2. Выполните развертывание, затем закоммитьте обновленный файл composer.lock и выполните развертывание еще раз.

  3. Убедитесь, что в файле .env есть строка QUEUE_CONNECTION=database.

  4. Включите Режим техобслуживания.

  5. На вкладке Artisan выполните migrate --force. Если в проекте нет миграции для таблицы jobs, сначала выполните queue:table.

  6. Отключите Режим техобслуживания и переведите переключатель Queue в положение Включено.

Способ 2: без Laravel Toolkit

Подготовка проекта на компьютере

В папке проекта установите зависимости для рабочей среды и скомпилируйте файлы фронтенда:

Терминал
composer install --no-dev --optimize-autoloader
npm ci
npm run build
php artisan key:generate --show

Сохраните ключ, выведенный последней командой: он начинается с base64:. Если сайт уже работает, используйте его текущий ключ.

Загрузка файлов

  1. Создайте архив .zip проекта с папками vendor и public/build, но без node_modules и без локального файла .env.

  2. В разделе Файлы откройте httpdocs, загрузите архив, установите флажок рядом с ним, нажмите Извлечь файлы и удалите архив.

  3. Создайте в httpdocs файл .env по примеру из способа 1 и добавьте в него ваш ключ:

    Конфигурация
    APP_KEY=base64:YOUR_GENERATED_KEY

Для загрузки файлов можно также использовать учетную запись FTP.

Настройка корневой папки

  1. В разделе Сайты и домены откройте Хостинг и DNS > Хостинг для вашего домена.
  2. Задайте для параметра Корневая папка значение /httpdocs/public.
  3. Нажмите Сохранить.

Выполнение команд Artisan

При наличии доступа по SSH используйте исполняемый файл PHP, соответствующий версии, выбранной для сайта. Команда php без пути может указывать на другую версию:

Терминал
cd httpdocs
/opt/plesk/php/8.3/bin/php artisan migrate --force
/opt/plesk/php/8.3/bin/php artisan storage:link
/opt/plesk/php/8.3/bin/php artisan optimize

Без доступа по SSH воспользуйтесь планировщиком задач:

  1. Откройте Планировщик задач и нажмите Добавить задачу.
  2. Выберите Выполнить PHP-скрипт.
  3. Выберите файл httpdocs/artisan с помощью значка папки.
  4. В поле аргументов (with arguments) введите migrate --force.
  5. Выберите версию PHP, используемую сайтом.
  6. Нажмите Запустить сейчас и дождитесь результата.

Повторите действия для storage:link, а затем для optimize. После этого можно выйти, не сохраняя задачу.

Планирование задач Laravel

Если ваше приложение использует планировщик, создайте задачу Выполнить PHP-скрипт, как описано выше, с аргументом schedule:run и следующей периодичностью в формате Cron:

Текст
* * * * *

Проверка результата

  1. Откройте https://ваш-домен.com/: должно отобразиться ваше приложение.

  2. Проверьте контрольный маршрут Laravel, который по умолчанию есть в новых проектах:

    Терминал
    curl -i https://ваш-домен.com/up

    Код 200 означает, что приложение запустилось без ошибок.

  3. Убедитесь, что конфиденциальный файл не доступен извне: по адресу https://ваш-домен.com/.env ваша конфигурация никогда не должна отображаться.

  4. Проверьте страницу, использующую базу данных, например страницу входа.

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

Ошибка 500 без подробностей

Просмотрите файл storage/logs/laravel.log в файловом менеджере или нажмите кнопку Журналы в Laravel Toolkit. Включайте APP_DEBUG=true лишь ненадолго, если журнала недостаточно.

No application encryption key has been specified.

Переменная APP_KEY пуста или отсутствует. Сгенерируйте ее командой key:generate --force или вставьте ключ, созданный на вашем компьютере, а затем выполните config:clear.

Изменения в .env не применяются

Конфигурация закэширована. Выполните optimize:clear, а после устранения проблемы — optimize.

Ошибка 403, 404 или список файлов на главной странице

Вероятно, корневая папка не указывает на public. Убедитесь, что задано значение /httpdocs/public. Если ошибку 404 возвращают только внутренние страницы, проверьте, загружен ли файл public/.htaccess.

Vite manifest not found at: .../public/build/manifest.json

Файлы фронтенда не скомпилированы или не загружены. Выполните npm run build и загрузите папку public/build.

SQLSTATE[HY000] [1045] Access denied

Неверно указаны имя пользователя или пароль базы, либо пользователь не связан с этой базой. Исправьте .env и выполните config:clear. Если пароль содержит пробелы или символ #, заключите его в кавычки.

SQLSTATE[HY000] [2002]

Laravel не может подключиться к серверу базы данных. Сверьте DB_HOST и DB_PORT с информацией о подключении к базе. Если в сообщении указано No such file or directory при значении localhost, попробуйте DB_HOST=127.0.0.1.

SQLSTATE[42S02]: таблица sessions или cache не найдена

Миграции не были выполнены для этой базы. Выполните migrate --force.

Failed to open stream: Permission denied в storage

Laravel должен иметь возможность записывать данные в storage и bootstrap/cache. Проверьте права на эти папки в файловом менеджере. Если вы не можете их исправить, обратитесь в поддержку.

Your Composer dependencies require a PHP version ">= 8.3.0"

Сайт или командная строка используют слишком старую версию PHP. Выберите правильную версию в Plesk, а при работе по SSH вызывайте исполняемый файл по полному пути, например /opt/plesk/php/8.3/bin/php.

Загруженные изображения возвращают ошибку 404

Ссылка на общедоступное хранилище отсутствует или была утрачена при развертывании. Снова выполните storage:link.

Вкладка Запланированные задачи не отображается

Она появляется, только если в приложении определена хотя бы одна задача. Проверьте routes/console.php и запустите развертывание еще раз.