七牛Base
===============

> 运行环境要求PHP7.2+，兼容PHP8.1
>
> 基于`ThinkPHP 6.0`框架开发

## 👇基本特性查看THINKPHP官方文档

[完全开发手册](https://www.kancloud.cn/manual/thinkphp6_0/content)

## 简单使用

* 使用命令行生成基本的Model，Services，Validate和Controller

~~~
php think make
~~~

可选参数

~~~
-t/-table  数据表名称，可不带前缀
~~~

~~~
-f/-force  默认不强制执行，值为1时强制执行，强制覆盖原有文件或删除
~~~

~~~
-s/-sort  指定排序字段，默认为sort，降序。
~~~

~~~
-d/-delete  删除模式，值为1时，删除对应4个文件
~~~

~~~
-p/-path  指定生成目录，默认情况下，根据数据表名生成路径。
例如:"user"默认会生成到"app/model"目录下。
但如有指定目录，例如指定 "-p user",则会生成到"app/model/user"目录下。
再如:"user_bill_log"默认会生成到"app/model/user/bill"目录下。
但如有指定目录，例如指定 "-p user",则也会生成到"app/model/user"目录下。
~~~

~~~
-x/-hidden  指定隐藏字段，隐藏字段不显示，也不进默认导出列表，使用","分割。
~~~

<b>自动生成的controller里面有自动生成的默认方法路由，复制到路由文件即可使用</b>

* 数据处理

后台默认根控制器（app\common\AdminBaseController）内默认有以下方法，可以进行数据处理

~~~
index 列表，可在控制器使用searchable指定查询字段，按需修改
save 新增，可在控制器内createParams字段处理数据，按下方结构
update 修改 同👆
delete 删除 数据库内有delete_time自动开启软删除
export 导出，导出字段在生成Service时有默认设置，按需要自行修改
~~~

* 数据库的建立

数据库表规则：

###### <h>一、特殊字段</h>

1. `add_time`：添加时间字段，存在这个字段的表会自动添加时间搜索器以及时间自动格式化方法，无需手动处理。
2. `delete_time`：删除标记字段，存在这个字段的表会自动添加软删除，无需手动处理。
3. `sort`：自定义排序字段，存在这个字段的表会优先按照该字段降序排列，否则默认按主键降序排列，再模型中存在$order参数，可以自定义排序规则。

###### <h>二、特殊后缀|类型</h>

1. 以`images`,`ids`,`files`,`list`为后缀的字段，会识别为列表字段
2. 以`time`为后缀的字段，以及，会识别为时间字段，自动格式化`Y-m-d H:i:s`格式
3. 以`phone`,`mobile`为后缀的字段，会识别为手机号字段，自动生成手机号验证规则
4. 以`email`为后缀的字段，会识别为邮箱字段，自动生成邮箱验证规则
5. 以`url`,`link`为后缀的字段，会识别为链接字段，自动生成链接验证规则
6. `set`类型的字段，会识别为多选字段，对注释有要求（详见三）
7. `enum`类型的字段，会识别为单选字段，对注释有要求（详见三）

###### <h>三、注释</h>
1. 尽量明确标注字段含义。
2. 多选字段，请使用`set`类型，并标注每个值所代表的含义，如：`types`字段，注释：`类型:1=类型1,2=类型2,3=类型3……`
3. 单选字段，请使用`enum`/`tinyint`类型，并标注每个值所代表的含义，如：`sex`字段，注释：`性别:1=男,2=女,0=保密`
4. 表注释内标注一下表名。