sunxyw/laravel-admin


README


Build Status StyleCI

Dcat Admin 是一个基于 laravel-admin 二次开发而成的后台系统构建工具,只需很少的代码即可快速构建出一个功能完善、高颜值的后台系统。内置丰富的后台常用组件,开箱即用,让开发者告别冗杂的 HTML 代码,对后端开发者非常友好。

功能特性

  • 简洁优雅、灵活可扩展的 API
  • 用户管理
  • RBAC 权限管理,支持无限极权限节点
  • 菜单管理
  • 使用 pjax 构建无刷新页面,支持 按需加载 静态资源,可以无限扩展组件而不影响整体性能
  • 松耦合的页面构建与数据操作设计,可轻松切换数据源
  • 自定义页面
  • 自定义主题配色
  • 多主题切换功能,内置多种主题色
  • 可轻松构建无菜单栏的独立页面(如可用于构建弹窗选择器等功能)
  • 插件功能
  • 可视化代码生成器,可根据数据表一键生成增删改查页面
  • 数据表格构建工具,内置丰富的表格常用功能(如组合表头、数据导出、搜索、快捷创建、批量操作等)
  • 树状表格功能构建工具,支持分页和点击加载
  • 数据表单构建工具,内置丰富的表单类型,支持表单异步提交
  • 分步表单构建工具
  • 弹窗表单构建工具
  • 数据详情页构建工具
  • 无限层级树状页面构建工具,支持用拖拽的方式实现数据的层级、排序等操作
  • 内置丰富的常用页面组件(如图表、数据统计卡片、下拉菜单、Tab 卡片、提示工具等)
  • Section 功能(类似 WordpressFilterblade 模板的 section 标签)
  • 异步文件上传表单,支持分块多线程上传
  • 多应用
  • 插件市场,只需在管理页面轻轻点击鼠标即可完成插件的安装、更新和卸载等操作

环境

  • PHP >= 7.1.0
  • Laravel 5.5.0 ~ 8.*
  • Fileinfo PHP 扩展

安装

如果安装过程中出现 composer 下载过慢或安装失败的情况,请运行命令 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/composer 镜像更换为阿里云镜像。

首先需要安装 laravel 框架,如已安装可以跳过此步骤。如果您是第一次使用 laravel,请务必先阅读文档 安装 《Laravel中文文档》

composer create-project --prefer-dist laravel/laravel 项目名称 7.*
#
composer create-project --prefer-dist laravel/laravel 项目名称

安装完 laravel 之后需要修改 .env 文件,设置数据库连接设置正确

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=dcat-admin
DB_USERNAME=root
DB_PASSWORD=

安装 dcat-admin

cd {项目名称}

composer require dcat/laravel-admin

然后运行下面的命令来发布资源:

php artisan admin:publish

该命令会生成配置文件 config/admin.php,可以在里面修改安装的地址、数据库连接、以及表名,建议都是用默认配置不修改。

然后运行下面的命令完成安装:

执行这一步命令可能会报以下错误 Specified key was too long ... 767 bytes,如果出现这个错误,请在 app/Providers/AppServiceProvider.php 文件的 boot 方法中加上代码 \Schema::defaultStringLength(191);,然后删除掉数据库中的所有数据表,再重新运行一遍 php artisan admin:install 命令即可。

php artisan admin:install

上述步骤操作完成之后就可以配置 web 服务了,注意需要把 web 目录指向 public 目录!如果用的是 nginx,还需要在配置中加上伪静态配置

location / {
	try_files $uri $uri/ /index.php?$query_string;
}

启动服务后,在浏览器打开 https:///admin,使用用户名 admin 和密码 admin 登录。

扩展

鸣谢

Dcat Admin 基于以下组件

贡献者

代码贡献者

该项目得益于所有贡献者的努力。[贡献]. []

财务贡献者

成为财务贡献者,帮助我们维持社区。[贡献]

个人

组织

用您的组织支持此项目。您的标志将在这里显示,并链接到您的网站。[贡献]

许可协议

dcat-admin 采用 MIT 许可协议 (MIT) 许可。