<?php
namespace Dcat\Admin;
use Closure;
use Dcat\Admin\Contracts\ExceptionHandler;
use Dcat\Admin\Contracts\Repository;
use Dcat\Admin\Exception\InvalidArgumentException;
use Dcat\Admin\Http\Controllers\AuthController;
use Dcat\Admin\Http\JsonResponse;
use Dcat\Admin\Layout\Menu;
use Dcat\Admin\Layout\Navbar;
use Dcat\Admin\Layout\SectionManager;
use Dcat\Admin\Repositories\EloquentRepository;
use Dcat\Admin\Support\Composer;
use Dcat\Admin\Support\Helper;
use Dcat\Admin\Traits\HasAssets;
use Dcat\Admin\Traits\HasHtml;
use Dcat\Admin\Traits\HasPermissions;
use Illuminate\Auth\GuardHelpers;
use Illuminate\Contracts\Auth\Authenticatable;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Http\Exceptions\HttpResponseException;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Event;
use Symfony\Component\HttpFoundation\Response;
class Admin
{
use HasAssets;
use HasHtml;
const VERSION = '2.2.2-beta';
const SECTION = [
// 往 <head> 标签内输入内容
'HEAD' => 'ADMIN_HEAD',
// 往body标签内部输入内容
'BODY_INNER_BEFORE' => 'ADMIN_BODY_INNER_BEFORE',
'BODY_INNER_AFTER' => 'ADMIN_BODY_INNER_AFTER',
// 往#app内部输入内容
'APP_INNER_BEFORE' => 'ADMIN_APP_INNER_BEFORE',
'APP_INNER_AFTER' => 'ADMIN_APP_INNER_AFTER',
// 顶部导航栏用户面板
'NAVBAR_USER_PANEL' => 'ADMIN_NAVBAR_USER_PANEL',
'NAVBAR_AFTER_USER_PANEL' => 'ADMIN_NAVBAR_AFTER_USER_PANEL',
// 顶部导航栏之前
'NAVBAR_BEFORE' => 'ADMIN_NAVBAR_BEFORE',
// 顶部导航栏底下
'NAVBAR_AFTER' => 'ADMIN_NAVBAR_AFTER',
// 侧边栏顶部用户信息面板
'LEFT_SIDEBAR_USER_PANEL' => 'ADMIN_LEFT_SIDEBAR_USER_PANEL',
// 菜单栏
'LEFT_SIDEBAR_MENU' => 'ADMIN_LEFT_SIDEBAR_MENU',
// 菜单栏顶部
'LEFT_SIDEBAR_MENU_TOP' => 'ADMIN_LEFT_SIDEBAR_MENU_TOP',
// 菜单栏底部
'LEFT_SIDEBAR_MENU_BOTTOM' => 'ADMIN_LEFT_SIDEBAR_MENU_BOTTOM',
];
private static $defaultPjaxContainerId = 'pjax-container';
/**
* 版本.
*
* @return string
*/
public static function longVersion()
{
return sprintf('Dcat Admin <comment>version</comment> <info>%s</info>', static::VERSION);
}
/**
* @return Color
*/
public static function color()
{
return app('admin.color');
}
/**
* 菜单管理.
*
* @param Closure|null $builder
* @return Menu
*/
public static function menu(Closure $builder = null)
{
$menu = app('admin.menu');
$builder && $builder($menu);
return $menu;
}
/**
* 设置 title.
*
* @return string|void
*/
public static function title($title = null)
{
if ($title === null) {
return static::context()->metaTitle ?: config('admin.title');
}
static::context()->metaTitle = $title;
}
/**
* @param null|string $favicon
* @return string|void
*/
public static function favicon($favicon = null)
{
if ($favicon === null) {
return static::context()->favicon ?: config('admin.favicon');
}
static::context()->favicon = $favicon;
}
/**
* 设置翻译文件路径.
*
* @param string|null $path
*/
public static function translation(?string $path)
{
static::context()->translation = $path;
}
/**
* 获取登录用户模型.
*
* @return Model|Authenticatable|HasPermissions
*/
public static function user()
{
return static::guard()->user();
}
/**
* @return \Illuminate\Contracts\Auth\Guard|\Illuminate\Contracts\Auth\StatefulGuard|GuardHelpers
*/
public static function guard()
{
return Auth::guard(config('admin.auth.guard') ?: 'admin');
}
/**
* @param Closure|null $builder
* @return Navbar
*/
public static function navbar(Closure $builder = null)
{
$navbar = app('admin.navbar');
$builder && $builder($navbar);
return $navbar;
}
/**
* 启用或禁用Pjax.
*
* @param bool $value
* @return void
*/
public static function pjax(bool $value = true)
{
static::context()->pjaxContainerId = $value ? static::$defaultPjaxContainerId : false;
}
/**
* 禁用pjax.
*
* @return void
*/
public static function disablePjax()
{
static::pjax(false);
}
/**
* 获取pjax ID.
*
* @return string|void
*/
public static function getPjaxContainerId()
{
$id = static::context()->pjaxContainerId;
if ($id === false) {
return;
}
return $id ?: static::$defaultPjaxContainerId;
}
/**
* section.
*
* @param Closure|null $builder
* @return SectionManager
*/
public static function section(Closure $builder = null)
{
$manager = app('admin.sections');
$builder && $builder($manager);
return $manager;
}
/**
* 配置.
*
* @return \Dcat\Admin\Support\Setting
*/
public static function setting()
{
return app('admin.setting');
}
/**
* 创建数据仓库实例.
*
* @param string|Repository|Model|Builder $value
* @param array $args
* @return Repository
*/
public static function repository($repository, array $args = [])
{
if (is_string($repository)) {
$repository = new $repository($args);
}
if ($repository instanceof Model || $repository instanceof Builder) {
$repository = EloquentRepository::make($repository);
}
if (! $repository instanceof Repository) {
$class = is_object($repository) ? get_class($repository) : $repository;
throw new InvalidArgumentException("The class [{$class}] must be a type of [".Repository::class.'].');
}
return $repository;
}
/**
* 应用管理.
*
* @return Application
*/
public static function app()
{
return app('admin.app');
}
/**
* 处理异常.
*
* @param \Throwable $e
* @return mixed
*/
public static function handleException(\Throwable $e)
{
return app(ExceptionHandler::class)->handle($e);
}
/**
* 上报异常.
*
* @param \Throwable $e
* @return mixed
*/
public static function reportException(\Throwable $e)
{
return app(ExceptionHandler::class)->report($e);
}
/**
* 显示异常信息.
*
* @param \Throwable $e
* @return mixed
*/
public static function renderException(\Throwable $e)
{
return app(ExceptionHandler::class)->render($e);
}
/**
* @param callable $callback
*/
public static function booting($callback)
{
Event::listen('admin:booting', $callback);
}
/**
* @param callable $callback
*/
public static function booted($callback)
{
Event::listen('admin:booted', $callback);
}
/**
* @return void
*/
public static function callBooting()
{
Event::dispatch('admin:booting');
}
/**
* @return void
*/
public static function callBooted()
{
Event::dispatch('admin:booted');
}
/**
* 上下文管理.
*
* @return \Dcat\Admin\Support\Context
*/
public static function context()
{
return app('admin.context');
}
/**
* 翻译器.
*
* @return \Dcat\Admin\Support\Translator
*/
public static function translator()
{
return app('admin.translator');
}
/**
* @param array|string $name
* @return void
*/
public static function addIgnoreQueryName($name)
{
$context = static::context();
$ignoreQueries = $context->ignoreQueries ?? [];
$context->ignoreQueries = array_merge($ignoreQueries, (array) $name);
}
/**
* @return array
*/
public static function getIgnoreQueryNames()
{
return static::context()->ignoreQueries ?? [];
}
/**
* 中断默认的渲染逻辑.
*
* @param string|\Illuminate\Contracts\Support\Renderable|\Closure $value
*/
public static function prevent($value)
{
if ($value !== null) {
static::context()->add('contents', $value);
}
}
/**
* @return bool
*/
public static function shouldPrevent()
{
return count(static::context()->getArray('contents')) > 0;
}
/**
* 渲染内容.
*
* @return string|void
*/
public static function renderContents()
{
if (! static::shouldPrevent()) {
return;
}
$results = '';
foreach (static::context()->getArray('contents') as $content) {
$results .= Helper::render($content);
}
// 等待JS脚本加载完成
static::script('Dcat.wait()', true);
$asset = static::asset();
static::baseCss([], false);
static::baseJs([], false);
static::headerJs([], false);
static::fonts([]);
return $results
.static::html()
.$asset->jsToHtml()
.$asset->cssToHtml()
.$asset->scriptToHtml()
.$asset->styleToHtml();
}
/**
* 响应json数据.
*
* @param array $data
* @return JsonResponse
*/
public static function json(array $data = [])
{
return JsonResponse::make($data);
}
/**
* 插件管理.
*
* @param string $name
* @return \Dcat\Admin\Extend\Manager|\Dcat\Admin\Extend\ServiceProvider|null
*/
public static function extension(?string $name = null)
{
if ($name) {
return app('admin.extend')->get($name);
}
return app('admin.extend');
}
/**
* 响应并中断后续逻辑.
*
* @param Response|string|array $response
*
* @throws HttpResponseException
*/
public static function exit($response = '')
{
if (is_array($response)) {
$response = response()->json($response);
} elseif ($response instanceof JsonResponse) {
$response = $response->send();
}
throw new HttpResponseException($response instanceof Response ? $response : response($response));
}
/**
* 类自动加载器.
*
* @return \Composer\Autoload\ClassLoader
*/
public static function classLoader()
{
return Composer::loader();
}
/**
* 往分组插入中间件.
*
* @param array $mix
*/
public static function mixMiddlewareGroup(array $mix = [])
{
$router = app('router');
$group = $router->getMiddlewareGroups()['admin'] ?? [];
if ($mix) {
$finalGroup = [];
foreach ($group as $i => $mid) {
$next = $i + 1;
$finalGroup[] = $mid;
if (! isset($group[$next]) || $group[$next] !== 'admin.permission') {
continue;
}
$finalGroup = array_merge($finalGroup, $mix);
$mix = [];
}
if ($mix) {
$finalGroup = array_merge($finalGroup, $mix);
}
$group = $finalGroup;
}
$router->middlewareGroup('admin', $group);
}
/**
* 获取js配置.
*
* @param array|null $variables
* @return string
*/
public static function jsVariables(array $variables = null)
{
$jsVariables = static::context()->jsVariables ?: [];
if ($variables !== null) {
static::context()->jsVariables = array_merge(
$jsVariables,
$variables
);
return;
}
$sidebarStyle = config('admin.layout.sidebar_style') ?: 'light';
$pjaxId = static::getPjaxContainerId();
$jsVariables['pjax_container_selector'] = $pjaxId ? ('#'.$pjaxId) : '';
$jsVariables['token'] = csrf_token();
$jsVariables['lang'] = __('admin.client') ?: [];
$jsVariables['colors'] = static::color()->all();
$jsVariables['dark_mode'] = static::isDarkMode();
$jsVariables['sidebar_dark'] = config('admin.layout.sidebar_dark') || ($sidebarStyle === 'dark');
$jsVariables['sidebar_light_style'] = in_array($sidebarStyle, ['dark', 'light'], true) ? 'sidebar-light-primary' : 'sidebar-primary';
return admin_javascript_json($jsVariables);
}
/**
* @return bool
*/
public static function isDarkMode()
{
$bodyClass = config('admin.layout.body_class');
return in_array(
'dark-mode',
is_array($bodyClass) ? $bodyClass : explode(' ', $bodyClass),
true
);
}
/**
* 注册路由.
*
* @return void
*/
public static function routes()
{
$attributes = [
'prefix' => config('admin.route.prefix'),
'middleware' => config('admin.route.middleware'),
];
if (config('admin.auth.enable', true)) {
app('router')->group($attributes, function ($router) {
/* @var \Illuminate\Routing\Router $router */
$router->namespace('Dcat\Admin\Http\Controllers')->group(function ($router) {
/* @var \Illuminate\Routing\Router $router */
$router->resource('auth/users', 'UserController');
$router->resource('auth/menu', 'MenuController', ['except' => ['create', 'show']]);
if (config('admin.permission.enable')) {
$router->resource('auth/roles', 'RoleController');
$router->resource('auth/permissions', 'PermissionController');
}
});
$router->resource('auth/extensions', 'Dcat\Admin\Http\Controllers\ExtensionController', ['only' => ['index', 'store', 'update']]);
$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');
});
}
static::registerHelperRoutes();
}
/**
* 注册api路由.
*
* @return void
*/
public static function registerApiRoutes()
{
$attributes = [
'prefix' => admin_base_path('dcat-api'),
'middleware' => config('admin.route.middleware'),
'namespace' => 'Dcat\Admin\Http\Controllers',
'as' => 'dcat-api.',
];
app('router')->group($attributes, function ($router) {
/* @var \Illuminate\Routing\Router $router */
$router->post('action', 'HandleActionController@handle')->name('action');
$router->post('form', 'HandleFormController@handle')->name('form');
$router->post('form/upload', 'HandleFormController@uploadFile')->name('form.upload');
$router->post('form/destroy-file', 'HandleFormController@destroyFile')->name('form.destroy-file');
$router->post('value', 'ValueController@handle')->name('value');
$router->get('render', 'RenderableController@handle')->name('render');
$router->post('tinymce/upload', 'TinymceController@upload')->name('tinymce.upload');
$router->post('editor-md/upload', 'EditorMDController@upload')->name('editor-md.upload');
});
}
/**
* 注册开发工具路由.
*
* @return void
*/
public static function registerHelperRoutes()
{
if (! config('admin.helpers.enable', true) || ! config('app.debug')) {
return;
}
$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\Http\Controllers\ScaffoldController@index');
$router->post('helpers/scaffold', 'Dcat\Admin\Http\Controllers\ScaffoldController@store');
$router->post('helpers/scaffold/table', 'Dcat\Admin\Http\Controllers\ScaffoldController@table');
$router->get('helpers/icons', 'Dcat\Admin\Http\Controllers\IconController@index');
});
}
}