Page
<br/>
>i 本文档的最新修订日期是:
> **2023-09-13**
# Page ::
以分页的方式执行Db模块的SelectMore()方法。
# 依赖
本模块依赖于另一模块 <font color="#c7254e">`Db`</font> 。
# get()
## 说明
**<font color="#0099ff"><font color="#ff6600">Page</font> :: <font color="#ff6600">get</font> ( <kbd>传参数组</kbd> )</font>**
以分页的方式执行Db模块的selectMore()方法,并获得分页结果。
>d 务必注意对来自于用户提交的数据进行安全过滤(使用Filter模块中的方法),如果最终执行的语句出现额外的 <font color="#c7254e">`'`</font> 等SQL语法符号时,框架将报错。
此方法 <font color="#c7254e">`支持`</font> 中文参数名。
## 参数
* **<font color="#ff6600">`page(页码)`</font>** <font color="#0099ff">`(Int)`</font> <font color="#BBBBBB">`<必须>`</font>:
用以指定查询的是 <font color="#c7254e">`第几页`</font> 的记录。
* **<font color="#ff6600">`number(数量)`</font>** <font color="#0099ff">`(Int)`</font> <font color="#BBBBBB">`<必须>`</font>:
用以指定每一页有 <font color="#c7254e">`多少条`</font> 记录。
当值为 <font color="#c7254e">`0`</font> 时,则代表获取 <font color="#c7254e">`所有记录`</font> 。
以下参数详见 <font color="#c7254e">`Db`</font> 模块 <font color="#c7254e">`公共参数`</font> 部分的说明:
* **<font color="#ff6600">`table(表)`</font>** <font color="#0099ff">`(String | Array)`</font> <font color="#BBBBBB">`<必须>`</font>
* **<font color="#ff6600">`field(字段)`</font>** <font color="#0099ff">`(String | Array)`</font> <font color="#BBBBBB">`NULL`</font>
* **<font color="#ff6600">`value(值)`</font>** <font color="#0099ff">`(String | Array)`</font> <font color="#BBBBBB">`NULL`</font>
* **<font color="#ff6600">`condition(条件)`</font>** <font color="#0099ff">`(String | Array)`</font> <font color="#BBBBBB">`'='`</font>
* **<font color="#ff6600">`order(顺序)`</font>** <font color="#0099ff">`(String | Array)`</font> <font color="#BBBBBB">`NULL`</font>
* **<font color="#ff6600">`desc(降序)`</font>** <font color="#0099ff">`(Bool | Array)`</font> <font color="#BBBBBB">`FALSE`</font>
* **<font color="#ff6600">`index(索引)`</font>** <font color="#0099ff">`(Int)`</font> <font color="#BBBBBB">`NULL`</font>
* **<font color="#ff6600">`field_limit(字段限制)`</font>** <font color="#0099ff">`(String | Array)`</font> <font color="#BBBBBB">`*`</font>
* **<font color="#ff6600">`sql(sql)`</font>** <font color="#0099ff">`(String)`</font> <font color="#BBBBBB">`NULL`</font>
* **<font color="#ff6600">`debug(调试)`</font>** <font color="#0099ff">`(Bool)`</font> <font color="#BBBBBB">`FALSE`</font>
## 返回
<font color="#0099ff">`(Array)`</font> 类型。
返回值为三维数组,在第一维的数组中,有两个元素:
* 元素 <font color="#c7254e">`info`</font> 是一个一维数组,包含以下元素:
<font color="#c7254e">`['info']['now_page']`</font> 代表当前页码;
<font color="#c7254e">`['info']['total_page']`</font> 代表总页数;
<font color="#c7254e">`['info']['page_number']`</font> 代表每页条目数量(与传入的参数值相同);
<font color="#c7254e">`['info']['total_number']`</font> 代表总记录数;
<font color="#c7254e">`['info']['start_number']`</font> 代表当前结果集在所有结果中的起始序号;
<font color="#c7254e">`['info']['end_number']`</font> 代表当前结果集在所有结果中的结束序号。
* 元素 <font color="#c7254e">`result`</font> 是一个二维数组,在第一维数组中,键为从0开始的自增键,值为一行记录的集合的一维数组;在第二维数组中,键为字段名,值为该条记录中字段所对应的记录值。