dcat-admin2/src/Admin.php

<?php

namespace Dcat\Admin;

use Closure;
use Dcat\Admin\Models\HasPermissions;
use Dcat\Admin\Controllers\AuthController;
use Dcat\Admin\Layout\SectionManager;
use Dcat\Admin\Repositories\Proxy;
use Dcat\Admin\Contracts\Repository;
use Dcat\Admin\Support\Helper;
use Dcat\Admin\Traits\HasAssets;
use Dcat\Admin\Layout\Menu;
use Dcat\Admin\Layout\Navbar;
use Illuminate\Contracts\Auth\Authenticatable;
use Illuminate\Contracts\Auth\Guard;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Facades\Artisan;
use Illuminate\Support\Facades\Auth;

/**
 * Class Admin.
 */
class Admin
{
    use HasAssets;

    /**
     * The Easy admin version.
     *
     * @var string
     */
    const VERSION = '1.0.0';

    /**
     * @var Navbar
     */
    protected static $navbar;

    /**
     * @var string
     */
    protected static $metaTitle;

    /**
     * @var array
     */
    protected static $extensions = [];

    /**
     * @var array
     */
    protected static $availableExtensions;

    /**
     * @var []Closure
     */
    protected static $booting = [];

    /**
     * @var []Closure
     */
    protected static $booted = [];

    /**
     * Returns the long version of dcat-admin.
     *
     * @return string The long application version
     */
    public static function getLongVersion()
    {
        return sprintf('Dcat Admin <comment>version</comment> <info>%s</info>', static::VERSION);
    }

    /**
     * Left sider-bar menu.
     *
     * @param Closure|null $builder
     * @return Menu
     */
    public static function menu(Closure $builder = null)
    {
        $menu = Menu::make();

        $builder && $builder($menu);

        return $menu;
    }

    /**
     * Set admin title.
     *
     * @return void
     */
    public static function setTitle($title)
    {
        static::$metaTitle = $title;
    }

    /**
     * Get admin title.
     *
     * @return string
     */
    public static function title()
    {
        return static::$metaTitle ?: config('admin.title');
    }

    /**
     * Get current login user.
     *
     * @return Model|Authenticatable|HasPermissions
     */
    public static function user()
    {
        return static::guard()->user();
    }

    /**
     * Attempt to get the guard from the local cache.
     *
     * @return \Illuminate\Contracts\Auth\Guard|\Illuminate\Contracts\Auth\StatefulGuard
     */
    public static function guard()
    {
        return Auth::guard(config('admin.auth.guard') ?: 'admin');
    }

    /**
     * Navbar.
     *
     * @param Closure|null $builder
     *
     * @return Navbar
     */
    public static function navbar(Closure $builder = null)
    {
        $navbar = Navbar::make();

        $builder && $builder($navbar);

        return $navbar;
    }

    /**
     * Get section manager.
     *
     * @param Closure|null $builder
     * @return SectionManager
     */
    public static function section(Closure $builder = null)
    {
        $manager = app('sectionManager');

        $builder && $builder($manager);

        return $manager;
    }

    /**
     * Register the auth routes.
     *
     * @return void
     */
    public static function registerAuthRoutes()
    {
        $attributes = [
            'prefix'     => config('admin.route.prefix'),
            'middleware' => config('admin.route.middleware'),
        ];

        app('router')->group($attributes, function ($router) {

            /* @var \Illuminate\Routing\Router $router */
            $router->namespace('Dcat\Admin\Controllers')->group(function ($router) {

                /* @var \Illuminate\Routing\Router $router */
                $router->resource('auth/users', 'UserController');
                $router->resource('auth/menu', 'MenuController', ['except' => ['create', 'show']]);
                $router->resource('auth/logs', 'LogController', ['only' => ['index', 'destroy']]);

                if (config('admin.permission.enable')) {
                    $router->resource('auth/roles', 'RoleController');
                    $router->resource('auth/permissions', 'PermissionController');
                }
            });

            $authController = config('admin.auth.controller', AuthController::class);

            $router->get('auth/login', $authController.'@getLogin');
            $router->post('auth/login', $authController.'@postLogin');
            $router->get('auth/logout', $authController.'@getLogout');
            $router->get('auth/setting', $authController.'@getSetting');
            $router->put('auth/setting', $authController.'@putSetting');
        });
    }

