快速开始

在日常开发中，我们可以用代码生成器一键生成增删改查页面代码，非常的方便快捷。

下面将会给大家介绍代码生成器的使用方法，以及一个增删改查页面的基本构成。通过学习下面的内容将可以帮助大家快速理解这个系统的基本使用方法。

代码生成器

创建数据表

安装完Laravel之后会内置一个users表的migration文件(如果不了解migration文件作用，请参考文档数据库迁移)，文件路径为database/migrations/2014_10_12_000000_create_users_table.php。

然后我们运行以下命令，在MySQL中创建这个数据表

  1. php artisan migrate

运行完之后可以看到数据库中已经多了一个users表，结构如下

  1. CREATE TABLE `users` (
  2.   `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
  3.   `name` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
  4.   `email` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
  5.   `password` varchar(60) COLLATE utf8_unicode_ci NOT NULL,
  6.   `remember_token` varchar(100) COLLATE utf8_unicode_ci DEFAULT NULL,
  7.   `created_at` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00',
  8.   `updated_at` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00',
  9.   PRIMARY KEY (`id`),
  10.   UNIQUE KEY `users_email_unique` (`email`)
  11. ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci

一键生成增删改查页面

{tip} 如果你的开发环境不是windows，请注意要给项目目录设置读写权限，否则可能出现无法生成代码的情况。

1.首先打开地址http://你的域名/admin/helpers/scaffold，进入代码生成器页面；

2.由于前面已经创建好了数据表，所以这里我们可以直接通过页面左上角的第二个下拉选框选择users表，选择之后会自动填充字段信息，效果如下

快速开始 - 图1

3.修改模型名称为App\User

4.由于migration文件、数据表、以及模型文件(使用内置的App\User即可)都已经有了，所以此处我们可以把这三个选项给去掉

5.填写字段翻译

最后呈现效果如下

快速开始 - 图2

最后点击创建按钮即可，创建的文件如下

  1. app/Admin
  2. ├── Controllers
  3. │   └── UserController.php  # 控制器
  4. └── Repositories            # 数据仓库
  5. │   └── User.php
  6. resouces/lang/{当前语言}
  7. └── user.php                # 语言包

添加路由配置

打开路由配置文件app/Admin/routes.php，往里面添加一行：

  1. $router->resource('users', 'UserController');

到此，就可以打开浏览器输入地址http://你的域名/admin/users访问刚刚创建完的页面了

添加左侧菜单

打开http://你的域名/admin/auth/menu，添加对应的menu, 然后就能在后台管理页面的左侧边栏看到用户管理页面的链接入口了。

其中uri填写不包含路由前缀的的路径部分，比如完整路径是http://你的域名/admin/demo/users, 那么就填demo/users，如果要添加外部链接，只要填写完整的url即可，比如http://dcat-admin.org/.

菜单翻译

在您的语言文件的menu_titles索引中追加菜单标题。 例如“工作单位”标题：

在resources/lang/{当前语言}/menu.php中

  1. ...
  2. // 用_小写并用_替换空格
  3. 'titles' => [
  4.     'work_units' => 'Unidades de trabajo'
  5. ],

完成

这样一个简单的CURD功能就构建完成了，剩下的工作就是深度构建数据表格和表单了，打开 app/Admin/Contollers/UserController.php,找到form()和grid()方法，然添加构建代码。 更多详细使用请查看数据表格和数据表单。

增删改查功能简易说明

为了便于大家理解增删改查功能的基本用法，下面将给大家简单介绍前面使用生成器生成的代码。

控制器

Dcat Admin的增删改查页面代码是非常简洁和易懂的，对开发者非常的友好，只需极少的代码即可构建出一个功能完善的后台系统，并且非常简单灵活和易于扩展。

打开app/Admin/Controllers/UserController.php可以看到如下代码

  1. <?php
  3. namespace App\Admin\Controllers;
  5. use App\Admin\Repositories\User;
  6. use Dcat\Admin\Form;
  7. use Dcat\Admin\Grid;
  8. use Dcat\Admin\Show;
  9. use Dcat\Admin\Http\Controllers\AdminController;
  11. class UserController extends AdminController
  12. {
  13.     /**
  14.      * Make a grid builder.
  15.      *
  16.      * @return Grid
  17.      */
  18.     protected function grid()
  19.     {
  20.         return Grid::make(new User(), function (Grid $grid) {
  21.             // 这里的字段会自动使用翻译文件
  22.             $grid->column('id')->sortable();
  23.             $grid->column('name');
  24.             $grid->column('email');
  25.             $grid->column('email_verified_at');
  26.             $grid->column('password');
  27.             $grid->column('remember_token');
  28.             $grid->column('created_at');
  29.             $grid->column('updated_at')->sortable();
  31.             $grid->filter(function (Grid\Filter $filter) {
  32.                 $filter->equal('id');
  34.             });
  35.         });
  36.     }
  38.     /**
  39.      * Make a show builder.
  40.      *
  41.      * @param mixed $id
  42.      *
  43.      * @return Show
  44.      */
  45.     protected function detail($id)
  46.     {
  47.         return Show::make($id, new User(), function (Show $show) {
  48.             // 这里的字段会自动使用翻译文件
  49.             $show->field('id');
  50.             $show->field('name');
  51.             $show->field('email');
  52.             $show->field('email_verified_at');
  53.             $show->field('password');
  54.             $show->field('remember_token');
  55.             $show->field('created_at');
  56.             $show->field('updated_at');
  57.         });
  58.     }
  60.     /**
  61.      * Make a form builder.
  62.      *
  63.      * @return Form
  64.      */
  65.     protected function form()
  66.     {
  67.         return Form::make(new User(), function (Form $form) {
  68.             // 这里的字段会自动使用翻译文件
  69.             $form->display('id');
  70.             $form->text('name');
  71.             $form->text('email');
  72.             $form->text('email_verified_at');
  73.             $form->text('password');
  74.             $form->text('remember_token');
  76.             $form->display('created_at');
  77.             $form->display('updated_at');
  78.         });
  79.     }
  80. }

数据仓库

Dcat Admin 构建页面并不直接依赖于Model，而是引入了数据仓库作为中间层，让页面的构建不再与数据的读写产生强耦合关系。

数据仓库是Dcat Admin中对数据增删改查操作接口的具体实现，更详细用法请参考数据仓库。

{tip} 如果你的数据来自MySQL，那么你也可以直接使用Model实例，底层会自动把Model转化为数据仓库实例。这里为了便于大家理解其中的概念，所以创建了数据仓库文件。

我们打开刚刚生成的文件app/Admin/Repositories/User.php，可以看到只有如下内容，非常简单

  1. <?php
  3. namespace App\Admin\Repositories;
  5. use Dcat\Admin\Repositories\EloquentRepository;
  6. use App\User as UserModel;
  8. class User extends EloquentRepository
  9. {
  10.     protected $eloquentClass = UserModel::class;
  11. }

语言包

每个控制器都可以生成自己对应的语言包，并且数据表格、数据表单和数据详情功能都会自动读取里面的翻译。

下面我们打开UserController对应的语言包文件resouces/lang/{当前语言}/user.php

  1. <?php 
  2. return [
  3.     // labels是自定义标签翻译
  4.     'labels' => [
  5.         // 这个是页面 title 翻译
  6.         'User' => '用户',
  7.     ],
  8.     // 表字段翻译
  9.     'fields' => [
  10.         'name' => '名称',
  11.         'email' => '邮箱',
  12.         'email_verified_at' => '验证时间',
  13.         'password' => '密码',
  14.         'remember_token' => 'remember_token',
  15.     ],
  16.     'options' => [
  17.     ],
  18. ];