Download the PHP package russsiq/laravel-assistant without Composer
On this page you can find all versions of the php package russsiq/laravel-assistant. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download russsiq/laravel-assistant
More information about russsiq/laravel-assistant
Files in russsiq/laravel-assistant
Package laravel-assistant
Short Description Ассистент приложения на Laravel 9.x.
License MIT
Homepage https://github.com/russsiq/laravel-assistant
Informations about the package laravel-assistant
Ассистент приложения на Laravel 9.x
Не используйте этот пакет – он не имеет тестов и не завершен
Введение
Ассистент приложения на Laravel 9.x является графической оболочкой для часто используемых команд консоли командной строки и включает в себя несколько пошаговых мастеров:
- Установщик;
- Мастер обновлений;
- Архивариус;
- Чистильщик.
При создании данного пакета преследовалась цель вынести часто повторяющиеся операции по обслуживанию и разворачивании небольших проектов на Laravel.
Подключение
Для добавления зависимости в проект на Laravel, используйте менеджер пакетов Composer:
Если в вашем приложении включен отказ от обнаружения пакетов в директиве dont-discover
в разделе extra
файла composer.json
, то необходимо самостоятельно добавить следующее в файле config/app.php
:
-
Провайдер услуг в раздел
providers
: - Псевдонимы классов (Фасады) в раздел
aliases
:
Публикация файлов пакета
Публикация (копирование) всех доступных файлов для переопределения и тонкой настройки пакета осуществляется через интерфейс командной строки Artisan:
Помимо этого, доступна групповая публикация файлов по отдельным меткам config
, lang
, views
с префиксом assistant-
:
Флаг
--force
является необязательным и используется для принудительной перезаписи опубликованных раннее файлов пакета. Может быть полезен после обновления зависимостей.
Ограничение прав доступа к разделам Ассистента
Следующие мастера имеют посредника can:use-assistant
по всем маршрутам следующих мастеров:
- Мастер обновлений;
- Архивариус;
- Чистильщик.
В поставщике вашего приложения App\Providers\AuthServiceProvider
необходимо самостоятельно описать это правило доступа. Например, используя следующую конструкцию, измените значение '[email protected]'
на ваше собственное:
Краткое описание мастеров
На изображении ниже представлен общий вид Ассистента приложения. Каждый из мастеров состоит из нескольких шагов. Каждый из шагов может быть представлен несколькими экранами: например, экран с вводом данных и экран, отображающий результат.
Каждый из экранов после публикации файлов может быть переопределен в зависимости от ваших предпочтений и требований. Чаще всего требуется простое переопределение строк перевода в языковых файлах.
Установщик
Приложение считается установленным только после того как в файле .env
данным мастером будет прописана дата установки APP_INSTALLED_AT
. До этого момента Установщик будет принудительно перенаправлять пользователя на маршрут Установщика.
Данный мастер состоит из нескольких экранов.
Экран Приветствие Установщика
Экран с краткой вступительной речью, запрашивающий у пользователя следубщие данные:
- названия сайта;
- текущее окружение;
- и принятие лицензионного соглашения.
До того как начнет выполняться указанный вами класс, Установщик дополнит запрос из формы полями APP_DEBUG
, APP_URL
(при их отсутствии) и выполнит валидацию следующих обязательных полей:
Экран Требования Установщика
Проверка на соответствие некоторых настроек сервера минимальным требованиям приложения. Убедитесь, что все пункты будут отмечены зелеными галочками.
Экран База данных
Необходимо указать параметры подключения к предварительно созданной БД.
При нажатии кнопки Далее выполняется проверка подключения к БД, применяются миграции, расположенные в директории database/migrations вашего проекта.
Помимо этого возможно наполнение БД как начальными так и фиктивными данными. Наполнители располагайте в директории database/seeds вашего проекта. Имена классов указывайте в опубликованном файле конфигурации config/assistant.php
в разделе installer.seeds
, где значениями для ключей являются имена классов:
database
- имя класса с начальными данными, например'DatabaseSeeder'
;test
- имя класса с тестовыми данными, например'TestContentSeeder'
.
В качестве имени класса принимается только один класс, записанный строкой. Не указывайте массивы!
Экран Миграции и наполнение БД
Информационный экран, отображающий результаты выполнения предыдущего шага.
Экран Общие параметры системы
Завершающий экран установки. Необходимо указать набор данных, которые будут записаны в файл переменных окружения .env
.
За вывод данного экрана отвечает шаблон common.blade.php
, который будет доступен после публикации файлов пакета в директории resources\views\vendor\assistant\install
.
Поля ввода, заданные вами в этой форме разделяются на два типа: предназначенные для записи в файл .env
и не предназначенные для этого.
Для записи переменных окружения и их значений в файл переменных окружения .env
, имена полей ввода должны быть в верхнем регистре и в качестве разделителя использовать нижнее подчеркивание, например:
Поля ввода, имена которых не соответствуют этому правилу не будут записаны в файл .env
и могут использоваться вами для построения бизнес-логики в классе финальной стадии Установщика.
Данный класс необходимо предварительно сгенерировать с помощью команды:
Эта команда создаст файл app\Services\Assistant\BeforeInstalled.php
. Укажите Ассистенту, что он должен использовать этот сгенерированный класс финальной стадии Установщика в опубликованном файле конфигурации config/assistant.php
в разделе installer
:
В данном классе вы обязаны самостоятельно выполнить валидацию добавленных вами полей в форме
common.blade.php
.
В данном классе вы можете добавлять поля либо изменять значения полей, предназначенных для записи в файл переменных окружения .env
. Например, добавим абстрактное поле:
В вашем распоряжении также имеется возможность в файле настроек config/assistant.php
дополнительно указать директории для копирования и создания ссылок:
Мастер обновлений
Простой мастер, состоящий из двух экранов:
- Экран выбора опций обновления.
- Экран, отображающий результаты выполнения предыдущего шага.
Архивариус
Простой мастер, состоящий из двух экранов:
- Экран выбора опций архивации.
- Экран, отображающий результаты выполнения предыдущего шага.
Чистильщик
Простой мастер, состоящий из двух экранов:
- Экран выбора опций очистки или кеширования.
- Экран, отображающий результаты выполнения предыдущего шага.
Удаление пакета из вашего проекта на Laravel
Тестирование
Неа, не слышал.
Лицензия
laravel-assistant
- программное обеспечение с открытым исходным кодом, распространяющееся по лицензии MIT.
All versions of laravel-assistant with dependencies
ext-zip Version *
guzzlehttp/guzzle Version ^7.4.4
illuminate/support Version 9.*
russsiq/laravel-env-manager Version ^0.6.0
russsiq/laravel-zipper Version ^0.3.0