v1.5.6 2017-10-26 08:42 UTC

README

Build Status StyleCI Scrutinizer Code Quality Packagist Total Downloads

laravel-admin 是一个用于 Laravel 的管理界面构建器,只需几行代码即可帮助您构建 CRUD 后端。

演示使用 用户名/密码:admin/admin

灵感来自 SleepingOwlAdminrapyd-laravel

中文文档

屏幕截图

laravel-admin

安装

首先,安装 Laravel,并确保数据库连接设置正确。

Laravel 5.2
composer require encore/laravel-admin "dev-master"

Laravel 5.3
composer require encore/laravel-admin "1.3.x-dev"

Laravel 5.1
composer require encore/laravel-admin "1.1.x-dev"

config/app.php 中添加 ServiceProvider

Encore\Admin\Providers\AdminServiceProvider::class

然后运行以下命令来完成安装:

php artisan vendor:publish --tag=laravel-admin
php artisan admin:install

在浏览器中打开 https:///admin/,使用用户名 admin 和密码 admin 登录。

默认设置

位于 config/admin.php 的文件包含一组设置,您可以在其中找到默认设置。

文档

目录结构

安装后,您可以在 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

您可以按照以下步骤设置 users 表的 CURD 接口

1.添加控制器

使用以下命令为 App\User 模型创建控制器

php artisan admin:make UserController --model=App\\User

上述命令将在 app/Admin/Controllers/UserController.php 中创建控制器。

2.添加路由

app/Admin/routes.php 中添加路由:

$router->resource('users', UserController::class);

3.添加左侧菜单项

打开 https://:8000/admin/auth/menu,添加菜单链接并刷新页面,然后在左侧菜单栏中找到链接项。

4.构建网格和表单

其余工作需要在 app/Admin/Contollers/UserController.php 中完成,找到 form()grid() 方法,并编写几行带有 model-gridmodel-form 的代码,更多详情请参阅 模型网格模型表单

其他

laravel-admin 基于以下插件或服务

许可证

laravel-admin 根据 MIT 许可证 (MIT) 许可。