Download the PHP package hxc/curd without Composer

代码生成工具

代码生成工具主要用于生成后端开发中简单的增删改查代码，复杂的逻辑还需自己实现，不过你无须担心，我们通过简单的封装简化了开发流程，即便你是新手，也可以写出出色的代码。

工具基于ThinkPHP 5.0开发。

安装

生成工具的开启

项目根目录下运行 php think hxc命令即可；根目录下生成的hxc.lock不可删除。

框架说明

框架核心功能为代码生成；主要分为两个大的模块，即前台，后台；目前数据库的操作均为ThinkPHP 5.0中的模型方式。

关于性能

为了优化查询性能，默认全部的数据库查询走缓存方式，当然，你也可以在控制器中自己选择是否开启；对此也解决了在执行数据库的增，改，删操作的时候，缓存也会即时刷新，前提是你必须使用model的方式。

如何使用

操作之前请先完善数据表，以下全部操作都是基于数据表的字段。

名词解释

• 字段，数据库中的字段名
• 类型，该字段在数据库中的字段类型
• 注释，字段在数据库中的注释

开启生成工具

在项目根目录执行以下命令：

执行完毕后访问项目域名/generate即可。

配置文件

开启生成工具时会在APP_PATH/extra/curd.php生成配置文件，详情查看文件中的注释。如果此文件存在则不会覆盖，请自行检查内容是否完整。

选项说明

此章节针对生成工具界面上的选项进行简单说明

• 业务选择：选择生成前台还是后台代码，前台生成到\app\app中，后台生成到\app\admin中。 无论前台还是后台，模型均生成到\app\common\model中，因此，可能会提示模型已存在，这是正常的。
• 数据表：根据哪个表的结构来生成。
• 创建：需要生成的内容，如果已有同名文件，则不生成。
• 控制器名称：控制器默认按照表名命名，你可以更改它。
• 模型选项：ThinkPHP 5.0模型提供的功能，详情请查看ThinkPHP 5.0文档。
• 允许的操作：前台可指定允许的操作。
• 登录访问：前台将根据此选项继承不同的类。
• 名称：例如form中的label名称，用于：列表页，新增加页，编辑页，验证器字段描述。
• 操作：该字段是否需要进行增，改，查的操作。
• 检索：这个字段是否用于查询，在列表页的顶部展示。
• 业务类型：选择输入方式，用于新增页、编辑页和列表页的搜索。
• 排序：此字段是否参与排序以及排序方式，如果多个字段参与排序，生成后可能需要调整顺序。
• 必填：将根据此内容生成验证器。
• 类型自动转换：ThinkPHP 5.0模型提供的功能，详情请查看ThinkPHP 5.0文档。

生成内容

数据库相关操作均使用ThinkPHP 5.0的模型操作，具体参考ThinkPHP 5.0文档

后台

• 在生成的控制器中，会有以下固定属性

protected $modelName  = '模型名'; 
protected $indexField = ['列表页要显示字段']; 在日常开发中，我们需要在列表中追加表格的列，首先我们需要在这里进行编辑
protected $addField = ['新增页面的表单输入字段'];
protected $editField = ['编辑页面的表单输入字段'];
/**
 * 条件查询，字段名,例如：无关联查询['name','age']，关联查询['name','age',['productId' => 'product.name']],解释：参数名为productId,关联表字段p.name
 * 默认的类型为输入框，如果有下拉框，时间选择等需求可以这样定义['name',['type' => ['type','select']]];目前有select,time_start,time_end三种可被定义
 * 通过模型定义的关联查询，可以这样定义['name',['memberId'=>['member.nickname','relation']]],只能有一个被定义为relation，且字段前的表别名必须为关联的方法名
 * @var array
 */
protected $searchField = [];
protected $pageSize = 10;                 //当前页面显示的数据数量，用于分页
//添加数据验证规则，参考tp5的验证规则
protected $add_rule = [
    'nickName|昵称'  => 'require|max:25'
];
//编辑数据验证规则，参考tp5的验证规则
protected $edit_rule = [
    'nickName|昵称'  => 'require|max:25'
];

• 针对默认操作，定义了以下钩子方法（方法所在命名空间：\Hxc\Curd\Traits\Admin\Common），如有需要，复制到生成的控制器中进行修改即可。

  • 列表页

  • 添加页

  • 修改页

  • 删除操作

前台

• 前台生成的控制器有get、post、put、delete四个方法，对应实现了基础的查、增、改、删操作， 如需自定义逻辑，复制\Hxc\Curd\Traits\Admin\Common中的方法到控制器中进行修改。

• 前台生成的控制器，包含以下固定属性：

模型

当前版本生成的模型，全部位于\app\common\model，前后台使用统一的模型类。具体属性含义，请参考模型内注释和ThinkPHP 5.0文档。

前台接口

默认提供四个接口，路径一致，通过请求方式和参数进行区分，不影响自定义的方法，详见下方表格：

数据返回

目前工具封装了统一的返回方法，位于\Hxc\Curd\Traits\JsonReturn，提供了以下方法

项目上线

• 务必将根目录下的hxc.lock文件删除
• 本项目建议在php7.0以上的环境中运行，如使用php5.6，请将php.ini中的always_populate_raw_post_data值改为-1

参考文档

• ThinkPHP5.0完全开发手册