基于laravel5.4的后台管理系统
必须使用redis缓存,文件和数据库缓存不支持 tags(), (*1)
windows redis 下载地址:http://pan.baidu.com/s/1i56thcD, (*2)
快速使用 Redis 缓存以及 lv5 中的 Redis 缓存:https://laravel-china.org/topics/877, (*3)
前端模板请自行购买,如有侵权请联系作者。, (*4)
使用扩展
用户权限角色扩展:zizaco/entrust
, (*5)
redis扩展:predis/predis
, (*6)
菜单选中激活扩展:hieu-le/active
, (*7)
数据库扩展:prettus/l5-repository
查询返回的数组格式, (*8)
架构依赖说明:http://oomusou.io/laravel/laravel-architecture/, (*9)
jQuery DataTables API for Laravel:yajra/laravel-datatables-oracle
, (*10)
日志读取扩展:arcanedev/log-viewer
app日志配置'log' => env('APP_LOG', 'daily'),, (*11)
图片处理扩展:intervention/image
, (*12)
PHP Redis 扩展, (*13)
PHP cURL 扩展, (*14)
PHP OpenSSL 扩展, (*15)
PHP fileinfo 拓展 素材管理模块需要用到, (*16)
http://datatables.club/, (*17)
https://datatables.yajrabox.com, (*18)
行内编辑:https://vitalets.github.io/x-editable/docs.html, (*19)
升级日志
https://github.com/DukeAnn/Laradmin/blob/master/UpdateLog.md, (*20)
安装方法
1.拉取代码到本地,, (*21)
2.composer install
, (*22)
3.设置 .evn
配置文件连接数据库和默认邮件发送服务器,设置APP_URL=http://laradmin.app
,执行php artisan key:generate
生成key。, (*23)
4.运行迁移和填充, (*24)
5.php artisan migrate --seed
, (*25)
安装完成, (*26)
演示地址:http://admin.amyair.cn, (*27)
测试账号:直接右上角注册即可, (*28)
基本说明
1.权限管理扩展不使用l5数据库扩展。, (*29)
2.后台左侧菜单自动对应选中状态要求网站全部路由都要命名,并且同一菜单选项下的路由命名前缀一致,
比如:admin.index
,admin.create
,admin.show
,admin.edit
等,资源型路由自动命名。
后台左侧菜单上显示的都是index结尾的路由名。程序定向跳转时使用 route();
。
顶级菜单下子分类的权限如果都被禁止了,请添加顶级菜单的用户权限,并设置成用户无权限,就不在显示该菜单。
后台菜单显示原理,通过菜单uri查询用户权限,如果设置了该权限,进行验证是否有权限,没有就不显示,如果没设置就默认无权限要求。
有子类的菜单项设置的uri不会输出在html中,只会输出一个JavaScript:;所以设置成不存在的路由名也不会报错,无子菜单的uri会用route()函数解析,
如果路由名不存在会报错。, (*30)
3.页面内面包屑写入语言包,语言包中名称对应Route::currentRouteName();
的值(路由名称),靠服务注入生成面包屑App\Presenters\Admin\CrumbsService
,语言包中没定义的直接显示语言包的健值。, (*31)
4.路由不可以用闭包路由,路由必须命名否则Route::currentRouteName();
无法生效,并且权限验证和菜单跳转全部使用的都是路由名称。, (*32)
5.权限认证使用权限绑定路由名在app/Http/Middleware/CheckPermission.php
中间件中验证,表单提交权限放在app/Http/Requests
中验证,如果路由名未绑定权限将不做权限限制。, (*33)
6.后台添加菜单时不允许添加为存在的路由名称,否则网站会崩掉。因为添加完菜单就会在左侧显示,但是路由名不存在就无法解析导致报错。如果不小心写错,要执行 php artisan cache:clear
清除缓存,并删除数据库中插入的错误数据!刷新页面即可。, (*34)
json格式通用于API
``` json
{
"code": 0,
"url": http://...
"message": "...",
"errors": [
{
"code": 10000,
"field": "user",
"message": "用户 不存在。"
}
],
"pagination": {
"total": 10,
"per_page": 10,
"current_page": 1,
"last_page": 1,
"from": 1,
"to": 10
},
"data": {
...
}
}, (*35)
####json返回值说明
`code`处理结果状态码,成功为 0,必填
`url`处理成功之后的跳转地址,可不填
`message`处理完成的通知信息,可不填
`errors`请求报错信息
`pagination`请求的分页信息
`data`请求的数据信息
`errors`和`data`不能同时存在
返回使用
`return response(['code' => -1, 'message' => '账号或者密码错误'], 400);` 自动转换成json
或者
`return response()->json(['code' => -1, 'message' => '账号或者密码错误'], 400);`
AJAX解析
``` javascript
var settings = {
type: "POST",
data:{},
url: url,
dataType: "json",
success: function (data) {
if (data.code == 0) {
window.location.href = data.url;
}
},
error: function (XMLHttpRequest) {
$('#login-error').show();
if (XMLHttpRequest.responseJSON.code == -1){
$('#login-error-message').text(XMLHttpRequest.responseJSON.message);
} else {
$('#login-error-message').text("请填写邮箱和密码");
}
},
headers: {
'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
}
};
$.ajax(settings)
数据库模型创建命令
php artisan make:entity name
,自动创建模型文件,数据库迁移文件,Repository下面的两个文件,Providers文件,可选生成Presenter,Validator,Controller文件, (*36)
php artisan make:repository name
,生成模型文件,数据库迁移文件,Repository下面的两个文件, (*37)