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

Прежде чем вы сможете размещать приложения Laravel, на сервере Plesk должно быть установлено бесплатное расширение Laravel <https://www.plesk.com/extensions/laravel/>`__:

• Если вы являетесь администратором Plesk, установите расширение из Каталога расширений.
• В противном случае обратитесь к своему хостинг-провайдеру и попросите его установить расширение для вас.

После установки расширения вы готовы начать. Вы увидите кнопку Laravel в боковом меню с левой стороны экрана, а также кнопку Установить приложение Laravel на карточках доменов всех ваших доменов.

Загрузка вашего приложения

Прежде чем вы сможете настроить и запустить свое приложение, вам необходимо загрузить его на сервер Plesk и зарегистрировать в Laravel Toolkit. Есть три способа сделать это:

• Создайте скелетное приложение Laravel. Если ваше приложение хранится в папке или сжатом файле на вашем компьютере, или если вы хотите создать приложение с нуля, Laravel Toolkit может создать необходимую структуру каталогов, а также локальный репозиторий Git.
• Установите из удаленного репозитория Git. Если ваше приложение хранится в удаленном репозитории, вы можете развернуть его на сервере Plesk.
• Сканирование существующего приложения. Если вы уже загрузили свое приложение в Plesk, вы можете зарегистрировать свое приложение в Laravel Toolkit, отсканировав его.

Создание скелета Laravel

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены, найдите домен, на котором будет размещено ваше приложение, и нажмите Установить приложение Laravel.
3. Выберите «Установить скелет», а затем нажмите Установить приложение.
4. После установки скелета вам необходимо загрузить файлы приложения в Plesk (например, с помощью FTP или Файловый менеджер), при необходимости заменив файлы по умолчанию.

Установка из удаленного репозитория Git

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены, найдите домен, на котором будет размещено ваше приложение, и нажмите Установить приложение Laravel.
3. Выберите «Установить из удаленного репозитория».
4. Введите или вставьте URL-адрес удаленного репозитория, содержащего файлы вашего приложения.
5. Если удаленный репозиторий требует аутентификации, добавьте в репозиторий открытый ключ, который вы видите на этой странице.
6. Нажмите Установить приложение.

Сканирование существующего приложения

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены, найдите домен, на котором будет размещено ваше приложение, и откройте вкладку «Хостинг и DNS».
3. Нажмите Настройки хостинга.
4. Измените значение «Корневой папки», чтобы оно соответствовало пути к общедоступному каталогу вашего приложения (по умолчанию /httpdocs/public), а затем нажмите ОК.
5. Нажмите Установить приложение Laravel, нажмите Отмена, а затем нажмите Сканировать.

После того, как вы загрузили или развернули файлы приложения и приложение было зарегистрировано в Laravel Toolkit, кнопка Установить приложение Laravel заменяется кнопкой Управление приложением Laravel для домена, на котором размещено приложение.

Теперь вы можете перейти к следующему шагу.

Запуск команд Artisan, Composer и Node.js

Для управления приложением Laravel вам, вероятно, потребуется запускать команды Artisan, Composer и/или Node.js. Laravel Toolkit позволяет легко запускать их из интерфейса Plesk без необходимости shell-доступа.

Если вы не уверены, нужно ли вам запускать команды Artisan, Composer и/или Node.js для правильной работы вашего приложения, проконсультируйтесь с лицом или организацией, предоставившей вам приложение.

Запуск команды Artisan, Composer или Node.js

1. Войдите в Plesk.

2. Перейдите в раздел Сайты и домены, найдите домен, на котором размещено ваше приложение, и нажмите Управление приложением Laravel.

3. Перейдите на соответствующую вкладку, введите команду, которую хотите запустить, или выберите ее из списка, а затем нажмите клавишу Enter или кнопку .

   Примечание: При выполнении команд Node.js может потребоваться указать конкретную версию Node.js и/или диспетчер пакетов, чтобы получить желаемый результат. Если вы не уверены, что выбрать, проконсультируйтесь с лицом или организацией, предоставившей вам приложение.

Просмотр файлов журнала приложения

Во время работы ваше приложение Laravel записывает свой журнал в отдельный файл. Вы можете просматривать содержимое этого файла прямо из интерфейса Laravel Toolkit, это поможет следить за работой приложения и устранять любые проблемы, если они возникнут.

Просмотр журнала приложения

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены, найдите домен, на котором размещено ваше приложение, и нажмите Управление приложением Laravel.
3. Нажмите Журналы.

Откроется браузер журналов домена, который показывает только записи из журнала Laravel.

Просмотр запланированных задач приложения

С помощью Laravel вы можете планировать задачи внутри кода приложения вместо использования внешнего планировщика, такого как cron. С помощью Laravel Toolkit можно увидеть все настроенные в данный момент запланированные задачи прямо из интерфейса Laravel Toolkit, а также включать или отключать запланированные задачи Laravel.

Просмотр запланированных задач приложения

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены, найдите домен, на котором размещено ваше приложение, и нажмите Управление приложением Laravel.
3. Перейдите на вкладку «Запланированные задачи» (эта вкладка отображается только в том случае, если настроена одна или несколько запланированных задач).

Включение управления запланированными задачами в Plesk для Linux

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены, найдите домен, на котором размещено ваше приложение, перейдите на вкладку «Хостинг и DNS» и нажмите Доступ к веб-хостингу.
3. В разделе «Доступ к серверу по SSH» выберите любой вариант, кроме «Запрещено», а затем нажмите ОК.

