Мохито

Мохито — это серверная часть, разработанная на основе Laravel, Mojito Admin.

С версии 3.0 проект был разделён на два репозитория кода:

• фронтенд-шаблон Mojito-admin, разработанный с использованием Vue 3, Element Plus и Vite;
• серверная часть Mojito. Если вам нужна версия vue2, пожалуйста, обратитесь к ветке 2.0.

Снимок экрана Mojito Admin

Характеристики

• Разделение фронтенда и бэкенда, предоставление фронтенд-шаблона Mojito Admin;
• Управление разрешениями на основе laravel-permission;
• Аутентификация на основе sanctum;
• Предоставление API для управления ролями, разрешениями, пользователями и меню;
• Поддержка единого управления разрешениями, меню и ролями для нескольких бэкэндов;
• Комплексное тестирование PHPUnit.

Требования

• Laravel >= 7.0.0
• PHP >= 7.2.0

Установка

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

composer require moell/mojito

Затем выполните следующую команду для публикации ресурсов:

php artisan mojito:install

После успешного выполнения команды будут созданы файлы конфигурации, миграции данных и сборки SPA.

Измените файл app/Http/Kernel.php:

class Kernel extends HttpKernel
{
    protected $routeMiddleware = [
        ...
        'mojito.permission' => \Moell\Mojito\Http\Middleware\Authenticate::class,
    ];

    protected $middlewareGroups = [
            ...
            'api' => [
                ...
                \Laravel\Sanctum\Http\Middleware\EnsureFrontendRequestsAreStateful::class,
            ],
        ];
}

Выполните миграцию данных и заполнение данных:

php artisan migrate

php artisan db:seed --class="Moell\Mojito\Database\MojitoTableSeeder"

Логин администратора: admin, пароль: secret.

Маршрутные промежуточные программы

• auth:sanctum используется для аутентификации;
• mojito.permission используется для проверки разрешений.

Конфигурация mojito.php (необязательно)

return [
    'guards' => [
        // laravel-permission соответствует guard
        'admin' => [
            'model' => \Moell\Mojito\Models\AdminUser::class, // модель аутентификации
            'login_fields' => [	// поля аутентификации, поддерживают несколько
                'username',
            ],
            'conditions' => [ // дополнительные условия аутентификации
                ['status', '=', 1]
            ]
        ]
    ],
    'route_prefix' => "api", // префикс маршрута
    
    'middleware' => [
        'basic' => 'api', // базовое промежуточное ПО

        'auth' => ['auth:sanctum'], // промежуточное ПО аутентификации

        'permission' => ['auth:sanctum', 'mojito.permission'] // промежуточное ПО, содержащее проверку разрешений
    ]
];

Зависимости расширений пакетов

• spatie/laravel-permission
• laravel/sanctum

Распространённые ошибки

• csrf token missing or incorrect. Измените stateful в sanctum.php. Например, если вы используете vite, удалите localhost:3000. Для получения дополнительной информации посетите документацию laravel/sanctum.

Поощрение

Лицензия

Apache License Version 2.0 см. http://www.apache.org/licenses/LICENSE-2.0.html