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开始的自增键,值为一行记录的集合的一维数组;在第二维数组中,键为字段名,值为该条记录中字段所对应的记录值。