Включение управления запланированными задачами в Plesk для Windows

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены и найдите домен, на котором размещается ваше приложение.
3. В разделе «Учетная запись» нажмите Настроить.
4. Перейдите на вкладку «Права», установите флажок рядом с пунктом «Управление планировщиком» и нажмите Обновить и заблокировать.

Теперь вы можете включать и отключать запланированные задачи вашего приложения.

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

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены, найдите домен, на котором размещено ваше приложение, и нажмите Управление приложением Laravel.
3. Нажмите переключатель Запланированные задачи, чтобы он показывал «Включено».

Запланированные задачи теперь включены для вашего приложения Laravel.

Изменение переменных среды

Вашему приложению может потребоваться одна или несколько настраиваемых переменных среды для правильной работы, или оно может изменять свое поведение в зависимости от установленных переменных среды. Если вы не уверены, нужны ли вашему приложению какие-либо переменные среды для правильной работы, проконсультируйтесь с лицом или организацией, предоставившей вам приложение.

Изменение переменных среды

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены, найдите домен, на котором размещено ваше приложение, и нажмите Управление приложением Laravel.
3. Нажмите кнопку Изменить рядом с «Переменные среды (.env)».
4. Измените переменные среды желаемым образом и нажмите Обновить.

Теперь действуют обновленные переменные среды.

Перевод приложения в режим техобслуживания

Чтобы у пользователей не возникало ошибок, пока вы работаете с приложением или обновляете его, вы можете перевести его в режим техобслуживания. Пока приложение находится в режиме техобслуживания, при посещении сайта будет отображаться страница с ошибкой «503 SERVICE UNAVAILABLE».

Перевод приложения в режим техобслуживания

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены, найдите домен, на котором размещено ваше приложение, и нажмите Управление приложением Laravel.
3. Нажмите переключатель Режим техобслуживания, чтобы он показывал «Включено».

Приложение Laravel находится в режиме обслуживания.

Обновление вашего приложения

Независимо от того, хранятся ли файлы приложения Laravel в локальном или удаленном репозитории Git, убедитесь, что изменения в коде приложения отправлены на сервер Plesk. Вы можете установить изменения автоматически или вручную.

Если вам нужен полный контроль над временем обновления приложения, рекомендуется обновлять его вручную. Таким образом изменения, сделанные в коде приложения в репозитории, не будут отправлены на сервер Plesk, пока это вам не понадобится. Недостатком такого подхода является то, что вам придется делать это вручную при каждом обновлении приложения.

Обновление приложения вручную

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены, найдите домен, на котором размещено ваше приложение, и нажмите Управление приложением Laravel.
3. Перейдите на вкладку «Развертывание» и для опции «Режим развертывания» установите переключатель на «Вручную».
4. В разделе «Сценарий развертывания» уберите галочки, соответствующие шагам, которые вы хотите пропустить при развертывании, и нажмите «Развернуть».

После того, как Laravel Toolkit выполнит все шаги развертывания, ваше приложение и его зависимости будут обновлены.

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

Обновление приложения вручную (локальный репозиторий)

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены, найдите домен, на котором размещено ваше приложение, и нажмите Управление приложением Laravel.
3. Перейдите на вкладку «Развертывание» и для опции «Режим развертывания» установите переключатель на «Автоматически».
4. В разделе «Сценарий развертывания» уберите галочки, соответствующие шагам, которые вы хотите пропустить при развертывании.

Теперь каждый раз, когда коммит отправляется в ветку master локального репозитория с кодом приложения, приложение и его зависимости будут обновляться.

Обновление приложения вручную (удаленный репозиторий)

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены, найдите домен, на котором размещено ваше приложение, и нажмите Управление приложением Laravel.
3. Скопируйте отсюда URL-адрес веб-хука и добавьте в удаленный репозиторий. Подробные инструкции вы найдете в документации провайдера вашего репозитория.
4. Перейдите на вкладку «Развертывание» и для опции «Режим развертывания» установите переключатель на «Автоматически».
5. В разделе «Сценарий развертывания» уберите галочки, соответствующие шагам, которые вы хотите пропустить при развертывании.

Теперь каждый раз, когда в удаленном репозитории с кодом приложения происходит событие-триггер веб-хука, приложение и его зависимости будут обновляться.

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

Для правильной работы вашего приложения может потребоваться выполнить определенные команды на сервере во время развертывания. Чтобы не запускать команды вручную, вы можете настроить сценарий развертывания, который будет запускаться при каждом обновлении приложения.

Если вы не уверены, нужно ли для правильной работы вашего приложения запускать какие-либо команды во время развертывания, проконсультируйтесь с лицом или организацией, предоставившей вам приложение.

Активация возможности редактирования скрипта развертывания в Plesk для Linux

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены, найдите домен, на котором размещено ваше приложение, перейдите на вкладку «Хостинг и DNS» и нажмите Доступ к веб-хостингу.
3. В разделе «Доступ к серверу по SSH» выберите любой вариант, кроме «Запрещено», а затем нажмите ОК.

Теперь можно изменять сценарий развертывания из интерфейса Laravel Toolkit.

Изменение сценария развертывания

1. Войдите в Plesk.
2. Перейдите в раздел Сайты и домены, найдите домен, на котором размещено ваше приложение, и нажмите Управление приложением Laravel.
3. Перейдите на вкладку «Развертывание» и нажмите Изменить сценарий.
4. Введите или вставьте сценарий развертывания, а затем нажмите Обновить.

Сценарий развертывания теперь будет запускаться каждый раз, когда вы обновляете приложение.