Разместить сайт Laravel в Plesk
Опубликуйте приложение Laravel в Plesk с Laravel Toolkit или без него: версия PHP, база данных, файл .env, миграции, запланированные задачи и распространенные ошибки.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
В этом руководстве описано, как опубликовать приложение 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
- Перейдите в раздел Сайты и домены и найдите ваш домен.
- Откройте PHP (или Настройки PHP, в зависимости от версии Plesk).
- Выберите совместимую версию и сохраните изменения.
Шаг 2: создайте базу данных
Создайте базу и отдельного пользователя, следуя руководству Создать базу данных. Запишите имя базы, имя пользователя, пароль и хост, указанный Plesk в информации о подключении к базе.
Способ 1: с Laravel Toolkit
Установка приложения
В разделе Сайты и домены для вашего домена нажмите Создать сайт > Laravel и выберите один из вариантов:
- Установить из удаленного репозитория: введите URL вашего репозитория. Если он приватный, добавьте в него открытый ключ, показанный в Plesk (порядок действий описан в руководстве Развернуть сайт из GitHub или GitLab). Затем нажмите Установить приложение.
- Установить скелет: Plesk установит пустое приложение Laravel. Нажмите Установить приложение, а затем, если у вас уже есть проект, замените файлы своими через FTP или файловый менеджер.
Если ваше приложение уже находится на хостинге:
- В разделе Хостинг и DNS > Хостинг задайте для параметра Корневая папка значение
/httpdocs/publicи нажмите Сохранить. - Вернитесь на вкладку Dashboard, нажмите Создать сайт > Laravel, затем Cancel.
- Нажмите 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
optimizekey:generate --forceсоздает ключAPP_KEY. Запускайте эту команду, только если значение пустое: смена ключа на работающем сайте делает зашифрованные данные нечитаемыми и завершает сеансы пользователей.migrate --forceсоздает таблицы. По умолчанию Laravel хранит в них также сеансы, кэш и очереди.storage:linkоткрывает доступ к файлам дискаpublic.optimizeкэширует конфигурацию, маршруты, события и представления.
Развертывание обновлений
На вкладке Развертывание:
- Выберите Режим развертывания: Вручную или Автоматически.
- В разделе Сценарий развертывания снимите флажки с ненужных шагов.
- Нажмите Развернуть.
Кнопка Изменить сценарий позволяет настроить развертывание, если для домена разрешен доступ по SSH.
Включение запланированных задач
Задачи определяются в коде приложения, обычно в файле routes/console.php. Создать их из Plesk нельзя. Если существует хотя бы одна задача, появляется вкладка Запланированные задачи: переведите ее переключатель в положение Включено.
Включение очередей
Очереди в Laravel Toolkit работают на основе базы данных и запланированных задач, поэтому задачи должны быть включены.
-
Добавьте пакет интеграции Plesk в раздел
requireфайлаcomposer.json, проверив его совместимость с вашей версией Laravel:JSON"plesk/ext-laravel-integration": "^7.0" -
Выполните развертывание, затем закоммитьте обновленный файл
composer.lockи выполните развертывание еще раз. -
Убедитесь, что в файле
.envесть строкаQUEUE_CONNECTION=database. -
Включите Режим техобслуживания.
-
На вкладке Artisan выполните
migrate --force. Если в проекте нет миграции для таблицыjobs, сначала выполнитеqueue:table. -
Отключите Режим техобслуживания и переведите переключатель Queue в положение Включено.
Способ 2: без Laravel Toolkit
Подготовка проекта на компьютере
В папке проекта установите зависимости для рабочей среды и скомпилируйте файлы фронтенда:
composer install --no-dev --optimize-autoloader
npm ci
npm run build
php artisan key:generate --showСохраните ключ, выведенный последней командой: он начинается с base64:. Если сайт уже работает, используйте его текущий ключ.
Загрузка файлов
-
Создайте архив
.zipпроекта с папкамиvendorиpublic/build, но безnode_modulesи без локального файла.env. -
В разделе Файлы откройте
httpdocs, загрузите архив, установите флажок рядом с ним, нажмите Извлечь файлы и удалите архив. -
Создайте в
httpdocsфайл.envпо примеру из способа 1 и добавьте в него ваш ключ:КонфигурацияAPP_KEY=base64:YOUR_GENERATED_KEY
Для загрузки файлов можно также использовать учетную запись FTP.
Настройка корневой папки
- В разделе Сайты и домены откройте Хостинг и DNS > Хостинг для вашего домена.
- Задайте для параметра Корневая папка значение
/httpdocs/public. - Нажмите Сохранить.
Выполнение команд 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 воспользуйтесь планировщиком задач:
- Откройте Планировщик задач и нажмите Добавить задачу.
- Выберите Выполнить PHP-скрипт.
- Выберите файл
httpdocs/artisanс помощью значка папки. - В поле аргументов (with arguments) введите
migrate --force. - Выберите версию PHP, используемую сайтом.
- Нажмите Запустить сейчас и дождитесь результата.
Повторите действия для storage:link, а затем для optimize. После этого можно выйти, не сохраняя задачу.
Планирование задач Laravel
Если ваше приложение использует планировщик, создайте задачу Выполнить PHP-скрипт, как описано выше, с аргументом schedule:run и следующей периодичностью в формате Cron:
* * * * *Проверка результата
-
Откройте
https://ваш-домен.com/: должно отобразиться ваше приложение. -
Проверьте контрольный маршрут Laravel, который по умолчанию есть в новых проектах:
Терминалcurl -i https://ваш-домен.com/upКод
200означает, что приложение запустилось без ошибок. -
Убедитесь, что конфиденциальный файл не доступен извне: по адресу
https://ваш-домен.com/.envваша конфигурация никогда не должна отображаться. -
Проверьте страницу, использующую базу данных, например страницу входа.
Устранение неполадок
Ошибка 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 и запустите развертывание еще раз.