cyd622 / laravel-admin
Laravel Admin
Requires
- php: >=5.6.4
- laravel/framework: 5.4.*
- symfony/dom-crawler: 3.1.*
Requires (Dev)
- fzaninotto/faker: ~1.4
- intervention/image: ~2.3
- laravel/browser-kit-testing: ^1.0
- laravel/laravel: 5.4.*
- phpunit/phpunit: ~5.0
- symfony/css-selector: 2.8.*|3.0.*
This package is not auto-updated.
Last update: 2024-12-22 04:27:27 UTC
README
laravel-admin
是一个可以快速帮你构建后台管理的工具,它提供的页面组件和表单元素等功能,能帮助你使用很少的代码就实现功能完善的后台管理功能。
Demo 账号/密码:admin/admin
Inspired by SleepingOwlAdmin and rapyd-laravel.
安装
首先确保安装好了laravel5.4
,并且数据库连接设置正确。
仅支持 Laravel 5.4
composer require cyd622/laravel-admin "dev-master"
在config/app.php
加入ServiceProvider
:
Encore\Admin\Providers\AdminServiceProvider::class
然后运行下面的命令完成安装:
php artisan vendor:publish --tag=laravel-admin
php artisan admin:install
启动服务后,在浏览器打开 http://localhost/admin/
,使用用户名 admin
和密码 admin
登陆.
默认配置
安装完成之后,laravel-admin
所有的配置都在config/admin.php
文件中。
存储配置
本地上传 先添加存储配置,config/filesystems.php 添加一项disk:
'disks' => [
... ,
'admin' => [
'driver' => 'local',
'root' => public_path('upload'),
'visibility' => 'public',
],
],
设置上传的路径为public/upload
(public_path('upload'))。
然后选择上传的disk,打开config/admin.php
找到:
'upload' => [
'disk' => 'admin',
'directory' => [
'image' => 'image',
'file' => 'file',
],
'host' => 'http://localhost:8000/upload/',
],
将disk设置为上面添加的admin,directory.image
和directory.file
分别为用$form->image($column)和$form->file($column)上传的图片和文件的上传目录
host
为图片和文件的网络访问url前缀。
云盘上传 如果需要上传到云存储,需要安装对应laravel storage的适配器,拿七牛云存储举例
首先安装 zgldh/qiniu-laravel-storage
同样配置好disk,在config/filesystems.php
添加一项:
'disks' => [
... ,
'qiniu' => [
'driver' => 'qiniu',
'domains' => [
'default' => 'xxxxx.com1.z0.glb.clouddn.com', //你的七牛域名
'https' => 'dn-yourdomain.qbox.me', //你的HTTPS域名
'custom' => 'static.abc.com', //你的自定义域名
],
'access_key'=> '', //AccessKey
'secret_key'=> '', //SecretKey
'bucket' => '', //Bucket名字
'notify_url'=> '', //持久化处理回调地址
],
],
然后修改Laravel-Admin的上传配置,打开config/admin.php
找到:
'upload' => [
'disk' => 'qiniu',
'directory' => [
'image' => 'image',
'file' => 'file',
],
'host' => 'http://of8kfibjo.bkt.clouddn.com/',
],
disk选择上面配置的qiniu
,host
配置为七牛云存储的测试域名。
使用文档
目录结构
安装完成之后,后台的安装目录为app/Admin
,之后大部分的后台开发编码工作都是在这个目录下进行。
app/Admin
├── Controllers
│ ├── ExampleController.php
│ └── HomeController.php
└── routes.php
app/Admin/routes.php
文件用来配置后台路由,详细使用请阅读路由配置。
app/Admin/Controllers
目录用来存放后台路由器文件,该目录下的HomeController.php
文件是后台首页的显示控制器,ExampleController.php
为实例文件。
快速开始
用Laravel
自带的users
表举例,表结构为:
CREATE TABLE `users` ( `id` int(10) unsigned NOT NULL AUTO_INCREMENT, `name` varchar(255) COLLATE utf8_unicode_ci NOT NULL, `email` varchar(255) COLLATE utf8_unicode_ci NOT NULL, `password` varchar(60) COLLATE utf8_unicode_ci NOT NULL, `remember_token` varchar(100) COLLATE utf8_unicode_ci DEFAULT NULL, `created_at` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00', `updated_at` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00', PRIMARY KEY (`id`), UNIQUE KEY `users_email_unique` (`email`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci
对应的数据模型为文件 App\User.php
laravel-admin
可以通过使用以下几步来快速生成users
表的CURD
操作页面:
1.添加路由器
使用下面的命令来创建一个对应App\User
模型的路由器
php artisan admin:make UserController --model=App\\User
上面的命令会创建路由器文件app/Admin/Controllers/UserController.php
.
2.添加路由配置
在laravel-admin
的路由配置文件app/Admin/routes.php
里添加一行:
$router->resource('users', UserController::class);
3.添加左侧菜单栏连接
打开http://localhost:8000/admin/auth/menu
,添加对应的menu
然后就能在后台管理页面的左侧边栏看到用户管理页面的链接入口了。
4.创建表格表单
剩下的工作就是构建数据表格和表单了,打开 app/Admin/Contollers/UserController.php
,找到form()
和grid()
方法,然添加构建代码,更多详细使用请查看model-grid和model-form。
其它
laravel-admin
基于以下组件或者服务: