CRUD生成器DBuilder设计与实现

绝地灬酷狼 2022-02-12 12:51 135阅读 0赞

源码位于github：[https://github.com/lvyahui8/dbuilder.git][https_github.com_lvyahui8_dbuilder.git] 。文中图片如果太小看不清楚，请右键点击“在新标签页中打开”即可看到原图

有兴趣还可以加QQ群交流：146103720 [ DBuilder交流群][DBuilder]

# 第一章 引言 #

## 1.1 研究背景及意义 ##

计算机软件技术发展至今，数据库已成为最广泛使用的存储格式化数据的媒介，数据库程序开发技术也日趋完善，大型的ORM框架使得数据库程序开发变得简单，并已成为操作关系型数据库的主流方式。数据库程序主要代码为CRUD(create, retrieve, update, delete)代码，随着ORM框架功能的完善，编写CRUD代码也衍生其固定的流程，对不同数据库表进行操作的CRUD代码也存在高度可重用性。当前编写重复性的CRUD代码成为开发人员的常态，不仅严重降低其积极性，而且损失其开发效率，所以迫切需要一种能够快速生成CRUD代码的产品，以期减少这方面的工作，提高开发效率。

## 1.2 研究现状 ##

目前国外已经诞生一些解决上述需求的、具有很高可用性的CRUD生成器产品：CrudKit，CRUD-Admin-Generator，Dadabik，GroceryCrud，SximoBuilder。这些产品各有其特点，但也有一共同点：都是基于PHP进行开发（这在一定程度上决定于PHP语法的灵活性及其解析性）。SximoBuilder是其中的典型代表，尽管SximoBuilder设计独特、可用性高、流行度高，但也存在如下不足之处：

*  不支持自定义表单控件；
 *  不支持多数据库；
 *  验证规则不完善，不支持异步验证；
 *  代码冗余度极大。

然而对于当今日益复杂的web程序，上述几点是开发过程必须考虑的问题，因此，开发一款既具有SximoBuilder现有功能、又完善其不足之处的CRUD生成器产品，势在必行。

## 1.3 研究内容 ##

基于国内外CRUD生成器研究现状，笔者开发一款名为DBuilder（D为DataAdministrator的简写）的CRUD 生成器。

DBuilder借鉴SximoBuilder的模块为代码单元、由模板生成代码的思想，但拥有与SximoBuilder完全不同的代码生成器逻辑。它在实现SximoBuilder核心的代码生成、通用CRUD两种功能的基础上，通过重写代码逻辑完善其不足之处：代码冗余度大、缺少前端验证。

# 第二章 DBuilder系统分析 #

DBuilder面向的主要用户人群为web后台管理员以及开发人员，因此其系统分析过程，将更多的站在web后台管理员及开发人员的角度考虑问题。

## 2.1 需求分析 ##

项目需要实现如下几点核心功能。

**1)** **数据源管理**

用户可以在界面为项目配置多个数据源。配置的数据源信息包括数据库类型、地址、数据库名、端口、用户名、密码等信息。支持对数据源的增删改查，保证对数据源的增删改查不轻易造成系统问题。

2) **代码生成**

此功能是DBuilder的核心要实现的功能，用户在选择数据源和数据表之后，能够对数据库表的字段做简单配置，配置包括Form表单配置、List（Table）列表配置、关系配置、全局属性配置。配置完成后DBuilder要能生成对数据库表的CRUD的MVC代码，即需要实现CRUD可用功能，但不用编写代码。

3) **数据库**表CRUD

生成的代码必须支持数据表记录的新建、删除、更新、查询操作。

4) **菜单管理**

DBuilder要能将生成的代码跟一个菜单项绑定，让用户点击菜单项之后，就可以使用DBuilder生成的CRUD功能。此菜单必须包括后台菜单，前台菜单不是必须的。

5) **用户管理**

用户要实现多种角色。必须能够以邮箱为用户唯一标识，并作为登录参数。未来还要实现支持QQ、微信、新浪微博基于OAuth2.0的互联登录。

6) **权限管理**

DBuilder要能实现不同用户角色对不同CRUD代码的执行、访问权限做到三维的可配置。譬如，现有一个文章管理的CRUD功能模块，用户角色分为系统管理员（SuperAdmin），管理员（Admin），访客（Guest），那么DBuilder要能实现如下的三维权限配置，且将之作为所有Module的默认权限。

表2-1 Module权限配置表

<table> 
 <tbody> 
  <tr> 
   <td> <p>用户组与权限</p> </td> 
   <td> <p>查看</p> </td> 
   <td> <p>编辑</p> </td> 
   <td> <p>删除</p> </td> 
   <td> <p>导出</p> </td> 
  </tr> 
  <tr> 
   <td> <p>SuperAdmin</p> </td> 
   <td> <p>√</p> </td> 
   <td> <p>√</p> </td> 
   <td> <p>√</p> </td> 
   <td> <p>√</p> </td> 
  </tr> 
  <tr> 
   <td> <p>Admin</p> </td> 
   <td> <p>√</p> </td> 
   <td> <p>√</p> </td> 
   <td> <p>√</p> </td> 
   <td> <p>&nbsp;</p> </td> 
  </tr> 
  <tr> 
   <td> <p>Guest</p> </td> 
   <td> <p>√</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>&nbsp;</p> </td> 
  </tr> 
 </tbody> 
</table>

7) **站点参数配置**

DBuilder作为一个网站的web后台程序，对站点的全局参数配置也是必须的，这些参数包括网站名字、关键词、联系地址、友情链接等等。

8) **操作日志**

DBuilder要记录用户的操作信息，包括访问的页面、执行的CRUD类型、时间等等信息。日志的记录形式支持数据库和文件两种方式。

9) 多**语言支持**

DBuilder要支持多国语言的切换。至少应该支持中文和英语两种语言，且以中文为默认。

10) 多**数据库类型支持**

DBuilder要支持多种类型数据库，暂时主要支持关系型数据库，包括mysql，MS SqlServer，oracle，PostGreSQL等等。

## 2.2 数据原型分析 ##

按照需求提取可得实体有:用户、用户组、数据源、代码模块、菜单，关系有：权限、日志。实体与关系的含义如下：

*  用户：表示使用DBuilder的用户；
 *  用户组：表示用户的类型分组，用户类型应该至少包括访客、管理员、超级管理员三种；
 *  数据源：表示DBuilder包含的数据库配置，一个数据源的配置包含连接一个数据库所需的基本参数；
 *  代码模块：表示DBuilder生成的代码模块，描述了代码文件和配置；
 *  菜单：表示DBuilder的左侧菜单项；
 *  权限：表示用户组对每个代码模块的各种操作权限；
 *  日志：表示用户对每个代码模块的CRUD访问日志。

实体与关系的ER图如下：

![img_f97387ee9c35506cfc2f98699f31a0b6.jpeg][]

图2-1 ER图

## 2.3 原则性要求 ##

DBuilder应该要做成一套高性能、高可用的CRUD生成器，为此DBuilder设计中应该符合下面几项原则：

*  DBuilder要精确到每个数据库字段可配置；
 *  应具备一个WEB后台应用的雏形，使用户可在此基础上快速建立完整的WEB后台应用；
 *  DBuilder要尽可能减少SQL操作，必要时可借助缓存、异步等技术，减少请求的处理逻辑，提高页面效率，减少用户等待时间；
 *  DBuilder要有美观、简洁、直观的用户界面；
 *  DBuilder要留有大量的扩展接口，能够让用户通过二次开发快速实现较为复杂的功能。

# 第三章 DBuilder系统设计 #

## 3.1 系统架构 ##

DBuilder有下面2个核心的构件Core CRUD 模块和GModule，GModule对Core CRUD 模块有继承依赖的关系，GModule由MVC Code和CRUD Config组成；Core CRUD模块是手工编写的代码，而GModule是DBuilder生成的代码；Core CRUD 模块实现CRUD操作，GModule实现扩展功能。下图表示了这两个构件的组成和关系

![img_9ee0ea6aa11a7745949d586c6d4d229e.jpeg][]

图3-1概念与构件

下面对图中设计的概念、构件、模块关系以及Build与CRUD流程做详细阐述。

### 3.1.1 Core CRUD 模块 ###

Core CRUD 模块实现核心CRUD操作，一切对GModule MVC中Controller的CRUD请求，最终转交至Core CRUD 模块进行处理。Core CRUD 模块会开放一些预处理和后处理接口交由GModule实现，这些接口会在Model，Controller，View上都有体现。

Core CRUD 模块主要包括如下文件

*  app/controllers/admin/AdminController.php
 *  app/models/BaseModel.php
 *  app/config/crud/admin.php
 *  app/views/admin/core/list.blade.php
 *  app/views/admin/core/form.blade.php

Core CRUD 模块读取GModule Configuration实现真正的CRUD操作。

### 3.1.2 GModule ###

GModule（Generated Module）不但实现了Core CRUD Module接口（MVC代码），而且具有自己配置文件（CRUD Configuration）。每一GModule表示以一张数据库表为主表，具备CRUD功能的代码文件合集（包括对应的MVC + Configuration代码）。譬如，DBuilder生成的一个GModule， 主表为core数据源user表，名字为User，那么User GModule应包含下面代码文件：

*  controllers/UserController.php
 *  models/User.php
 *  views/user/\_list.blade.php
 *  views/user/\_form.blade.php
 *  views/user/view.blade.php
 *  config/crud/user.php

代码文件命名取决于GModule的名字，故为保证生成的代码文件不冲突，取GModule的名字（GModule Key，GModule Name）作为GModule的唯一标识。每一个GModule的信息都被保存在数据库中。一次新建 GModule操作将会新建上述所有代码文件，更新相关文件，并插入一条GModule记录到数据库。一次更新 GModule操作将只会更新Configuration文件。

GModule 由MVC代码和CRUD Configuration代码组成，下面分别进行阐述：

*  MVC代码：用来实现扩展接口。CRUD请求应最先路由到GModule MVC的中的Controller（控制器）。并且GModule MVC 应与Core CRUD Module的MVC代码有继承关系。
 *  CRUD Configuration代码：实现对GModule主表增删改查参数的配置。该文件放置在app/config/crud/目录下，以php array的格式定义。它包含对所有字段的表单，列表，视图，关系等参数的配置，以及全局的参数配置。

GModule并不表示具体某一个模块，而是代指一类模块，这种模块可以由DBuilder生成，或者由开发人员手工建立。它主要用来实现Core CRUD Module的接口，主要包括下述几部分

1) Controller接口

假设GModule模块的 Controller为A，Core CRUD Module 的Controller为B，则A应继承自B。CRUD请求会先路由到A，而实际的处理者是B。A会实现B开放的下列接口。

*  beforeListExcuteQuery(&querier)：该接口在List查询器执行查询之前调用，传递的参数为查询器引用。用来在查询之前，绑定特殊的查询参数。
 *  beforeList(&data)：该接口在List查询器执行之后，渲染List视图之前调用。传递的参数为视图参数引用，其中包括查询出的model集合。用来对查询的model 集合做后处理，或者对list视图绑定一些Module专有的参数。
 *  beforeEditExcuteQuery(&querier)：该接口在Edit请求中Model查询器执行查询之前调用，传递的是查询器引用。用来绑定查询model需要的特殊参数。
 *  beforeEdit(&data)：该接口在Edit中Model查询器执行之后，渲染视图之前调用，传递的是视图参数引用，其中包括查询器查询出的model。用来做渲染前的预处理。
 *  afterSave(&model)：该接口在Edit中，保存编辑的之后调用，传递的是保存在数据库中，最新的数据库记录持久化的model。用来对model做一些复杂的后级联处理。
 *  beforeView(data)： 该接口在View请求中，View 查询器查询之后调用，传递的是视图参数的引用。用来对视图显示做预处理。

2) Model 接口

GModule MVC代码中的Model也继承自BaseModel，实现 BaseModel类开放的一些接口可以完成扩展。

formatXXXAttribute()：该接口用来格式化某个字段。本产品基于Laravel，其已经具备类似的接口，就是getXXXXAttribute()。但这样的接口的优先级比字段优先级高，这在特殊的情况下为开发带来了不便，所以再设计一个类似的接口，该接口的优先级低于字段本身。

3) View 接口

视图的扩展接口与前两者不同，主要体现在子视图与视图块上，也就是在Core CURD模块的视图基础上，扩展视图组件。默认Core CRUD MVC视图生成的是一个表格或者一个表单，占满页面。而View接口将提供在该表格上下左右扩展页面组件的能力。

4) Configuration

每一个GModule对应一个Configuration文件，其中包含GModule对主表各个字段的配置参数，以及布局参数。

### 3.1.3 模块关系 ###

CRUD请求路由到GModule的Controller，GModule代码实现Core CRUD MVC开放的接口，而由Core CRUD Module去真正实现对数据库的CRUD操作。每一个GModule的信息应该被记录在数据库表中，以便给GModule关联菜单，控制权限，记录操作日志等等。一些主要模块之间的关系如下图所示。

![img_ae669316687403a70af98e03b2986214.jpeg][]

图3-2模块关系

从图2-2中可以看到，由GModule管理模块根据用户配置来生成一个GModule A，当用户的CRUD请求到达GModule A时，GModule 会讲请求转交Core CRUD进行处理，Core CRUD 模块再以SQL对数据库进行CRUD操作。

### 3.1.4 Build 与 CRUD流程 ###

DBuilder项目的方案，将真正的CRUD操作交给了Core CRUD Module去执行，CRUD参数由GET或者POST请求参数与GModule Configuration构成，而GModule的MVC代码只是去实现Core CRUD MVC开放的一些预处理或者后处理接口。

图2-3是DBuilder最核心的流程图，包含Module的生成和处理CRUD请求的过程，图2-4是SximoBuilder 中Module的生成和处理CRUD请求的流程图。

![img_e0ace3b7be7d1b99057a5e359b485172.jpeg][]

图3-3 DBuilder 代码生成和处理CRUD的流程

![img_38f86277a1c220f8da3c3a4d0ef3f70a.jpeg][]

图3-4 SximoBuilder 代码生成和处理CRUD的流程

对比两者，可以看到两者的最大区别，是DBuilder复用一份CRUD代码，而不是像Sximo那样为每一个Module生成一套可以当独执行的CRUD代码。这样做的好处是提高了复用性,并通过Module CRUD MVC实现预处理/后处理接口达到扩展性的目的。

## 3.2 Core数据源 ##

Core数据源是DBuilder的默认数据源，其类型为mysql，数据库名为dbuilder，本节按照《数据原型分析》一节进行详细的数据库设计。为提高程序性能，数据源信息保存在代码文件app/config/datasource.php中，文件内容如下：

<table> 
 <tbody> 
  <tr> 
   <td> <p>&lt;?php return array (</p> <p>&nbsp;&nbsp;&nbsp; 'core' =&gt;</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; array (</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 'driver' =&gt; 'mysql',</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 'host' =&gt; 'localhost',</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 'database' =&gt; 'dbuilder',</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 'username' =&gt; 'root',</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 'password' =&gt; 'root',</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 'charset' =&gt; 'utf8',</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 'collation' =&gt; 'utf8_unicode_ci',</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 'prefix' =&gt; '',</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 'edit' =&gt; false,</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 'port' =&gt; 3306,</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ),</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; // more data source</p> <p>&nbsp;);</p> </td> 
  </tr> 
 </tbody> 
</table>

其中Core数据源有下述数据表：

1) d\_menu 表：表示后台左侧树形菜单，每一个可点击跳转的菜单项必须与一个Module进行关联。

表3-1 web后台左侧菜单表

<table> 
 <tbody> 
  <tr> 
   <td> <p>field</p> </td> 
   <td> <p>type</p> </td> 
   <td> <p>default</p> </td> 
   <td> <p>info</p> </td> 
  </tr> 
  <tr> 
   <td> <p>id</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>auto_increment</p> </td> 
   <td> <p>PRI</p> </td> 
  </tr> 
  <tr> 
   <td> <p>module_id</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>&nbsp;</p> </td> 
  </tr> 
  <tr> 
   <td> <p>module_name</p> </td> 
   <td> <p>varchar(12)</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>&nbsp;</p> </td> 
  </tr> 
  <tr> 
   <td> <p>parent_id</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>null</p> </td> 
   <td> <p>父菜单项</p> </td> 
  </tr> 
  <tr> 
   <td> <p>title</p> </td> 
   <td> <p>varchar(12)</p> </td> 
   <td> <p>module_title</p> </td> 
   <td> <p>显示名称</p> </td> 
  </tr> 
  <tr> 
   <td> <p>_order</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>0</p> </td> 
   <td> <p>排序字段</p> </td> 
  </tr> 
 </tbody> 
</table>

2) d\_module 表：记录了module信息，每一条d\_module表的记录代表了DBuilder生成的一个Module。

表3-2 module信息描述

<table> 
 <tbody> 
  <tr> 
   <td> <p>field</p> </td> 
   <td> <p>type</p> </td> 
   <td> <p>default</p> </td> 
   <td> <p>info</p> </td> 
  </tr> 
  <tr> 
   <td> <p>id</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>auto_increment</p> </td> 
   <td> <p>PRI</p> </td> 
  </tr> 
  <tr> 
   <td> <p>name</p> </td> 
   <td> <p>varchar(32)</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>UIN</p> </td> 
  </tr> 
  <tr> 
   <td> <p>title</p> </td> 
   <td> <p>varchar(32)</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>module标题</p> </td> 
  </tr> 
  <tr> 
   <td> <p>note</p> </td> 
   <td> <p>varchar(32)</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>module 说明</p> </td> 
  </tr> 
  <tr> 
   <td> <p>db_source</p> </td> 
   <td> <p>varchar(16)</p> </td> 
   <td> <p>core</p> </td> 
   <td> <p>数据源名称</p> </td> 
  </tr> 
  <tr> 
   <td> <p>db_table</p> </td> 
   <td> <p>varchar(16)</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>module主表</p> </td> 
  </tr> 
  <tr> 
   <td> <p>db_table_key</p> </td> 
   <td> <p>varchar(16)</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>主表PRI</p> </td> 
  </tr> 
 </tbody> 
</table>

3) d\_user 表：保存着使用后台程序的用户。

表3-3 web后台用户

<table> 
 <tbody> 
  <tr> 
   <td> <p>field</p> </td> 
   <td> <p>type</p> </td> 
   <td> <p>default</p> </td> 
   <td> <p>info</p> </td> 
  </tr> 
  <tr> 
   <td> <p>id</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>auto_increment</p> </td> 
   <td> <p>PRI</p> </td> 
  </tr> 
  <tr> 
   <td> <p>username</p> </td> 
   <td> <p>varhcar(64)</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>用户名</p> </td> 
  </tr> 
  <tr> 
   <td> <p>email</p> </td> 
   <td> <p>varchar(64)</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>邮箱</p> </td> 
  </tr> 
  <tr> 
   <td> <p>password</p> </td> 
   <td> <p>varchar(64)</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>HASH</p> </td> 
  </tr> 
  <tr> 
   <td> <p>salt</p> </td> 
   <td> <p>varchar(64)</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>盐</p> </td> 
  </tr> 
  <tr> 
   <td> <p>last_login</p> </td> 
   <td> <p>timestamp</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>最后登录时间</p> </td> 
  </tr> 
  <tr> 
   <td> <p>remember_token</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>记住密码口令</p> </td> 
  </tr> 
  <tr> 
   <td> <p>group_id</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>组ID</p> </td> 
  </tr> 
 </tbody> 
</table>

4) d\_group表：表示对后台用户的分组信息。

表3-4 用户分组表

5) d\_group\_access表：记录了每个GModule、不同后台用户组与各种操作权限的三维权限信息。

表3-5 用户组对Module权限表

<table> 
 <tbody> 
  <tr> 
   <td> <p>field</p> </td> 
   <td> <p>type</p> </td> 
   <td> <p>default</p> </td> 
   <td> <p>info</p> </td> 
  </tr> 
  <tr> 
   <td> <p>id</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>auto_increment</p> </td> 
   <td> <p>PRI</p> </td> 
  </tr> 
  <tr> 
   <td> <p>group_id</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>组id</p> </td> 
  </tr> 
  <tr> 
   <td> <p>module_id</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>Module模块ID</p> </td> 
  </tr> 
  <tr> 
   <td> <p>edit</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>1</p> </td> 
   <td> <p>可编辑</p> </td> 
  </tr> 
  <tr> 
   <td> <p>view</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>1</p> </td> 
   <td> <p>可查看</p> </td> 
  </tr> 
  <tr> 
   <td> <p>delete</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>1</p> </td> 
   <td> <p>可删除</p> </td> 
  </tr> 
  <tr> 
   <td> <p>export</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>1</p> </td> 
   <td> <p>可导出</p> </td> 
  </tr> 
 </tbody> 
</table>

6) d\_log表:记录了每个用户的操作日志。

表3-6 用户操作日志

<table> 
 <tbody> 
  <tr> 
   <td> <p>field</p> </td> 
   <td> <p>type</p> </td> 
   <td> <p>default</p> </td> 
   <td> <p>info</p> </td> 
  </tr> 
  <tr> 
   <td> <p>id</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>auto_increment</p> </td> 
   <td> <p>PRI</p> </td> 
  </tr> 
  <tr> 
   <td> <p>user_id</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>用户id</p> </td> 
  </tr> 
  <tr> 
   <td> <p>ip_addr</p> </td> 
   <td> <p>varchar(15)</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>客户端IP</p> </td> 
  </tr> 
  <tr> 
   <td> <p>module_id</p> </td> 
   <td> <p>int</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>访问的moduleid</p> </td> 
  </tr> 
  <tr> 
   <td> <p>module_title</p> </td> 
   <td> <p>varchar(16)</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>&nbsp;</p> </td> 
  </tr> 
  <tr> 
   <td> <p>task</p> </td> 
   <td> <p>varchar(16)</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>操作</p> </td> 
  </tr> 
  <tr> 
   <td> <p>created_at</p> </td> 
   <td> <p>timestamp</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>可导出</p> </td> 
  </tr> 
 </tbody> 
</table>

## 3.3 数据源管理模块 ##

DBuilder需要支持多数据源，多种类型数据库。数据源信息保存在d\_database表中。考虑到数据库操作是频繁操作，如果将数据源信息保存在数据库中，则每次数据库操作将多一次数据源查询操作，这样做浪费性能。那么DBuilder不应该把数据源信息保存在数据库中，而应该保存在代码文件中。数据源管理的信息包括数据源名称（数据源的唯一标识，DBuilder默认的数据源名为core）、数据库类型、地址、端口、数据库名、用户名、密码等等信息。因为数据源管理模块并不对表进行增删改查操作，所以数据源管理模块并不是一个GModule模块。该模块的代码完全手工编写。

## 3.4 GModule 管理模块 ##

DBuilder将以基于名字为“Module”的GModule作为生成GModule的用户接口，该模块称作GModule管理模块，换言之GModule管理模块本身就是一个GModule，该GModule的主表即是core数据源中保存GModule信息的数据库表，改GModule的名字为“Module”。GModule 管理模块包含创建，更新和删除GModule 的所有代码文件以及数据库记录。GModule的新建和删除需要更新全局的GModule路由。

1) GModule 路由

GModule路由定义在一个独立的代码文件中，为一个以GModule名字进行减号分词并全部小写的字符串为键（譬如：GModule名字为OrderItem，则键值为order-item）、以Module中Controller类的类名为值的map字典，GModule路由是全局的。

2) GModule 新建&更新

新建GModule将在数据库中生成一条记录、生成所有的module文件、并更新路由。更新操作只修改配置文件。新建与更新都使用相同的编辑视图，此编辑视图是对GModule Configuration的图形化配置界面。

3) GModule 删除

GModule删除将删除所有的GModule MVC代码，删除GModule Configuration代码，删除数据库表记录，并更新GModule路由。

## 3.5 Core CRUD 模块 ##

Core CRUD 模块是DBuilder处理CRUD请求的实际处理者,它由下述几部分组成：

1) 参数解析初始化

初始化Model，实例化一个Module的Model对象作为初始化查询器。加载Module Configuration，对未设置的值进行设置默认值，对参数进行汇聚。

2) 表单Form

主要包括新建和更新功能。根据GModule主表主键primaryKey是否设置判断是新建还是更新操作。下图是Form模块的流程

![img_1e906b68f960ebe775955734df05cf02.png][]

图3-5 Form执行流程

Form 分两部分，第一部分渲染Form页面给用户填写。第二部分为Form保存。

渲染Form页面需要考虑的有Form控件和有外键关系的字段要怎么处理。Form控件需要支持类型包括text、text\_date、text\_datetime、textarea、select、radio、checkbox、file、hidden、address以及custom，自定义控件应该继承FormControl类，自定义控件的渲染由控件的render方法完成。Form渲染需要判断有关系的字段做辅助加载。比如对post（文章）表进行编辑，post表有一个字段为category\_id，表示文章的栏目ID，对应category（栏目）表的id字段。这时需要对category\_id使用select，radio，checkbox控件进行加载，方便用户输入。比如使用select控件，那么应该将category.id作为option的value，将category.name作为option中的text。这样做也是为了方便用户输入。此步骤与List中搜索时有共性，因此代码可复用。

Form 保存需要考虑一些自定义控件的保存，自定义控件的数保存由自定义控件类的onSave方法完成。Form 保存还需要考虑关系的保存，默认应该级联更新附属表。Form 表单在用户输入完成点击保存之后，要分下面几步：

*  根据字段配置的验证规则进行验证；
 *  应判断Module Configuration 中的relation进行分析，进行必要的级联操作；
 *  并要调用自定义控件的onSave方法；
 *  最后才应更新或新建主表数据；
 *  跳转：更新或新建成功跳转至List，失败跳转至Form。

Form 还需要开放对应的预处理和后处理接口。

3) 列表List（Table）

List是一个分页Table，按照Module Configuration 中的字段配置显示分页数据。支持列表搜索，排序，勾选删除，导出等功能；

*  分页展现数据以InitQuerier模块得到的Model作为查询器，结合分页，查询出基本的数据列表。分页类型为全页刷新类型（非异步分页）；
 *  List搜索：支持在Module Configuration中定义了search不等于false的字段作为搜索条件。搜索关系为逻辑与的关系。并反映在GET参数上。搜索输入控件根据字段的form type来定。在Form 中定义为select，radio，checkbox控件的字段，在List中都将使用select控件作为输入控件；
 *  List 排序：以在Module Configuration中定义了form.sort 不等于 false的字段作为可排序字段。排序只支持按单一字段排序，降序方式含升序和降序；
 *  List 多选操作主要支持多选删除，多选复制操作,任何删除操作都需确认；
 *  List 数据每行记录的支持的操作按Module Configuration中的配置给出，默认支持编辑，删除，查看三项操作；
 *  List 也要开放预处理/后处理接口给Module CRUD MVC。

4) 查看View

View 暂时以Form为基础，提供预处理后处理接口，但不允许编辑。

# 第四章 DBuilder系统实现 #

## 4.1 目录结构 ##

代码按照前段资源、MVC、Configuration、Library等概念进行了分目录存放。下面表格中给出了主要目录的说明：

表4-2 代码主要目录

<table> 
 <tbody> 
  <tr> 
   <td> <p>目录</p> </td> 
   <td> <p>作用</p> </td> 
  </tr> 
  <tr> 
   <td> <p>assets</p> </td> 
   <td> <p>此目录存放着各种各样的前端资源。包括bootstrap，以及自定义的css和js文件。</p> </td> 
  </tr> 
  <tr> 
   <td> <p>plugins</p> </td> 
   <td> <p>存放特殊前端插件的目录，比如富文本编辑器，视音频插件等等。</p> </td> 
  </tr> 
  <tr> 
   <td> <p>app/controllers/admin</p> </td> 
   <td> <p>存放着MVC中控制器的目录。其中，DBuilder的核心在admin目录下。</p> </td> 
  </tr> 
  <tr> 
   <td> <p>app/models</p> </td> 
   <td> <p>存放着MVC中模型(Model)的目录。用来做数据库查询用。</p> </td> 
  </tr> 
  <tr> 
   <td> <p>app/views</p> </td> 
   <td> <p>存放着MVC中视图的目录。文件名以*.blade.php的格式命名。</p> </td> 
  </tr> 
  <tr> 
   <td> <p>app/library</p> </td> 
   <td> <p>存放PHP辅助类，PHP库的目录。</p> </td> 
  </tr> 
  <tr> 
   <td> <p>app/config/crud</p> </td> 
   <td> <p>存放Module Configuration的目录。</p> </td> 
  </tr> 
 </tbody> 
</table>

## 4.2 GModule 配置文件 ##

GModule配置文件定义了GModule的参数，该文件保存在app/config/crud/下，是以GModule Name进行蛇形分词得到的字符串命名的php文件（譬如：一GModule的名字为OrderItem，则GModule配置文件为order\_item.php）。配置参数以数组格式返回。

考虑到PHP数组在表格中呈现的美观性，对参数以配置中的Key=>Value形式，以点分形式Key.Value表示。

表4-3 root配置

<table> 
 <tbody> 
  <tr> 
   <td> <p>Configuration Key</p> </td> 
   <td> <p>类型</p> </td> 
   <td> <p>默认值</p> </td> 
   <td> <p>含义</p> </td> 
  </tr> 
  <tr> 
   <td> <p>fields</p> </td> 
   <td> <p>array</p> </td> 
   <td> <p>array()</p> </td> 
   <td> <p>字段列表</p> </td> 
  </tr> 
  <tr> 
   <td> <p>fields.field_name</p> </td> 
   <td> <p>array</p> </td> 
   <td> <p>array()</p> </td> 
   <td> <p>对field_name字段的配置</p> </td> 
  </tr> 
  <tr> 
   <td> <p>fields.field_name.label</p> </td> 
   <td> <p>string</p> </td> 
   <td> <p>UP(field_name)</p> </td> 
   <td> <p>显示在列表表格的表头的内容，和form控件旁边的内容</p> </td> 
  </tr> 
  <tr> 
   <td> <p>fields.field_name.form</p> </td> 
   <td> <p>array</p> </td> 
   <td> <p>array()</p> </td> 
   <td> <p>field_name字段的表单配置，具体参考</p> <p>fields.field_name.form配置</p> </td> 
  </tr> 
  <tr> 
   <td> <p>fields.field_name.list</p> </td> 
   <td> <p>array</p> </td> 
   <td> <p>array()</p> </td> 
   <td> <p>field_name 字段的列表配置，具体参考</p> <p>fields.field_name.list配置</p> <p>&nbsp;</p> </td> 
  </tr> 
  <tr> 
   <td> <p>fields.field_name. relation</p> </td> 
   <td> <p>array</p> </td> 
   <td> <p>array()</p> </td> 
   <td> <p>field_name 字段的关系</p> </td> 
  </tr> 
 </tbody> 
</table>

表4-3中每个字段的表单配置说明如下表所示：

表4-4 fields.field\_name.form配置

<table> 
 <tbody> 
  <tr> 
   <td> <p>Configuration Key</p> </td> 
   <td> <p>值类型</p> </td> 
   <td> <p>默认</p> </td> 
   <td> <p>含义</p> </td> 
  </tr> 
  <tr> 
   <td> <p>type</p> </td> 
   <td> <p>string</p> </td> 
   <td> <p>text</p> </td> 
   <td> <p>Form控件类型</p> </td> 
  </tr> 
  <tr> 
   <td> <p>show</p> </td> 
   <td> <p>bool</p> </td> 
   <td> <p>true</p> </td> 
   <td> <p>是否出现在表单</p> </td> 
  </tr> 
  <tr> 
   <td> <p>hidden</p> </td> 
   <td> <p>bool</p> </td> 
   <td> <p>false</p> </td> 
   <td> <p>是否以隐藏的空间在表单中</p> </td> 
  </tr> 
  <tr> 
   <td> <p>rule</p> </td> 
   <td> <p>string</p> </td> 
   <td> <p>required</p> </td> 
   <td> <p>验证规则</p> </td> 
  </tr> 
  <tr> 
   <td> <p>ajax_validate</p> </td> 
   <td> <p>bool</p> </td> 
   <td> <p>false</p> </td> 
   <td> <p>是否异步验证</p> </td> 
  </tr> 
  <tr> 
   <td> <p>placeholder</p> </td> 
   <td> <p>string</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>控件中的提示</p> </td> 
  </tr> 
 </tbody> 
</table>

表4-3中每个字段的列表配置说明如下表所示：

表4-5 fields.field\_name.list配置

<table> 
 <tbody> 
  <tr> 
   <td> <p>Configuration Key</p> </td> 
   <td> <p>值类型</p> </td> 
   <td> <p>默认</p> </td> 
   <td> <p>含义</p> </td> 
  </tr> 
  <tr> 
   <td> <p>show</p> </td> 
   <td> <p>bool</p> </td> 
   <td> <p>true</p> </td> 
   <td> <p>是否出现在表单</p> </td> 
  </tr> 
  <tr> 
   <td> <p>sort</p> </td> 
   <td> <p>bool</p> </td> 
   <td> <p>true</p> </td> 
   <td> <p>字段是否可以排序，默认可排序</p> </td> 
  </tr> 
  <tr> 
   <td> <p>search</p> </td> 
   <td> <p>bool,array</p> </td> 
   <td> <p>array()</p> </td> 
   <td> <p>是否可搜索以及搜索规则</p> </td> 
  </tr> 
  <tr> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>string</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>控件中的提示</p> </td> 
  </tr> 
 </tbody> 
</table>

表4-3中每个字段的关系配置说明如下表所示：

表4-6 fields.field\_name.relation配置

<table> 
 <tbody> 
  <tr> 
   <td> <p>Configuration Key</p> </td> 
   <td> <p>值类型</p> </td> 
   <td> <p>默认</p> </td> 
   <td> <p>含义</p> </td> 
  </tr> 
  <tr> 
   <td> <p>table</p> </td> 
   <td> <p>string</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>关联表</p> </td> 
  </tr> 
  <tr> 
   <td> <p>foreign_key</p> </td> 
   <td> <p>string</p> </td> 
   <td> <p>id</p> </td> 
   <td> <p>对应关联表里的字段</p> </td> 
  </tr> 
  <tr> 
   <td> <p>show</p> </td> 
   <td> <p>string</p> </td> 
   <td> <p>&nbsp;</p> </td> 
   <td> <p>关联表里的一个字段，当需要转义时，将用该字段代替field_nae字段显示</p> </td> 
  </tr> 
  <tr> 
   <td> <p>as</p> </td> 
   <td> <p>string</p> </td> 
   <td> <p>table_show</p> </td> 
   <td> <p>转义查询出的值用哪个字段表示，主要为了防止主表和关联表有重复字段</p> </td> 
  </tr> 
 </tbody> 
</table>

下面是一个名为post的GModule的Configuration文件

![img_8f42589655ef7c6b5825b17895503e95.png][] ![img_405b18b4b6584ae338e0f6ecaf736533.gif][]

1 <?php return array (
      2   'data_source' => 'core',
      3   'table' => 'post',
      4   'fields' => 
      5   array (
      6     'id' => 
      7     array (
      8       'label' => 'ID',
      9       'form' => 
     10       array (
     11         'show' => true,
     12         'hidden' => true,
     13         'type' => 'text',
     14         'rule' => 'required',
     15         'ajax_validate' => false,
     16         'placeholder' => '',
     17       ),
     18       'list' => 
     19       array (
     20         'show' => true,
     21         'sort' => true,
     22         'search' => '=',
     23         'lookup' => false,
     24       ),
     25       'relation' => 
     26       array (
     27         'type' => '',
     28         'table' => '',
     29         'foreign_key' => '',
     30         'show' => '',
     31         'as' => '',
     32       ),
     33     ),
     34     'title' => 
     35     array (
     36       'label' => '标题',
     37       'form' => 
     38       array (
     39         'show' => true,
     40         'hidden' => false,
     41         'type' => 'text',
     42         'rule' => 'required',
     43         'ajax_validate' => false,
     44         'placeholder' => '',
     45       ),
     46       'list' => 
     47       array (
     48         'show' => true,
     49         'sort' => true,
     50         'search' => '=',
     51         'lookup' => false,
     52       ),
     53       'relation' => 
     54       array (
     55         'type' => '',
     56         'table' => '',
     57         'foreign_key' => '',
     58         'show' => '',
     59         'as' => '',
     60       ),
     61     ),
     62     'short' => 
     63     array (
     64       'label' => '摘要',
     65       'form' => 
     66       array (
     67         'show' => true,
     68         'hidden' => false,
     69         'type' => 'textarea',
     70         'rule' => 'required',
     71         'ajax_validate' => false,
     72         'placeholder' => '',
     73       ),
     74       'list' => 
     75       array (
     76         'show' => true,
     77         'sort' => true,
     78         'search' => '=',
     79         'lookup' => false,
     80       ),
     81       'relation' => 
     82       array (
     83         'type' => '',
     84         'table' => 'category',
     85         'foreign_key' => 'id',
     86         'show' => 'id',
     87         'as' => '',
     88       ),
     89     ),
     90     'content' => 
     91     array (
     92       'label' => '正文',
     93       'form' => 
     94       array (
     95         'show' => true,
     96         'hidden' => false,
     97         'type' => 'wysiwyg',
     98         'rule' => 'required',
     99         'ajax_validate' => false,
    100         'placeholder' => '',
    101       ),
    102       'list' => 
    103       array (
    104         'show' => false,
    105         'sort' => true,
    106         'search' => '=',
    107         'lookup' => false,
    108       ),
    109       'relation' => 
    110       array (
    111         'type' => '',
    112         'table' => 'category',
    113         'foreign_key' => 'id',
    114         'show' => 'id',
    115         'as' => '',
    116       ),
    117     ),
    118     'view_ct' => 
    119     array (
    120       'label' => '查看次数',
    121       'form' => 
    122       array (
    123         'show' => false,
    124         'hidden' => false,
    125         'type' => 'text',
    126         'rule' => 'required',
    127         'ajax_validate' => false,
    128         'placeholder' => '',
    129       ),
    130       'list' => 
    131       array (
    132         'show' => true,
    133         'sort' => true,
    134         'search' => '=',
    135         'lookup' => false,
    136       ),
    137       'relation' => 
    138       array (
    139         'type' => '',
    140         'table' => '',
    141         'foreign_key' => '',
    142         'show' => '',
    143         'as' => '',
    144       ),
    145     ),
    146     'created_at' => 
    147     array (
    148       'label' => '创建时间',
    149       'form' => 
    150       array (
    151         'show' => false,
    152         'hidden' => false,
    153         'type' => 'text',
    154         'rule' => 'required',
    155         'ajax_validate' => false,
    156         'placeholder' => '',
    157       ),
    158       'list' => 
    159       array (
    160         'show' => false,
    161         'sort' => true,
    162         'search' => '=',
    163         'lookup' => false,
    164       ),
    165       'relation' => 
    166       array (
    167         'type' => '',
    168         'table' => '',
    169         'foreign_key' => '',
    170         'show' => '',
    171         'as' => '',
    172       ),
    173     ),
    174     'updated_at' => 
    175     array (
    176       'label' => '更新时间',
    177       'form' => 
    178       array (
    179         'show' => false,
    180         'hidden' => false,
    181         'type' => 'text',
    182         'rule' => 'required',
    183         'ajax_validate' => false,
    184         'placeholder' => '',
    185       ),
    186       'list' => 
    187       array (
    188         'show' => true,
    189         'sort' => true,
    190         'search' => '=',
    191         'lookup' => false,
    192       ),
    193       'relation' => 
    194       array (
    195         'type' => '',
    196         'table' => '',
    197         'foreign_key' => '',
    198         'show' => '',
    199         'as' => '',
    200       ),
    201     ),
    202     'category_id' => 
    203     array (
    204       'label' => '栏目',
    205       'form' => 
    206       array (
    207         'show' => true,
    208         'hidden' => false,
    209         'type' => 'select',
    210         'rule' => 'required',
    211         'ajax_validate' => false,
    212         'placeholder' => '',
    213       ),
    214       'list' => 
    215       array (
    216         'show' => true,
    217         'sort' => true,
    218         'search' => '=',
    219         'lookup' => false,
    220       ),
    221       'relation' => 
    222       array (
    223         'type' => 'belongsTo',
    224         'table' => 'category',
    225         'foreign_key' => 'id',
    226         'show' => 'title',
    227         'as' => 'category_title',
    228       ),
    229     ),
    230   ),
    231   'list_options' => 
    232   array (
    233     'page' => 10,
    234     'create' => true,
    235     'update' => true,
    236     'delete' => true,
    237   ),
    238   'form_options' => 
    239   array (
    240     'layout' => 
    241     array (
    242       'cols' => 12,
    243       'label_cols' => 1,
    244       'input_cols' => 11,
    245     ),
    246   ),
    247   'relations' => 
    248   array (
    249     'id' => 
    250     array (
    251       'type' => '',
    252       'table' => '',
    253       'foreign_key' => '',
    254       'show' => '',
    255       'as' => '',
    256     ),
    257     'title' => 
    258     array (
    259       'type' => '',
    260       'table' => '',
    261       'foreign_key' => '',
    262       'show' => '',
    263       'as' => '',
    264     ),
    265     'short' => 
    266     array (
    267       'type' => '',
    268       'table' => '',
    269       'foreign_key' => '',
    270       'show' => '',
    271       'as' => '',
    272     ),
    273     'content' => 
    274     array (
    275       'type' => '',
    276       'table' => '',
    277       'foreign_key' => '',
    278       'show' => '',
    279       'as' => '',
    280     ),
    281     'view_ct' => 
    282     array (
    283       'type' => '',
    284       'table' => '',
    285       'foreign_key' => '',
    286       'show' => '',
    287       'as' => '',
    288     ),
    289     'created_at' => 
    290     array (
    291       'type' => '',
    292       'table' => '',
    293       'foreign_key' => '',
    294       'show' => '',
    295       'as' => '',
    296     ),
    297     'updated_at' => 
    298     array (
    299       'type' => '',
    300       'table' => '',
    301       'foreign_key' => '',
    302       'show' => '',
    303       'as' => '',
    304     ),
    305     'category_id' => 
    306     array (
    307       'type' => '',
    308       'table' => '',
    309       'foreign_key' => '',
    310       'show' => '',
    311       'as' => '',
    312     ),
    313   ),
    314 );

GModule Configuration

## 4.3 数据源管理模块实现 ##

数据源管理模块完成基于网页界面对app/config/datasource.php文件的配置。包含数据源列表页，数据源新建与编辑页。

*  数据源列表页：对应请求路径为admin/data-source/list，此页面读取DataSource文件渲染List（table）页面，密码不显示。
 *  数据源编辑页面：对应请求路径为 admin/data-source/edit，GET请求读取DataSource问价内容渲染表单，POST请求将数据源参数输出值DataSource文件。此页面提供测试连接功能，实现方法为基于表单的数据源参数连接数据库，执行一条SQL语句，连接是否成功取决于SQL是否执行成功。

实现数据源管理的核心控制器代码放在DataSourceController.php文件中。

![img_8f42589655ef7c6b5825b17895503e95.png][] ![img_405b18b4b6584ae338e0f6ecaf736533.gif][]

1 <?php
      2 /**
      3  * Created by PhpStorm.
      4  * User: lvyahui
      5  * Date: 2016/5/12
      6  * Time: 15:35
      7  */
      8 
      9 namespace admin;
     10 
     11 use BaseModel;
     12 use Illuminate\Support\Facades\Config;
     13 use Illuminate\Support\Facades\Redirect;
     14 use SiteHelpers;
     15 use Illuminate\Support\Facades\Response;
     16 use Illuminate\Support\Facades\Input;
     17 
     18 use PDOException;
     19 use PDO;
     20 class DataSourceController extends AdminController
     21 {
     22     /**
     23      * 呈现数据源列表
     24      */
     25     public function getList()
     26     {
     27         $datasources = SiteHelpers::loadDataSources();
     28         $this->makeView(array(
     29             'datasources' => $datasources,
     30         ));
     31     }
     32 
     33     /**
     34      * 异步加载某数据源的所有数据表
     35      * @return \Illuminate\Http\JsonResponse
     36      */
     37     public function getTables()
     38     {
     39         $dataSourceName = Input::get("data_source");
     40         $dataSources = SiteHelpers::loadDataSources();
     41 
     42         $dataSource = $dataSources[$dataSourceName];
     43         $tables = BaseModel::getTableList($dataSource['database'], $dataSourceName);
     44         return Response::json(array(
     45             'success' => true,
     46             'data'    => array(
     47                 'tables'   => $tables,
     48                 'selected' => Input::get('table'),
     49             ),
     50         ));
     51     }
     52 
     53     /**
     54      * 呈现数据源编辑或者新建FORM
     55      * @param null $slug
     56      */
     57     public function getEdit($slug = null)
     58     {
     59         $dataSource = null;
     60         if ($slug) {
     61             // 更新
     62             $dataSource = $slug === 'core' ? Config::get('database.connections.core')
     63                 : Config::get('datasource.' . $slug);
     64             $dataSource['name'] = $slug;
     65         } else {
     66             // 新建
     67             $dataSource = array(
     68                 'name'     => '',
     69                 'driver'   => 'mysql',
     70                 'host'     => 'localhost',
     71                 'port'     => 3306,
     72                 'database' => '',
     73                 'username' => 'root',
     74                 'password' => '',
     75                 'charset'  =>   'utf8',
     76                 'collation' =>  'utf8_unicode_ci'
     77             );
     78         }
     79 
     80         $this->makeView(array(
     81             'dataSource'    =>  $dataSource
     82         ));
     83     }
     84 
     85     /**
     86      * 测试数据源连接是否可靠
     87      * @return \Illuminate\Http\JsonResponse
     88      */
     89     public function postTest(){
     90         $success = true;
     91         try{
     92             $dsn = Input::get('driver').':'.Input::get('host').':'.Input::get('port').';dbname='.Input::get('database');
     93             $dbh = new \PDO($dsn,Input::get('username'),Input::get('password'));
     94 //            $connection = new Connection($dbh,Input::get('database'));
     95 //            $key = md5(date("Y-m-d H:i:s"));
     96 //            DB::addConnection($key,$connection);
     97 //            if(!DB::connection($key)->getDatabaseName()){
     98 //                $success = false;
     99 //            }
    100             $dbh = null;
    101         }catch(PDOException  $e){
    102             $success = false;
    103         }
    104         return Response::json(array(
    105             'success'   =>  $success,
    106         ));
    107     }
    108 
    109     /**
    110      * 保存编辑好的数据源信息
    111      * @param null $primaryKeyValue
    112      * @return mixed
    113      */
    114     public function postEdit($primaryKeyValue = null)
    115     {
    116         $dataSources = SiteHelpers::loadDataSources();
    117         $name = Input::get('name');
    118         $dataSources[$name] = Input::all();
    119         SiteHelpers::saveDataSources($dataSources);
    120 
    121         return Redirect::action(get_class($this).'@getList');
    122     }
    123 
    124 
    125     public function getTableFields(){
    126         $connection = Input::get('connection');
    127         $table = Input::get('table');
    128 
    129         $rawFields = BaseModel::getTableColumns($table,$connection);
    130 
    131         $fields = array();
    132         $pri = null;
    133         foreach($rawFields as $field){
    134             if($field->Key === 'PRI'){
    135                 $pri = $field->Field;
    136             }
    137             $fields [] = $field->Field;
    138         }
    139 
    140         return Response::json(array(
    141             'success'   =>  true,
    142             'data'  =>  array(
    143                 'fields'    =>  $fields,
    144                 'pri'       =>  $pri,
    145             ),
    146         ));
    147     }
    148 }

DataSourceController

## 4.4 CoreCRUD 模块实现 ##

CoreCRUD模块涉及的代码文件极其作用如下说明。

*  app/controllers/admin/AdminController.php：CoreCRUD模块的控制器，是CRUD操作核心的逻辑代码。主要分析请求参数和Module参数，调用Model层，渲染视图层，实现List呈现、List搜索排序、Form呈现、Form保存等功能;
 *  app/models/BaseModel.php：CoreCRUD模块中的模型，是ModuleCRUD模块中模型的基类。未与表格关联。定义了一些公共的Model默认属性，以及一些静态的数据库操作方法，比如拉取数据库表字段列表;
 *  app/config/crud/admin.php：CoreCRUD模块中的默认crud参数配置文件，但ModuleCRUD模块中的配置文件未定义某些参数时，将使用admin.php中的默认参数;
 *  app/views/admin/core/list.blade.php：CoreCRUD模块中的列表视图文件，用来呈现数据列表;
 *  app/views/admin/core/form.blade.php：CoreCRUD模块中的数据记录编辑视图文件，用来呈现数据编辑的表单。

代码文件如下

![img_8f42589655ef7c6b5825b17895503e95.png][] ![img_405b18b4b6584ae338e0f6ecaf736533.gif][]

1 <?php
      2 
      3 namespace admin;
      4 
      5 use Illuminate\Support\Facades\Request;
      6 use Illuminate\Support\Facades\Response;
      7 use Illuminate\Support\Facades\Redirect;
      8 use Illuminate\Support\Facades\Input;
      9 use Illuminate\Support\Facades\Config;
     10 use Illuminate\Support\Facades\View;
     11 use Illuminate\Support\Facades\Cache;
     12 use Illuminate\Support\Facades\URL;
     13 use SiteHelpers;
     14 use Module;
     15 
     16 class AdminController extends \BaseController
     17 {
     18     protected $layout = 'layouts.admin.main';
     19 
     20     /**
     21      * AdminController constructor.
     22      */
     23     public function __construct()
     24     {
     25         parent::__construct();
     26         View::share('stdName',$this->getStdName());
     27         View::share('reducName',SiteHelpers::reducCase($this->getStdName()));
     28         View::share('routeParams',$this->getRouteParams());
     29         if($this->model){
     30             $this->assignModel($this->model);
     31         }
     32         View::share('config',$this->savedConfig);
     33         if(!Cache::has('modules')){
     34             Cache::forever('modules',Module::all());
     35         }
     36     }
     37 
     38     public function getList(){
     39         $models = $this->paginateModels();
     40         $view = $this->getRouteParam('c').'._list';
     41         if(!View::exists($view)){
     42             $view = 'admin.core.list';
     43         }
     44         if(Request::ajax() || Input::has('isAjax')){
     45             return Response::json(array(
     46                'success'    =>  true,
     47                 'data'      =>  array(
     48                     'models'    =>  $models->toArray()
     49                 )
     50             ));
     51         }else{
     52             $this->makeView(array(
     53                 'models'  =>  $models,
     54                 $this->getStdName().'s' =>  $models,
     55             ),$view);
     56         }
     57     }
     58 
     59     public function getEdit($id = null)
     60     {
     61         if($id){
     62             $this->model = $this->model->find($id);
     63         }
     64         $data = array(
     65             $this->model->getKeyName() => $id,
     66             'model'   =>  $this->model,
     67             $this->modelName=>$this->model,
     68         );
     69         $this->beforeEdit($data);
     70 
     71         $view = $this->getRouteParam('c').'._form';
     72         if(!View::exists($view)){
     73             $view = 'admin.core.form';
     74         }
     75         $this->makeView($data,$view);
     76     }
     77 
     78     protected function config(){
     79         $config = 'crud/'.$this->getStdName();
     80         if(!file_exists(app_path('config/').$config.'.php')){
     81             $config = 'crud/admin';
     82         }
     83         return Config::get($config);
     84     }
     85 
     86     protected function assignModel($model)
     87     {
     88         $this->model = $model;
     89 
     90         $config = $this->config();
     91         $defaultConfig = Config::get('crud/admin');
     92         $relations = array();
     93         /* 将默认参数传递给module config */
     94         foreach($config['fields']   as $field => &$fieldConfig){
     95 //            if(isset($fieldConfig['value'])){
     96 //                $this->model->$field = $fieldConfig['value'];
     97 //            }
     98             $fieldConfig['form'] = array_merge(
     99                 $defaultConfig['fields']['field_name']['form'],
    100                 isset($fieldConfig['form']) ? $fieldConfig['form'] : array()
    101             );
    102             $fieldConfig['list'] = array_merge(
    103                 $defaultConfig['fields']['field_name']['list'],
    104                 isset($fieldConfig['list']) ? $fieldConfig['list'] : array()
    105             );
    106             if(isset($fieldConfig['relation']) &&
    107                 isset($fieldConfig['relation']['type']) && $fieldConfig['relation']['type'] !== '' ){
    108                 $relations[$field] = $fieldConfig['relation'];
    109             }
    110         }
    111 
    112         $config['list_options'] = array_merge(
    113             $defaultConfig['list_options'],
    114             isset($config['list_options']) ? $config['list_options'] : array()
    115         );
    116 
    117         $config['form_options'] = array_merge(
    118             $defaultConfig['form_options'],
    119             isset($config['form_options']) ? $config['form_options'] : array()
    120         );
    121 
    122         /* 将字段的relation汇聚出来，是为了后面的代码方便，同时减少循环 */
    123         $config['relations'] = $relations;
    124 
    125         $this->savedConfig = $config;
    126     }
    127 
    128     protected function paginateModels()
    129     {
    130         $models = array();
    131         if($this->model){
    132             $query = $this->model->newQuery();
    133             $this->handleListQuery($query);
    134             $selects = array($this->model->getTable().'.*');
    135 
    136             foreach($this->savedConfig['relations'] as $field=>&$params){
    137                 $query->join($params['table'],$params['table'].'.'.$params['foreign_key'],'=',$this->model->getTable().'.'.$field);
    138                 if(!isset($params['as'])){
    139                     $params['as'] = $params['table'].'_'.$params['show'];
    140                 }
    141                 $selects[] = $params['table'].'.'.$params['show'] . ' as '.$params['as'];
    142             }
    143             $query->select($selects);
    144             $orderBy = Input::get('list_order_by');
    145             if( $orderBy){
    146                 $query->orderBy($this->model->getTable().'.'.$orderBy,Input::get('list_sort_asc') ? 'asc' : 'desc');
    147             }else{
    148                 $query->orderBy($this->model->getTable().'.'.$this->model->getKeyName(),'desc');
    149             }
    150             $page = Input::has('_page') ? Input::get('_page') : 10;
    151             $models = $query->paginate($page);
    152         }
    153         return $models;
    154     }
    155 
    156 
    157     public function postEdit($primaryKeyValue = null){
    158 
    159         $primaryKeyName = $this->model->getKeyName();
    160         if($primaryKeyValue == null){
    161             $primaryKeyValue = Input::get($primaryKeyName);
    162         }
    163 
    164         $fields = $this->savedConfig['fields'];
    165         $datas = array();
    166         foreach($fields as $field => $fieldConfig){
    167             if(Input::has($field)){
    168                 $datas[$field] = Input::get($field);
    169             }
    170         }
    171 
    172         if($primaryKeyValue){
    173             $this->model->where($primaryKeyName,$primaryKeyValue)->update($datas);
    174         }else{
    175             $this->model->fill($datas);
    176             $this->model->save();
    177         }
    178         $this->afterSave($this->model);
    179         $resp = Redirect::action(get_class($this).'@getList')->withMessage('save success!');
    180 
    181         return $resp;
    182     }
    183 
    184     public function getIndex()
    185     {
    186         $this->makeView(null,'admin.index');
    187     }
    188 
    189     public function postDelete(){
    190         $ids = explode(',',Input::get('ids'));
    191         $data = array();
    192         $success   =  true;
    193         $data['ids'] = $ids;
    194         $ids = array_filter($ids,function($id){
    195             return $id;
    196         });
    197         $this->model->whereIn($this->model->getKeyName(),$ids)->delete();
    198         $data['redirect_url'] = URL::to(action(get_class($this).'@getList'));
    199         return Response::json(array(
    200             'success'   =>  $success,
    201             'data'      =>  $data,
    202         ));
    203     }
    204 
    205     public function getDelete($id){
    206         $this->beforeDelete($id);
    207         $this->model->where($this->model->getKeyName(),$id)->delete();
    208         return Redirect::action(get_class($this).'@getList');
    209     }
    210 
    211     public function missingMethod($parameters = array())
    212     {
    213         //
    214         $this->makeView(null,'site.404');
    215     }
    216 
    217     protected function handleListQuery(&$query)
    218     {
    219         $searchFields = array_intersect_key($this->savedConfig['fields'],Input::all());
    220         foreach($searchFields as $field=> $fieldConfig){
    221             if(isset($fieldConfig['list']['search'])){
    222                 $value = Input::get($field);
    223                 $operator = $fieldConfig['list']['search'];
    224                 if($value !== ''){
    225                     if($operator){
    226                         if($operator === 'like'){
    227                             $value = '%'.$value.'%';
    228                         }
    229                         $query = $query->where($this->model->getTable().'.'.$field,$operator,$value);
    230                     }else{
    231                         $query = $query->where($this->model->getTable().'.'.$field,$value);
    232                     }
    233                 }
    234             }
    235         }
    236 
    237     }
    238 
    239     protected function beforeDelete($id)
    240     {
    241 
    242     }
    243 
    244     protected function beforeEdit(&$data)
    245     {
    246 
    247     }
    248 
    249     protected function afterSave($model)
    250     {
    251 
    252     }
    253 
    254     public function getHelp(){
    255         $this->makeView(null,'admin.help');
    256     }
    257 
    258 }

AdminController

![img_8f42589655ef7c6b5825b17895503e95.png][] ![img_405b18b4b6584ae338e0f6ecaf736533.gif][]

1 <?php
      2 
      3 /**
      4  * Created by PhpStorm.
      5  * User: Administrator
      6  * Date: 2015/10/10 0010
      7  * Time: 17:58
      8  */
      9 class BaseModel extends Eloquent
     10 {
     11     protected $table = '';
     12     protected $guarded = array('id');
     13     public $timestamps = false;
     14     public static function getTranslates($translate){
     15         $rows = DB::table($translate['table'])->select(array($translate['foreign_key'],$translate['show']))->get();
     16         return $rows;
     17     }
     18 
     19 
     20     static function getTableList( $db ,$connection = null)
     21     {
     22         $t = array();
     23         $dbname = 'Tables_in_'.$db ;
     24         $tables = $connection ? DB::connection($connection)->select("SHOW TABLES FROM {
         $db}") : DB::select("SHOW TABLES FROM {
         $db}");
     25         foreach($tables as $table)
     26         {
     27             $t[$table->$dbname] = $table->$dbname;
     28         }
     29         return $t;
     30     }
     31 
     32     static function getTableColumns( $table,$connection  = false)
     33     {
     34 //        $columns = array();
     35         $sql  = "SHOW COLUMNS FROM $table";
     36         $rawColumns = $connection ? DB::connection($connection)->select($sql)
     37             : DB::select($sql);
     38 //        foreach($rawColumns as $column)
     39 //            $columns[$column->Field] = $column->Field;
     40         return $rawColumns;
     41     }
     42 
     43     function getColoumnInfo( $result )
     44     {
     45         $pdo = DB::getPdo();
     46         $res = $pdo->query($result);
     47         $i =0;    $coll=array();
     48         while ($i < $res->columnCount())
     49         {
     50             $info = $res->getColumnMeta($i);
     51             $coll[] = $info;
     52             $i++;
     53         }
     54         return $coll;
     55 
     56     }
     57 
     58     function builColumnInfo( $statement )
     59     {
     60         $driver         = Config::get('database.default');
     61         $database         = Config::get('database.connections');
     62         $db         = $database[$driver]['database'];
     63         $dbuser     = $database[$driver]['username'];
     64         $dbpass     = $database[$driver]['password'];
     65         $dbhost     = $database[$driver]['host'];
     66 
     67         $data = array();
     68         $mysqli = new mysqli($dbhost,$dbuser,$dbpass,$db);
     69         if ($result = $mysqli->query($statement)) {
     70 
     71             /* Get field information for all columns */
     72             while ($finfo = $result->fetch_field()) {
     73                 $data[] = (object) array(
     74                     'Field'    => $finfo->name,
     75                     'Table'    => $finfo->table,
     76                     'Type'    => $finfo->type
     77                 );
     78             }
     79             $result->close();
     80         }
     81 
     82         $mysqli->close();
     83         return $data;
     84 
     85     }
     86 
     87     static function findPrimarykey( $table, $db = null)
     88     {
     89         $query = "SHOW KEYS FROM `{
         $table}` WHERE Key_name = 'PRIMARY'";
     90         $primaryKey = '';
     91         $keys = $db ? DB::connection($db)->select($query) : DB::select($query);
     92 
     93         foreach($keys as $key)
     94         {
     95             $primaryKey = $key->Column_name;
     96         }
     97 
     98         return $primaryKey;
     99     }
    100 }

BaseModel

![img_8f42589655ef7c6b5825b17895503e95.png][] ![img_405b18b4b6584ae338e0f6ecaf736533.gif][]

1 <?php
      2 $formOption = $config['form_options'];
      3 $layout = $formOption['layout'];
      4 $labelCols = $layout['label_cols'];
      5 $inputCols = $layout['input_cols'];
      6 $labelCss = "col-sm-$labelCols";
      7 $inputCss = "col-sm-$inputCols";
      8 //  插件是否加载
      9 $loadUE = false;
     10 $loadSBox = false;
     11 $loadDatePicker = false;
     12 ?>
     13 <div class="panel panel-primary">
     14     <div class="panel-heading">
     15         <h3 class="panel-title">@if($model->id)  编辑<code>#{
          {$model->id}}</code>@else 新建  @endif</h3>
     16     </div>
     17     <div class="panel-body">
     18         <div class="row">
     19             <div class="col-sm-{
         {
         $layout['cols']}} col-sm-offset-{
         {(12-$layout['cols'])/2}}">
     20                 <form class="form-horizontal validate" action="{
         {URL::to('admin/'.$stdName.'/edit')}}" method="post">
     21                     <input type="hidden" name="{
         {
         $model->getKeyName()}}" value="{
         {
         $model->getKey()}}">
     22                     <?php foreach($config['fields'] as $field => $settings):?>
     23                     <?php
     24                     if ($field === $model->getKeyName() || !$settings['form']['show']) continue;
     25                     $type = $settings['form']['type'];
     26                     $rule = $settings['form']['rule'];
     27                     ?>
     28                     <?php if($settings['form']['type'] === 'hidden'):?>
     29                     <input type="hidden" name="{
         {
         $field}}" value="{
         {
         $model->$field}}">
     30                     <?php continue;?>
     31                     <?php endif; ?>
     32                     <div class="form-group">
     33                         <label for="{
         {
         $field}}"
     34                                class="{
         {
         $labelCss}} control-label">{
         {
         isset($settings['label']) ? $settings['label'] : strtoupper($field)}}</label>
     35                         <div class="{
         {
         $inputCss}}">
     36                             <?php if($type === 'textarea'):?>
     37                             <textarea name="{
         {
         $field}}" id="{
         {
         $field}}" rows="10"
     38                                       {
         {SiteHelpers::inputValidate($rule)}}
     39                                       class="form-control">{
         {
         $model->$field}}</textarea>
     40                             <?php elseif($type === 'select'):?>
     41                             <?php $loadSBox = true;?>
     42                             <select name="{
         {
         $field}}" id="{
         {
         $field}}" class="selectboxit" {
         {SiteHelpers::inputValidate($rule)}}>
     43                                 @if (isset($settings['form']['options']))
     44                                     @if(is_array($settings['form']['options']))
     45                                         @foreach($settings['form']['options'] as $value => $text)
     46                                             <option value="{
         {
         $value}}"
     47                                                     @if($value == $model->$field) selected @endif>{
         {
         $text}}</option>
     48                                         @endforeach
     49                                     @elseif(is_string($settings['form']['options']))
     50                                         @foreach($$settings['form']['options'] as $value => $text)
     51                                             <option value="{
         {
         $value}}">{
         {
         $value}}</option>
     52                                         @endforeach
     53                                     @endif
     54                                 @elseif(isset($settings['relation']['type']) && $settings['relation']['type'] )
     55                                     <?php
     56                                     $fieldTranslate = $config['relations'][$field];
     57                                     $options = BaseModel::getTranslates($fieldTranslate);
     58                                     foreach($options as $option):
     59                                     ?>
     60                                     <option value="<?=$option->$fieldTranslate['foreign_key']?>"
     61                                             @if($option->$fieldTranslate['foreign_key'] == $model->$field) selected @endif
     62                                     ><?=$option->$fieldTranslate['show']?>
     63                                     </option>
     64                                     <?php endforeach;?>
     65                                 @endif
     66                             </select>
     67                             <?php elseif($type === 'wysiwyg'):?>
     68                             <?php
     69                             $loadUE = true;
     70                             ?>
     71                             <script type="text/plain" name="{
         {
         $field}}" id="wysiwyg-edit"
     72                                     style="width:100%;height:240px;">{
         {
         $model->$field}}</script>
     73                             <?php elseif ($type === 'radio' || $type === 'checkbox'): ?>
     74 
     75                             @if(isset($settings['form']['options']))
     76                                 @foreach($settings['form']['options'] as $option => $text)
     77                                     <div class="{
         {
         $type}} {
         {
         $type}}-replace">
     78                                         <input type="{
         {
         $type}}" value="{
         {
         $option}}" name="{
         {
         $field}}"
     79                                                id="{
         {
         $field}}" @if($model->field === $option) checked @endif>
     80                                         <label>{
         {
         $text}}</label>
     81                                     </div>
     82                                 @endforeach
     83                             @endif
     84                             <?php elseif($type === 'date'):?>
     85                             <?php $loadDatePicker = true;?>
     86                             <div class="input-group">
     87                                 <input type="text" name="{
         {
         $field}}" id="{
         {
         $field}}" class="form-control datepicker" data-format="yyyy-MM-dd" {
         {SiteHelpers::inputValidate($rule)}}>
     88                                 <div class="input-group-addon">
     89                                     <a href="#"><i class="entypo-calendar"></i></a>
     90                                 </div>
     91                             </div>
     92                             <?php elseif($type === 'password'):?>
     93                             <input type="password" class="form-control" name="{
         {
         $field}}" id="{
         {
         $field}}"
     94                                    value="{
         {
         $model->$field}}"
     95                                     {
         {SiteHelpers::inputValidate($rule)}}
     96                             >
     97                             <?php elseif($type === 'file'):?>
     98                             <input type="file"
     99                                    class="form-control file2 inline btn btn-primary"
    100                                    data-label="<i class='glyphicon glyphicon-file'></i> 选择文件" >
    101                             <?php else:?>
    102                             <input type="text" class="form-control" name="{
         {
         $field}}" id="{
         {
         $field}}"
    103                                    {
         {SiteHelpers::inputMask($rule)}}
    104                                    {
         {SiteHelpers::inputValidate($rule)}}
    105                                    value="{
         {
         $model->$field}}">
    106                             <?php endif;?>
    107                         </div>
    108                     </div>
    109                     <?php endforeach;?>
    110                     <div class="form-group">
    111                         <div class="{
         {
         $inputCss}} col-sm-offset-{
         {
         $labelCols}}">
    112                             <button type="submit" class="btn btn-primary">保存</button>
    113                         </div>
    114                     </div>
    115                 </form>
    116             </div>
    117         </div>
    118     </div>
    119 </div>
    120 @yield('form.bottom','')
    121 @section('styles')
    122     @if($loadSBox)
    123         {
         {HTML::style('assets/js/selectboxit/jquery.selectBoxIt.css')}}
    124     @endif
    125 @append
    126 @section('scripts')
    127     <?php if($loadUE):?>
    128     {
         {HTML::script('plugins/ue-utf8-php/ueditor.config.js')}}
    129     {
         {HTML::script('plugins/ue-utf8-php/ueditor.all.min.js')}}
    130     {
         {HTML::script('plugins/ue-utf8-php/lang/zh-cn/zh-cn.js')}}
    131     <?php endif;?>
    132     @if($loadSBox)
    133         {
         {HTML::script('assets/js/selectboxit/jquery.selectBoxIt.min.js')}}
    134     @endif
    135     @if($loadDatePicker)
    136         {
         {HTML::script('assets/js/bootstrap-datepicker.js')}}
    137     @endif
    138     {
         {HTML::script('assets/js/jquery.inputmask.bundle.min.js')}}
    139     {
         {HTML::script('assets/js/jquery.validate.min.js')}}
    140 @append
    141 
    142 @section('footScript')
    143     <script>
    144         var ue = null,
    145                 ueId = 'wysiwyg-edit';
    146         if (document.getElementById(ueId)) {
    147             ue = UE.getEditor(ueId);
    148         }
    149     </script>
    150 @append

app/views/admin/core/form.blade.php

![img_8f42589655ef7c6b5825b17895503e95.png][] ![img_405b18b4b6584ae338e0f6ecaf736533.gif][]

1 @section('headStyle')
      2     <style>
      3         .sort.sort-active {
      4             color: #000;
      5             font-weight: bold;
      6         }
      7     </style>
      8 @append
      9 <?php
     10 $list_options = $config['list_options'];
     11 $loadSBox = false;
     12 $loadDatePicker = false;
     13 ?>
     14 <div class="panel panel-default">
     15     <div class="panel-heading">
     16         <h3 class="panel-title"><?=isset($navMap[$stdName]['text']) ? $navMap[$stdName]['text'] : strtoupper($stdName)?>
     17             列表</h3>
     18     </div>
     19     <div class="panel-body">
     20         <div class="row">
     21             <div class="col-sm-12">
     22                 <div class="btn-group btn-group-sm" role="group">
     23                     @if($list_options['create'])
     24                         <a href="{
         {URL::to('admin/'.$stdName.'/edit')}}" class="btn btn-primary">新建</a>
     25                     @endif
     26                     <a class="btn btn-danger delete-selected">删除</a>
     27                     <a class="btn btn-default">导出</a>
     28                 </div>
     29             </div>
     30         </div>
     31         <br>
     32         <form class="list-form" action="" method="get">
     33             <input type="hidden" name="list_sort_asc" value="{
         {Input::get('list_sort_asc') !== null ? Input::get('list_sort_asc') : 1}}">
     34             <input type="hidden" name="list_order_by" value="">
     35             <table class="table table-bordered responsive table-hover table-striped">
     36                 <thead>
     37                 <tr>
     38                     <th>
     39                         <div class="checkbox checkbox-replace">
     40                             <input type="checkbox" class="item-all">
     41                         </div>
     42                     </th>
     43                     <?php foreach($config['fields'] as $field=>$settings):?>
     44                     <?php if($settings['list']['show']):?>
     45                     <th @if($settings['list']['sort'])
     46                         class="sort @if($field === Input::get('list_order_by')) sort-active @endif"
     47                         data-field="{
         {
         $field}}" @endif
     48                     ><?=is_array($settings) && isset($settings['label']) ? $settings['label'] : strtoupper($field)?>
     49                         <span class="pull-right">
     50                             @if($field === Input::get('list_order_by'))  @if(Input::get('list_sort_asc') == 1) <i class="fa fa-sort-asc"></i> @else <i class="fa fa-sort-desc"></i>  @endif @endif
     51                         </span>
     52                     </th>
     53                     <?php endif;?>
     54                     <?php endforeach;?>
     55                     <th>操作</th>
     56                 </tr>
     57                 </thead>
     58                 <tbody>
     59                 <tr>
     60                     <td></td>
     61                     @foreach($config['fields'] as $field=>$fieldConfig)
     62                         @if($fieldConfig['list']['show'])
     63                             @if(isset($fieldConfig['list']['search']) && $fieldConfig['list']['search'] !== false)
     64                                 <td>
     65                                     @if($fieldConfig['form']['type'] == 'select' || ($fieldConfig['form']['type'] === 'radio' || $fieldConfig['form']['type'] == 'checkbox'))
     66                                         <?php $loadSBox = true;?>
     67                                         @if(isset($fieldConfig['form']['options']) && $fieldConfig['form']['options'])
     68                                             <select name="{
         {
         $field}}" id="{
         {
         $field}}" class="selectboxit">
     69                                                 <option value="" class="default-value">请选择</option>
     70                                                 @foreach($fieldConfig['form']['options'] as $option => $text)
     71                                                     <option value="{
         {
         $option}}" @if(Input::get($field) && Input::get($field) === $option) selected @endif>{
         {
         $text}}</option>
     72                                                 @endforeach
     73                                             </select>
     74                                         @elseif(isset($fieldConfig['relation']['type']) && $fieldConfig['relation']['type'] )
     75                                             {
         {View::make('components.relation_select',array(
     76                                             'fieldConfig'=>$fieldConfig,'field' =>  $field, ))}}
     77                                         @endif
     78                                     @elseif($fieldConfig['form']['type'] === 'date')
     79                                         <?php $loadDatePicker = true;?>
     80                                         <input type="text" name="{
         {
         $field}}" id="{
         {
         $field}}" class="form-control datepicker" data-format="yyyy-MM-dd" value="{
         {Input::get($field)}}">
     81                                     @else
     82                                         <input type="text" name="{
         {
         $field}}" id="{
         {
         $field}}"
     83                                                value="{
         {Input::get($field)}}" class="form-control input-sm">
     84                                     @endif
     85                                 </td>
     86                             @else
     87                                 <td></td>
     88                             @endif
     89                         @endif
     90                     @endforeach
     91                     <td>
     92                         <div class="btn-group btn-group-sm" role="group">
     93                             <button type="submit" class="btn btn-primary">搜索</button>
     94                             <button type="reset" οnclick="resetForm(this)" class="btn btn-warning hidden">重置</button>
     95                         </div>
     96                     </td>
     97                 </tr>
     98                 <?php foreach($models as  $model):?>
     99                 <tr>
    100                     <td width="18px">
    101                         <div class="checkbox checkbox-replace">
    102                             <input type="checkbox" name="d_delete_select" class="item" value="{
         {
         $model->id}}">
    103                         </div>
    104                     </td>
    105                     <?php foreach($config['fields'] as $filed=>$settings):?>
    106                     <?php if($settings['list']['show']):?>
    107                     <?php
    108                     $value = $model->$filed;
    109                     /* 字段在列表中需要翻译 */
    110                     if (array_key_exists($filed, $config['relations'])) {
    111                         $value = $model->$config['relations'][$filed]['as'];
    112                     }
    113                     ?>
    114                     <td>{
         {
         $value}}</td>
    115                     <?php endif;?>
    116                     <?php endforeach;?>
    117                     <td>
    118                         <div class="btn-group btn-group-sm" role="group">
    119                             @if($list_options['update'])
    120                                 <a href="{
         {URL::to('admin/'.$stdName.'/edit/'.$model->id)}}"
    121                                    class="btn btn-primary">编辑</a>
    122                             @endif
    123                             @if($list_options['delete'])
    124                                 <a href="{
         {URL::to('admin/'.$stdName.'/delete/'.$model->id)}}"
    125                                    class="btn btn-danger">删除</a>
    126                             @endif
    127                             @if(View::exists('admin.'.snake_case($stdName).'.list_item_links'))
    128                                 @include('admin.'.snake_case($stdName).'.list_item_links',array('model'=>$model))
    129                             @endif
    130                         </div>
    131                     </td>
    132                 </tr>
    133                 <?php endforeach;?>
    134                 </tbody>
    135             </table>
    136         </form>
    137         <div class="pull-right">
    138             {
         {
         $models->appends(Input::all())->links()}}
    139         </div>
    140     </div>
    141 </div>
    142 
    143 @section('styles')
    144     {
         {HTML::style('assets/js/datatables/responsive/css/datatables.responsive.css')}}
    145 
    146     @if($loadSBox)
    147         {
         {HTML::style('assets/js/selectboxit/jquery.selectBoxIt.css')}}
    148     @endif
    149 @append
    150 
    151 @section('scripts')
    152     {
         {HTML::script('assets/js/jquery.dataTables.min.js')}}
    153     {
         {HTML::script('assets/js/datatables/jquery.dataTables.columnFilter.js')}}
    154     @if($loadSBox)
    155         {
         {HTML::script('assets/js/selectboxit/jquery.selectBoxIt.min.js')}}
    156     @endif
    157     @if($loadDatePicker)
    158         {
         {HTML::script('assets/js/bootstrap-datepicker.js')}}
    159     @endif
    160 @append
    161 
    162 @section('footScript')
    163     <script>
    164         $(document).ready(function(){
    165             $('th.sort').click(function(){
    166                 var $th = $(this);
    167                 $('input[name="list_order_by"]').val($th.data('field'));
    168                 $('input[name="list_sort_asc"]').val($th.find('i').hasClass('fa-sort-asc') ? 0 : 1);
    169                 $('form.list-form').submit();
    170             });
    171 
    172             $('input.item-all').change(function(){
    173                 var $this = $(this),
    174                         $items = $('input.item');
    175                 if($this.is(':checked')){
    176                     $items.prop('checked','checked');
    177                 }else{
    178                     $items.removeProp('checked');
    179                 }
    180                 $items.trigger('change');
    181             });
    182 
    183 
    184             $('a.delete-selected').click(function(){
    185                 var ids = [],
    186                         $items = $('input.item:checked');
    187                 $items.each(function(i){
    188                     ids.push($(this).val());
    189                 });
    190                 var idsStr = ids.join(',');
    191                 confirmModal({
    192                     message  :   '确认删除：'+idsStr,
    193                     onOk:   function(){
    194                         $.post('{
         {URL::to('admin/'.snake_case($stdName).'/delete')}}',{"ids":idsStr},function(resp){
    195                             if(resp.success){
    196                                 window.location.href = resp.data.redirect_url;
    197                             }
    198                         },'json');
    199                     }
    200                 });
    201                 return false;
    202             });
    203         });
    204     </script>
    205 @append
    206 
    207 @section('modals')
    208     <div class="modal fade" id="confirm-modal" data-backdrop="static">
    209         <div class="modal-dialog">
    210             <div class="modal-content">
    211                 <div class="modal-header">
    212                     <h4 class="modal-title">操作确认</h4>
    213                 </div>
    214                 <div class="modal-body">
    215 
    216                 </div>
    217                 <div class="modal-footer">
    218                     <button type="button" class="btn btn-default cancel" data-dismiss="modal">取消</button>
    219                     <button type="button" class="btn btn-info ok">确认</button>
    220                 </div>
    221             </div>
    222         </div>
    223     </div>
    224 @stop

app/views/admin/core/list.blade.php

![img_8f42589655ef7c6b5825b17895503e95.png][] ![img_405b18b4b6584ae338e0f6ecaf736533.gif][]

1 <?php
     2 /**
     3  * 说明：
     4  * 1. 以下配置项，不设置便是默认
     5  * Created by PhpStorm.
     6  * User: lvyahui
     7  * Date: 2016/5/2
     8  * Time: 12:33
     9  */
    10 
    11 return array(
    12 
    13     /**
    14      * 所有字段配置
    15      */
    16     'fields'    =>  array(
    17         'field_name' =>  array(
    18             /* 显示在列表表格的表头的内容，和form控件旁边的内容*/
    19             'label' =>  '字段中文名',
    20             /* 字段缺省值 */
    21             'value' =>  false,
    22             /* 针对表单的设置 */
    23             'form'  =>  array(
    24                 'show'  =>  true,
    25                 'hidden'    =>  false,
    26                 /*
    27                  * 字段对应表单的控件类型，默认text，
    28                  * 还支持常用的控件类型
    29                  * textarea
    30                  * radio
    31                  * checkbox
    32                  * number
    33                  * ipaddr
    34                  * wyswyg
    35                  * select
    36                  * date
    37                  * file
    38                  * 以及自定义类型
    39                  * */
    40                 'type'  =>  'text',
    41                 /*
    42                 'type'  =>  array(
    43                     'select'    =>  array(
    44                         'options'   =>  function(){
    45                             return array();
    46                         }
    47                     ),
    48                 ),
    49                 'type'  =>  array(
    50                     'radio'     =>  array(),
    51                 ),
    52                 */
    53                 /* 提交表单后的验证规则 */
    54                 'rule'  =>  'required',
    55                 'ajax_validate' =>  false,
    56                 'placeholder'   =>  'xx',
    57 
    58             ),
    59             // 针对列表的设置
    60             'list'  =>  array(
    61                 /* 字段在列表是否显示，默认为显示 */
    62                 'show'  =>  true,
    63                 /* 字段是否可以排序，默认不能排序 */
    64                 'sort'  =>  true,
    65                 /* 是否能够按这个字段搜索 */
    66                 'search'    =>  true,
    67                 /* 字段进行翻译，比如栏目Id字段，一般要转成栏目名称显示 */
    68                 'lookup'    =>  false,
    69             ),
    70 
    71         ),
    72         // more fields
    73     ),
    74 
    75     /**
    76      * 全局form配置，优先级小于字段配置
    77      */
    78     'form_options'  =>  array(
    79         'layout'    =>  array(
    80             'cols'  =>  12,
    81             'label_cols' =>  1,
    82             'input_cols' =>  11,
    83         ),
    84     ),
    85 
    86     /**
    87      * 全局list配置，优先级小于字段配置
    88      */
    89     'list_options'  =>  array(
    90         'page'      =>  10,
    91         'create'    =>  true,
    92         'update'    =>  true,
    93         'delete'    =>  true,
    94     ),
    95 
    96 );

app/config/crud/admin.php

## 4.5 GModule 管理模块实现 ##

GModule是一类由DBuilder生成的模块，它有一组模板定义在app/template目录下：

*  app/template/\_form.tpl
 *  app/template/\_list.tpl
 *  app/template/controller.tpl
 *  app/template/model.tpl

前面设计中指出，GModule管理模块本身是一个名为“Module”，主表为d\_module，且手工建立的GModule，故其代码组成也是符合GModule规范的，笔者编写的代码主要为扩展代码。GModule管理模块对应了下述代码文件：

*  app/controllers/admin/ModuleController.php：控制器（Controller）代码，其实现CoreCRUD模块的接口，以及扩展的url接口；
 *  app/models/Module.php：GModule管理模块的模型；
 *  app/views/admin/module/\_form.blade.php： FORM视图代码，其在原有的CoreCRUD 模块的FORM表单下部，扩展了一组Tab，其中第一个Tab中显示了所有字段的详细配置，通过以上扩展就能实现在CoreCRUD生成的Form表单页面中对GModule进行配置；
 *  app/views/admin/module/\_list.blade.php： LIST视图代码；
 *  app/views/admin/module/fields\_config.blade.php：字段配置表格视图代码；
 *  app/views/admin/module/list\_item\_links.blade.php：扩展链接视图代码；
 *  app/config/crud/module.php：GModule Configuration文件。

下面贴上主要的代码文件ModuleController.php

![img_8f42589655ef7c6b5825b17895503e95.png][] ![img_405b18b4b6584ae338e0f6ecaf736533.gif][]

1 <?php
      2 /**
      3  * Created by PhpStorm.
      4  * User: lvyahui
      5  * Date: 2016/5/12
      6  * Time: 15:28
      7  */
      8 
      9 namespace admin;
     10 
     11 define('MODULE_ROUTES', json_encode(include(app_path() . '/module_routes.php')));
     12 
     13 use Illuminate\Support\Facades\Redirect;
     14 use SiteHelpers;
     15 use BaseModel;
     16 use Module;
     17 use ConfigUtils;
     18 use Illuminate\Support\Facades\Input;
     19 use Illuminate\Support\Facades\Config;
     20 use Illuminate\Support\Facades\Response;
     21 
     22 class ModuleController extends AdminController
     23 {
     24 
     25     protected function beforeEdit(&$data)
     26     {
     27         $data ['dataSources'] = SiteHelpers::loadDataSources();
     28         if ($data['model']->id) {
     29             $data ['moduleConf'] = ConfigUtils::get($data['model']->name);
     30         }
     31     }
     32 
     33     protected function afterSave($module)
     34     {
     35         /* 生成代码文件 */
     36         $codes = array(
     37             'moduleName'      => $module->name,
     38             'moduleTitle'     => $module->title,
     39             'tablePrimaryKey' => BaseModel::findPrimarykey($module->db_table, $module->db_source),
     40             'moduleNote'      => $module->note,
     41             'date'            => date('Y-m-d'),
     42             'dbSource'        => $module->db_source,
     43             'dbTable'         => $module->db_table,
     44         );
     45         $this->removeFiles($codes['moduleName']);
     46         /* 生成默认module Configuration*/
     47         $moduleConfs = $this->buildConfiguration($module->db_table, $module->db_source);
     48         SiteHelpers::saveArrayToFile(app_path('config/crud/') . snake_case($codes['moduleName']) . '.php', $moduleConfs);
     49 
     50         $controller = file_get_contents(app_path('template') . '/controller.tpl');
     51         $model = file_get_contents(app_path('template') . '/model.tpl');
     52         $formView = file_get_contents(app_path('template') . '/_form.tpl');
     53         $listView = file_get_contents(app_path('template') . '/_list.tpl');
     54         $codes['timestamps'] = isset($moduleConfs['fields']['created_at']) && isset($moduleConfs['fields']['updated_at'])
     55                                 ? 'true' : 'false';
     56         $buildController = SiteHelpers::blend($controller, $codes);
     57         $buildModel = SiteHelpers::blend($model, $codes);
     58         /* 生成 MVC 文件*/
     59         file_put_contents(app_path() . "/controllers/admin/{
         $codes['moduleName']}Controller.php", $buildController);
     60         file_put_contents(app_path() . "/models/{
         $codes['moduleName']}.php", $buildModel);
     61         $viewPath = app_path('/views/admin/') . snake_case($codes['moduleName']);
     62         if (!file_exists($viewPath)) mkdir($viewPath);
     63         file_put_contents($viewPath . "/_form.blade.php", $formView);
     64         file_put_contents($viewPath . "/_list.blade.php", $listView);
     65 
     66 
     67         /* 更新路由 */
     68         $moduleRoutes = json_decode(MODULE_ROUTES, true); //require(app_path().'/module_routes.php');
     69         if (is_array($moduleRoutes)) {
     70             $moduleRoutes[SiteHelpers::reducCase($codes['moduleName'])] = 'admin\\' . "{
         $codes['moduleName']}Controller";
     71             SiteHelpers::saveArrayToFile(app_path() . '/module_routes.php', $moduleRoutes);
     72         }
     73     }
     74 
     75     protected function beforeDelete($id)
     76     {
     77         $module = Module::find($id);
     78         $moduleName = $module->name;
     79         $this->removeFiles($moduleName);
     80     }
     81 
     82     /**
     83      * 删除GModule相关文件文件
     84      * @param $moduleName
     85      */
     86     public function removeFiles($moduleName)
     87     {
     88         $controller = app_path('admin/controllers') . "/{
         $moduleName}Controller.php";
     89         if (file_exists($controller)) {
     90             unlink($controller);
     91         }
     92         $model = app_path('models') . "/{
         $moduleName}.php";
     93         if (file_exists($model)) {
     94             unlink($model);
     95         }
     96         $moduleConf = app_path('config/crud/') . snake_case($moduleName) . '.php';
     97         if (file_exists($moduleConf)) {
     98             unlink($moduleConf);
     99         }
    100 
    101         $viewPath = app_path('/views/admin/') . snake_case($moduleName);
    102         $formFile = $viewPath . '/_form.blade.php';
    103         $listFile = $viewPath . '/_list.blade.php';
    104         if (file_exists($formFile)) unlink($formFile);
    105         if (file_exists($listFile)) unlink($listFile);
    106     }
    107 
    108     private function buildConfiguration($table, $connection)
    109     {
    110         $rawColumns = BaseModel::getTableColumns($table, $connection);
    111         $fields = ConfigUtils::build($rawColumns);
    112         return array(
    113             'data_source' => $connection,
    114             'table'       => $table,
    115             'fields'      => $fields,
    116         );
    117     }
    118 
    119     /**
    120      * 获取字段配置列表
    121      * @return bool
    122      */
    123     public function getFieldsConfig()
    124     {
    125         $filedsConfig = null;
    126         if (Input::has('module_name')) {
    127             $filedsConfig = ConfigUtils::get(Input::get('module_name'))['fields'];
    128         } else {
    129             $table = Input::get('table');
    130             $connection = Input::get('connection');
    131 
    132             $filedsConfig = $this->buildConfiguration($table, $connection)['fields'];
    133         }
    134 
    135         $resp = $this->makeView(array(
    136             'fieldsConfig' => $filedsConfig,
    137         ));
    138         if ($resp) {
    139             return $resp;
    140         }
    141     }
    142 
    143 
    144     /**
    145      * 保存字段列表配置
    146      * @return mixed
    147      */
    148     public function postSaveFieldsConf()
    149     {
    150         $resp = Redirect::action(get_class($this) . '@getEdit', Input::get('id'));
    151         $postFields = Input::get('fields');
    152         $moduleName = Input::get('module_key');
    153         $confKey = SiteHelpers::reducCase($moduleName);
    154         $savedConfig = ConfigUtils::get($confKey);
    155         foreach ($savedConfig['fields'] as $fieldName => &$savefield) {
    156             $postField = $postFields[$fieldName];
    157             $savefield['label'] = $postField['label'];
    158             $savefield['form']['show'] = isset($postField['form']['show']);
    159             $savefield['list']['show'] = isset($postField['list']['show']);
    160         }
    161         ConfigUtils::saveGModuleConf($confKey, $savedConfig);
    162         return $resp;
    163     }
    164 
    165     /**
    166      * 呈现某一字段的配置参数FORM
    167      * @return bool
    168      */
    169     public function getFieldConfig()
    170     {
    171         $moduleKey = Input::get('module_key');
    172         $field = Input::get('field');
    173 
    174         $moduleConfig = Config::get('crud/' . snake_case($moduleKey));
    175         $fieldConf = &$moduleConfig['fields'][$field];
    176         $dbSource = SiteHelpers::loadDataSources()[$moduleConfig['data_source']];
    177         $tables = BaseModel::getTableList($dbSource['database'],$moduleConfig['data_source']);
    178 
    179         $resp = $this->makeView(array(
    180             'field'       => $field,
    181             'fieldConfig' => $fieldConf,
    182             'moduleKey'   => $moduleKey,
    183             'tables'    =>  $tables,
    184             'connection'    =>  $moduleConfig['data_source'],
    185         ));
    186 
    187         if ($resp) return $resp;
    188     }
    189 
    190     /**
    191      * 保存某一字段的配置参数
    192      * @return \Illuminate\Http\JsonResponse
    193      */
    194     public function postFieldConfig()
    195     {
    196         $data = array(
    197             'success' => true,
    198         );
    199         $moduleKey = Input::get('module_key');
    200         $field = Input::get('field');
    201         $moduleConfig = Config::get('crud/' . snake_case($moduleKey));
    202         $fieldConf = &$moduleConfig['fields'][$field];
    203 
    204         $postFormConf = Input::get('form');
    205         $postListConf = Input::get('list');
    206         $postRelationConf = Input::get('relation');
    207         $fieldConf['form']['type'] = $postFormConf['type'];
    208         if((
    209                 $postFormConf['type'] === 'select'
    210                 || $postFormConf['type'] === 'radio'
    211                 || $postFormConf['type'] === 'checkbox'
    212             )
    213             && isset($postFormConf['options'])
    214             && $postFormConf['options']
    215         ){
    216             $rawOptions = explode(',',$postFormConf['options']);
    217             $options = array();
    218             foreach($rawOptions as $option){
    219                 $options[$option]   = $option;
    220             }
    221             $fieldConf['form']['options'] = $options;
    222         }
    223         $fieldConf['form']['placeholder'] = $postFormConf['placeholder'];
    224         $fieldConf['form']['rule']  =  $postFormConf['rule'];
    225         $fieldConf['list']['sort'] = isset($postListConf['sort']);
    226         $fieldConf['list']['search'] = $postListConf['search'];
    227 
    228         $fieldConf['relation']  =   $postRelationConf;
    229 
    230         SiteHelpers::saveArrayToFile(app_path('config/crud/' . snake_case($moduleKey) . '.php'), $moduleConfig);
    231 
    232         return Response::json($data);
    233     }
    234 }

ModuleController

## 4.6 部署 ##

DBuilder部署运行的操作系统可以是Windows或Linux，本文将基于LNMP（Linux+Nginx+MySQL+PHP）环境进行部署，详细部署环境要求：

*  PHP Version > 5.4
 *  MCrypt PHP 必须安装
 *  OpenSSL 必须安装
 *  MySQL Version > 5.4
 *  Nginx、Apache等服务器

首先，需要将DBuilder放置到Nginx的Default Server或者Vhost中，这里以Default Server为例。本文中DBuilder的根目录为

<table> 
 <tbody> 
  <tr> 
   <td> <p>/home/wwwroot/dbuilder/</p> </td> 
  </tr> 
 </tbody> 
</table>

编辑nginx.conf文件，修改server节点：

<table> 
 <tbody> 
  <tr> 
   <td> <p>server</p> <p>{ </p> <p>&nbsp;&nbsp; listen 80 default_server;</p> <p>&nbsp;&nbsp; #listen [::]:80 default_server ipv6only=on;</p> <p>&nbsp;&nbsp; #server_name www.lnmp.org;</p> <p>&nbsp;&nbsp; index index.html index.htm index.php;</p> <p>&nbsp;&nbsp; <strong>root&nbsp; /home/wwwroot/dbuilder;</strong></p> <p>&nbsp;</p> <p>&nbsp;&nbsp; #error_page&nbsp;&nbsp; 404&nbsp;&nbsp; /404.html;</p> <p>&nbsp;&nbsp; include enable-php.conf;</p> <p>&nbsp;</p> <p>&nbsp;&nbsp; <strong>location / { </strong></p> <p><strong>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; try_files $uri $uri/ /index.php?$query_string;</strong></p> <p><strong>&nbsp;&nbsp; }</strong></p> <p><strong>&nbsp;</strong></p> <p><strong>&nbsp;&nbsp; location ~ [^/]\.php(/|$)</strong></p> <p><strong>&nbsp;&nbsp; { </strong></p> <p><strong>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; # comment try_files $uri =404; to enable pathinfo</strong></p> <p><strong>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; try_files $uri =404;</strong></p> <p><strong>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; fastcgi_pass&nbsp; unix:/tmp/php-cgi.sock;</strong></p> <p><strong>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; #fastcgi_pass 127.0.0.1:9000;</strong></p> <p><strong>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; fastcgi_index index.php;</strong></p> <p><strong>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; include fastcgi.conf;</strong></p> <p><strong>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; #include pathinfo.conf;</strong></p> <p><strong>&nbsp;&nbsp; }</strong></p> <p>&nbsp;</p> <p>&nbsp;&nbsp; location /nginx_status</p> <p>&nbsp;&nbsp; { </p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; stub_status on;</p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; access_log&nbsp;&nbsp; off;</p> <p>&nbsp;&nbsp; }</p> <p>&nbsp;</p> <p>&nbsp;&nbsp; location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$</p> <p>&nbsp;&nbsp; { </p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; expires&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 30d;</p> <p>&nbsp;&nbsp; }</p> <p>&nbsp;</p> <p>&nbsp;&nbsp; location ~ .*\.(js|css)?$</p> <p>&nbsp;&nbsp; { </p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; expires&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 12h;</p> <p>&nbsp;&nbsp; }</p> <p>&nbsp;</p> <p>&nbsp;&nbsp; location ~ /\.</p> <p>&nbsp;&nbsp; { </p> <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; deny all;</p> <p>&nbsp;&nbsp; }</p> <p>&nbsp;</p> <p>&nbsp;&nbsp; access_log&nbsp; /home/wwwlogs/access.log&nbsp; access;</p> <p>}</p> </td> 
  </tr> 
 </tbody> 
</table>

修改DBuilder项目文件所属用户，保证nginx http进程对文件有读权限，本文部署环境中，nginx http进程为www用户进程；同时需要给部分DBuilder目录完全的写入权限，执行下列命令：

<table> 
 <tbody> 
  <tr> 
   <td> <p>cd /home/wwwroot</p> <p>chown –R www dbuilder</p> <p>chgrp –R www dbuilder</p> <p>cd dbuilder</p> <p>chmod –R 777 app/storage</p> <p>chmod -R 665 app/controllers/admin app/config/crud app/models/ app/views</p> </td> 
  </tr> 
 </tbody> 
</table>

建立数据库，在mysql中创建名为dbuilder的数据库，并source Dbuilder根目录下的dbuilder.sql，具体执行如下命令

<table> 
 <tbody> 
  <tr> 
   <td> <p># 首先进入msyql</p> <p>mysql –uroot –pyour_root_password</p> <p># 进入mysql之后</p> <p>create database dbuilder default char set utf8;</p> <p>use dbuilder;</p> <p>source /home/wwwroot/dbuilder/dbuilder.sql;</p> </td> 
  </tr> 
 </tbody> 
</table>

至此DBuilder部署完成，通过浏览器访问[http://hostname/admin][http_hostname_admin] （hostname为主机域名或ip地址）即可以访问到DBuilder。

## 4.7 案例 ##

设定：在不编写代码的基础上，以DBuilder生成一个简单可用的博客后台，博客后台有post表和category表，位于core数据源。

<table> 
 <tbody> 
  <tr> 
   <td> <p>CREATE TABLE post</p> <p>(</p> <p>&nbsp;&nbsp;&nbsp; id INT(11) PRIMARY KEY NOT NULL,</p> <p>&nbsp;&nbsp;&nbsp; category_id INT(11) NOT NULL,</p> <p>&nbsp;&nbsp;&nbsp; title VARCHAR(64) NOT NULL,</p> <p>&nbsp;&nbsp;&nbsp; short VARCHAR(256) NOT NULL,</p> <p>&nbsp;&nbsp;&nbsp; content TEXT NOT NULL,</p> <p>&nbsp;&nbsp;&nbsp; view_ct INT(11) DEFAULT '0' NOT NULL,</p> <p>&nbsp;&nbsp;&nbsp; created_at TIMESTAMP DEFAULT 'CURRENT_TIMESTAMP' NOT NULL,</p> <p>&nbsp;&nbsp;&nbsp; updated_at TIMESTAMP DEFAULT '0000-00-00 00:00:00' NOT NULL</p> <p>) DEFAULT CHAR SET utf8;</p> <p>&nbsp;</p> <p>CREATE TABLE category</p> <p>(</p> <p>&nbsp;&nbsp;&nbsp; id INT(11) PRIMARY KEY NOT NULL,</p> <p>&nbsp;&nbsp;&nbsp; title VARCHAR(32) NOT NULL,</p> <p>&nbsp;&nbsp;&nbsp; level INT(11),</p> <p>&nbsp;&nbsp;&nbsp; weight INT(11) DEFAULT '0' NOT NULL COMMENT '排序字段',</p> <p>&nbsp;&nbsp;&nbsp; parent_id INT(11),</p> <p>&nbsp;&nbsp;&nbsp; post_ct INT(11) DEFAULT '0' NOT NULL,</p> <p>) DEFAULT CHAR SET utf8;</p> </td> 
  </tr> 
 </tbody> 
</table>

### 4.7.1 新建GModule ###

准备好数据库表即可新建GModule，下面新建名为“Post”的GModule。进入GModule管理->新建界面，按图填写保存。

![img_d66a70d2b4ad6cbe599dbbefac376995.png][]

图4-1 新建GModule页面

编辑新建的Post GModule，可以看到在下部多出一个含有表格的tab。

![img_63a3ea13ad41c4a1503b63163b923cf7.png][]

图4-2 GModule Configuration字段配置页面

现在对于post表的所有字段都是默认配置，分别查看List和Form，可以看到List和Form都能正常读取数据库数据。

![img_4797eaa44422e45e54c01907dc91e23d.png][]

图4-3 GMoudle 列表页面

![img_2c8511f43b5f2ae1b2c37ac783211353.png][]

图4-4 GModule表单页面

上面两图呈现的List和Form并不具有可用性，因此需要对字段做配置。

### 4.7.2 GModule配置 ###

首先修改字段的中文名、是否包含在form、是否包含在List等属性。

![img_180a5ddce56a1715e0c0c4e0c6954053.png][]

图4-5 GModule Configuration字段配置页面

保存之后，再次刷新Post列表和Form。对比图4-3、图4-4发现内容发生了变化

![img_174933ee66e89325fef96c4208fda26e.png][]

图4-6 GModule列表页面

![img_d542b4d9d47b77f6e751b61f27c92f8a.png][]

图4-7 GModule表单页面

下面对每个字段做更详细的配置以得到更符合我们需求的页面，修改控件类型：short（摘要）字段为textarea（多行文本）类型，content（正文）字段为wysiwyg（富文本）类型，category\_id字段为select（下拉列表）类型，updated\_at（修改时间）为date（日期）类型。修改category\_id（栏目外键）的关系为所属关系，并填写如下：

![img_fdfa0b9f9090cf031046f8aa2b045dfa.png][]

图4-8 GModule 字段详细配置表单

修改short(摘要)字段、title（标题）字段为不可排序与like模糊搜索，修改updated\_at搜索方式为“>=”搜索

### 4.7.3 List&Form效果 ###

刷新Post列表，可看到如下两个控件：date和select控件。

![img_fc5f5ac5db9ef39b09bf62f84e25837a.png][]

图4-9 GModule 列表搜索日期与下拉列表控件

输入搜索条件为修改日期：2016-03-03、栏目：C++、摘要：收到。结果按阅读次数排序。得到下面的列表结果。

![img_9c3accf282caa11394f15a501a9410a3.png][]

图4-10 GModule 列表搜索与排序

点击其中一条记录进行编辑，测试Form功能。

![img_882b87f6d6215e9569355c1114bbf38d.png][]

图4-11 GModule编辑表单

修改之后点击保存也是正常可用的。

整个配置过程，只需几分钟，但却实现了上述较为复杂的功能。而如果换成开发人员手工编写类似功能模块，至少需要两三个小时的时间，相比之下，DBuilder极大的提高了开发效率。

# 第五章 总结与展望 #

本文基于WEB技术基本实现了一款可用的CRUD生成器，其内核实现比SximoBuilder更精简，在代码高度复用的前提下，提供更强的扩展性，并支持多数据库、前端验证、自定义表单控件等等。

由于时间原因，DBuilder尚未实现诸如用户管理、权限控制、操作日志记录、站点配置、多语言化等功能。另外，随着技术进步和网络普及，如何做到高并发、高性能以及支持数据集群的web系统是当前web项目开发需要着重考虑的问题。笔者将在DBuilder的后续改进中实现上述功能，并对高并发提供支持。同时，为了更好的推广和发展DBuilder，笔者已将DBuilder开源至Github：[https://github.com/lvyahui8/dbuilder.git][https_github.com_lvyahui8_dbuilder.git] 。

[https_github.com_lvyahui8_dbuilder.git]: https://github.com/lvyahui8/dbuilder.git
[DBuilder]: http://shang.qq.com/wpa/qunwpa?idkey=50fce48ad9655e4a6046c6018930f2fc719278d3bc613498336882d3567a4000
[img_f97387ee9c35506cfc2f98699f31a0b6.jpeg]: /images/20220212/c8fb69d2f0f245a9b2b6e5b076765ed4.png
[img_9ee0ea6aa11a7745949d586c6d4d229e.jpeg]: /images/20220212/24bdfd192c954b1ca6ffae4886196179.png
[img_ae669316687403a70af98e03b2986214.jpeg]: /images/20220212/414a7dd461ae4ad6ae110e2fda1213bd.png
[img_e0ace3b7be7d1b99057a5e359b485172.jpeg]: /images/20220212/fe1641f2c2f848969a5c03fcaabde049.png
[img_38f86277a1c220f8da3c3a4d0ef3f70a.jpeg]: /images/20220212/d99cbfd787c34332a488cec74b60cbe0.png
[img_1e906b68f960ebe775955734df05cf02.png]: /images/20220212/6534260fa04b4034926f593c1df5c0af.png
[img_8f42589655ef7c6b5825b17895503e95.png]: https://yqfile.alicdn.com/img_8f42589655ef7c6b5825b17895503e95.png
[img_405b18b4b6584ae338e0f6ecaf736533.gif]: /images/20220212/f45b0b951283465b952741db7901847e.png
[http_hostname_admin]: http://hostname/admin
[img_d66a70d2b4ad6cbe599dbbefac376995.png]: /images/20220212/bc2154841ef44288a4e10a5aace69e2f.png
[img_63a3ea13ad41c4a1503b63163b923cf7.png]: /images/20220212/a06a999d0e4e4a9596225bc84289b01a.png
[img_4797eaa44422e45e54c01907dc91e23d.png]: /images/20220212/37a55bde6ef641d39fcbbe5258e62a23.png
[img_2c8511f43b5f2ae1b2c37ac783211353.png]: /images/20220212/b8c913786a134f83a115333f3e1923eb.png
[img_180a5ddce56a1715e0c0c4e0c6954053.png]: /images/20220212/049b0b3a23314754ade4a9c3d60c39b8.png
[img_174933ee66e89325fef96c4208fda26e.png]: /images/20220212/20cc3f3ee2f54492a5ecc2e465eb7138.png
[img_d542b4d9d47b77f6e751b61f27c92f8a.png]: /images/20220212/a97814c199664ac69c0b7828dfe9e70a.png
[img_fdfa0b9f9090cf031046f8aa2b045dfa.png]: /images/20220212/ea1d5565aff446bbaa2f96b7dd485f93.png
[img_fc5f5ac5db9ef39b09bf62f84e25837a.png]: /images/20220212/2eed11cb6e84476699d165140a0f2091.png
[img_9c3accf282caa11394f15a501a9410a3.png]: /images/20220212/32267ec557c14b15989123c28d03cfd4.png
[img_882b87f6d6215e9569355c1114bbf38d.png]: /images/20220212/4f3bea19ef2d4cb5b14610ceeb242b89.png