dukeann / laradmin
The Laravel admin.
Installs: 16
Dependents: 0
Suggesters: 0
Security: 0
Stars: 195
Watchers: 18
Forks: 53
Open Issues: 2
Type:project
Requires
- php: >=5.6.4
- arcanedev/log-viewer: ~4.0
- barryvdh/laravel-ide-helper: ^2.2
- hieu-le/active: ^3.3
- intervention/image: ^2.3
- laravel/framework: 5.4.*
- laravel/tinker: ^1.0
- laravelchen/laravel-editormd: ^2.0
- phpoffice/phpexcel: ~1.0
- predis/predis: ^1.1
- prettus/l5-repository: ^2.6
- yajra/laravel-datatables-oracle: ~7.0
- zizaco/entrust: 5.2.x-dev
Requires (Dev)
- fzaninotto/faker: ~1.4
- mockery/mockery: 0.9.*
- phpunit/phpunit: ~5.7
This package is auto-updated.
Last update: 2024-11-10 16:44:22 UTC
README
必须使用redis缓存,文件和数据库缓存不支持 tags()
windows redis 下载地址:http://pan.baidu.com/s/1i56thcD
快速使用 Redis 缓存以及 lv5 中的 Redis 缓存:https://laravel-china.org/topics/877
前端模板请自行购买,如有侵权请联系作者。
使用扩展
用户权限角色扩展:zizaco/entrust
redis扩展:predis/predis
菜单选中激活扩展:hieu-le/active
数据库扩展:prettus/l5-repository
查询返回的数组格式
架构依赖说明:http://oomusou.io/laravel/laravel-architecture/
jQuery DataTables API for Laravel:yajra/laravel-datatables-oracle
日志读取扩展:arcanedev/log-viewer
app日志配置'log' => env('APP_LOG', 'daily'),
图片处理扩展:intervention/image
PHP Redis 扩展
PHP cURL 扩展
PHP OpenSSL 扩展
PHP fileinfo 拓展 素材管理模块需要用到
https://datatables.yajrabox.com
行内编辑:https://vitalets.github.io/x-editable/docs.html
升级日志
https://github.com/DukeAnn/Laradmin/blob/master/UpdateLog.md
安装方法
1.拉取代码到本地,
2.composer install
3.设置 .evn
配置文件连接数据库和默认邮件发送服务器,设置APP_URL=http://laradmin.app
,执行php artisan key:generate
生成key。
4.运行迁移和填充
5.php artisan migrate --seed
安装完成
测试账号:直接右上角注册即可
基本说明
1.权限管理扩展不使用l5数据库扩展。
2.后台左侧菜单自动对应选中状态要求网站全部路由都要命名,并且同一菜单选项下的路由命名前缀一致,
比如:admin.index
,admin.create
,admin.show
,admin.edit
等,资源型路由自动命名。
后台左侧菜单上显示的都是index结尾的路由名。程序定向跳转时使用 route();
。
顶级菜单下子分类的权限如果都被禁止了,请添加顶级菜单的用户权限,并设置成用户无权限,就不在显示该菜单。
后台菜单显示原理,通过菜单uri查询用户权限,如果设置了该权限,进行验证是否有权限,没有就不显示,如果没设置就默认无权限要求。
有子类的菜单项设置的uri不会输出在html中,只会输出一个JavaScript:;所以设置成不存在的路由名也不会报错,无子菜单的uri会用route()函数解析,
如果路由名不存在会报错。
3.页面内面包屑写入语言包,语言包中名称对应Route::currentRouteName();
的值(路由名称),靠服务注入生成面包屑App\Presenters\Admin\CrumbsService
,语言包中没定义的直接显示语言包的健值。
4.路由不可以用闭包路由,路由必须命名否则Route::currentRouteName();
无法生效,并且权限验证和菜单跳转全部使用的都是路由名称。
5.权限认证使用权限绑定路由名在app/Http/Middleware/CheckPermission.php
中间件中验证,表单提交权限放在app/Http/Requests
中验证,如果路由名未绑定权限将不做权限限制。
6.后台添加菜单时不允许添加为存在的路由名称,否则网站会崩掉。因为添加完菜单就会在左侧显示,但是路由名不存在就无法解析导致报错。如果不小心写错,要执行 php artisan cache:clear
清除缓存,并删除数据库中插入的错误数据!刷新页面即可。
###json格式通用于API
{ "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": { ... } }
####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解析
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文件
php artisan make:repository name
,生成模型文件,数据库迁移文件,Repository下面的两个文件