Иногда в разработке хочется быстро получить такой легковесный инструмент для создания веб-приложения любой сложности с построением полностью своей архитектуры без необходимости тратить время на подготовку его админ части. То есть, так сказать, получить такой простой каркас, без груды всякого там барахла, где выделена пользовательская часть и администраторская.
На всё это есть достаточно гибкое, бесплатное и простое решение как Voyager.
Voyager - это пакет Laravel, предоставляющий полную и гибкую систему для администрирования фреймворком.
На этом фреймворке Laravel совместно с Voyager вы сможете творить всё что хотите, если понимаете основной принцип работы Laravel и его архитектуру MVC.
Инструкция по установке Voyager на Laravel
Шаг 1: Установка Voyager
Откройте терминал и перейдите в директорию вашего проекта Laravel.
cd path/to/your/laravel/project
Затем выполните следующую команду:
composer require tcg/voyager
Это добавит Voyager и все его зависимости в ваш проект Laravel.
Шаг 2: Публикация ресурсов Voyager
После установки выполните команду:
php artisan voyager:install
Эта команда создаст необходимые таблицы в базе данных и опубликует файлы конфигурации и артефакты, необходимые для работы Voyager.
Шаг 3: Создание администратора
Создайте учетную запись администратора, выполнив команду:
php artisan voyager:admin your_email@example.com --create
Замените your_email@example.com
на ваш адрес электронной почты. Вам потребуется ввести пароль для создаваемой учетной записи.
Убедитесь, что вы запомнили эти учетные данные, так как они понадобятся для входа в админку.
Шаг 4: Переход к созданию сидеров
Теперь, когда Voyager установлен, вы можете создать сидеры для наполнения базы данных.
4.1 Создание сидера
Создайте сидер, выполнив команду:
php artisan make:seeder YourTableSeeder
Замените YourTableSeeder
на имя вашего сидера. Это создаст файл сидера в директории database/seeders
.
4.2 Наполнение сидера данными
Откройте созданный файл сидера и добавьте данные:
use Illuminate\Database\Seeder;
use TCG\Voyager\Models\DataType;
use TCG\Voyager\Models\Bread;
class YourTableSeeder extends Seeder
{
public function run()
{
// Пример добавления новой Bread записи
Bread::create([
'name' => 'your_table_name',
'display_name_singular' => 'Your Table',
'display_name_plural' => 'Your Tables',
// добавьте другие необходимые поля
]);
// Пример создания записей для конкретной таблицы
DB::table('your_table_name')->insert([
['column1' => 'value1', 'column2' => 'value2'],
['column1' => 'value3', 'column2' => 'value4'],
// добавьте другие записи
]);
}
}
4.3 Регистрация сидера
Зарегистрируйте ваш сидер в database/seeders/DatabaseSeeder.php
:
public function run()
{
$this->call(YourTableSeeder::class);
}
Шаг 5: Запуск сидеров
После создания сидеров выполните команду для их запуска:
php artisan db:seed
Эта команда заполнит вашу базу данных данными, указанными в сидерах.
Шаг 6: Запуск сервера
Запустите локальный сервер для проверки:
php artisan serve
Откройте в браузере адрес http://localhost:8000/admin
, чтобы зайти в административную панель Voyager, используя созданные ранее учетные данные.
Шаг 7: Настройка Voyager
Теперь вы можете:
- Проверить добавленные записи в административной панели.
- Корректировать настройки или добавлять новые BREAD для других таблиц, если это необходимо.
- Работать с пользователями, ролями и разрешениями в Voyager.
Вот таким образом устанавливается административная панель Voyager на фреймворк Laravel.
Voyager предоставляет мощные инструменты для управления данными в вашем приложении.
Дополнительную информацию можно найти в официальной документации Voyager.