    /**
     * Register the helpers routes.
     *
     * @return void
     */
    public static function registerHelperRoutes()
    {
        $attributes = [
            'prefix'     => config('admin.route.prefix'),
            'middleware' => config('admin.route.middleware'),
        ];

        app('router')->group($attributes, function ($router) {
            /* @var \Illuminate\Routing\Router $router */
            $router->get('helpers/scaffold', 'Dcat\Admin\Controllers\ScaffoldController@index');
            $router->post('helpers/scaffold', 'Dcat\Admin\Controllers\ScaffoldController@store');
            $router->post('helpers/scaffold/table', 'Dcat\Admin\Controllers\ScaffoldController@table');
            $router->get('helpers/routes', 'Dcat\Admin\Controllers\RouteController@index');
            $router->get('helpers/icons', 'Dcat\Admin\Controllers\IconController@index');
            $router->resource('helpers/extensions', 'Dcat\Admin\Controllers\ExtensionController', ['only' => ['index', 'update']]);
            $router->post('helpers/extensions/import', 'Dcat\Admin\Controllers\ExtensionController@import');
            $router->post('helpers/extensions/create', 'Dcat\Admin\Controllers\ExtensionController@create');
        });
    }

    /**
     * Create a repository instance
     *
     * @param $class
     * @param array $args
     * @return Repository
     */
    public static function createRepository($class, array $args = [])
    {
        $repository = $class;
        if (is_string($repository)) {
            $repository = new $class($args);
        }
        if (!$repository instanceof Repository) {
            throw new \InvalidArgumentException("[$class] must be a valid repository class.");
        }

        if ($repository instanceof Proxy) {
            return $repository;
        }

        return new Proxy($repository);
    }

    /**
     * Get all registered extensions.
     *
     * @return array
     */
    public static function getExtensions()
    {
        return static::$extensions;
    }

    /**
     * Get available extensions.
     *
     * @return Extension[]
     */
    public static function getAvailableExtensions()
    {
        if (static::$availableExtensions !== null) {
            return static::$availableExtensions;
        }

        static::$availableExtensions = [];
        foreach (static::$extensions as $k => $extension) {
            if (!config("admin-extensions.{$k}.enable")) {
                continue;
            }

            static::$availableExtensions[$k] = $extension::make();
        }

        return static::$availableExtensions;
    }

    /**
     * Extend a extension.
     *
     * @param string $class
     *
     * @return void
     */
    public static function extend(string $class)
    {
        static::$extensions[$class::NAME] = $class;
    }

    /**
     * Enable the extension.
     *
     * @param string $class
     * @param bool $enable
     * @return bool
     */
    public static function enableExtenstion(string $class, bool $enable = true)
    {
        if (!$class || !is_subclass_of($class, Extension::class)) {
            return false;
        }

        $name = $class::NAME;

        $config = (array)\config('admin-extensions');

        $config[$name] = (array)($config[$name] ?? []);

        $config[$name]['enable'] = $enable;

        return static::updateExtensionConfig($config);
    }

    /**
     * @param array $config
     * @return bool
     */
    public static function updateExtensionConfig(array $config)
    {
        $files  = app('files');
        $result = (bool)$files->put(config_path('admin-extensions.php'), Helper::exportArrayPhp($config));

        if ($result && is_file($cache = app_path('../bootstrap/cache/config.php'))) {
            Artisan::call('config:cache');
        }

        \config(['admin-extensions' => $config]);

        return $result;
    }

    /**
     * Disable the extension.
     *
     * @param string $class
     * @return bool
     */
    public static function disableExtenstion(string $class)
    {
        return static::enableExtenstion($class, false);
    }

    /**
     * @param callable $callback
     */
    public static function booting(callable $callback)
    {
        static::$booting[] = $callback;
    }

    /**
     * @param callable $callback
     */
    public static function booted(callable $callback)
    {
        static::$booted[] = $callback;
    }

    /**
     * Call booting callbacks.
     */
    public static function callBooting()
    {
        foreach (static::$booting as $call) {
            call_user_func($call);
        }
    }

    /**
     * Call booted callbacks.
     */
    public static function callBooted()
    {
        foreach (static::$booted as $call) {
            call_user_func($call);
        }
    }

}