README

laravel-admin 是一个用于 Laravel 的管理界面构建器，它可以帮助您通过几行代码就构建出 CRUD 后端。

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

受 SleepingOwlAdmin 和 rapyd-laravel 启发。

中文文档

截图

安装

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

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

Laravel 5.2
composer require encore/laravel-admin "1.2.*"

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

在 config/app.php 中添加 ServiceProvider

Encore\Admin\Providers\AdminServiceProvider::class

然后运行以下命令以发布资源和配置：

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

运行命令后，您可以在 config/admin.php 中找到配置文件，在此文件中您可以更改安装目录、数据库连接或表名。

最后运行以下命令来完成安装。

php artisan admin:install

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

默认设置

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

文档

• 快速入门
• 路由
• 菜单
• 布局
• 模型网格
  • 行操作
  • 扩展列
  • 自定义工具
• 模型表单
  • 表单字段
  • 图像/文件上传
  • 字段管理
  • 表单回调
• 模型树
• 小部件
  • 表格
  • 表单
  • 框
  • 信息框
  • 选项卡
  • 轮播
  • 折叠
  • 图表 TODO
• RBAC

目录结构

安装后，您可以在 app/Admin 目录下找到目录，然后我们的大部分开发工作都位于此目录下。

app/Admin
├── Controllers
│   ├── ExampleController.php
│   └── HomeController.php
├── bootstrap.php
└── routes.php

app/Admin/routes.php 用于定义路由，有关更多详细信息，请参阅 路由。

app/Admin/bootstrap.php 是 laravel-admin 的引导程序，更多用法请参阅其中的注释。

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

您可以通过以下步骤设置 CURD 接口

1. 添加控制器

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

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

// under windows use:
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/Controllers/UserController.php 中完成，找到 form() 和 grid() 方法，并使用 model-grid 和 model-form 编写几行代码，有关更多详细信息，请参阅 模型网格 和 模型表单。

其他

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

• Laravel
• AdminLTE
• Datetimepicker
• font-awesome
• moment
• Google map
• Tencent map
• bootstrap-fileinput
• jquery-pjax
• Nestable
• toastr
• X-editable
• bootstrap-number-input
• fontawesome-iconpicker

许可证

laravel-admin遵循MIT许可证（MIT）。