naisi_get_pagination

查看 Markdown

计算分页偏移、页数和总数信息;page 不在 1 至 998 时按兼容规则重置为 1。

函数签名

function naisi_get_pagination(int $page, int $row, int $count, int $max_total = 0, bool $is_simple_pagination = false): array

调用前提

应用入口先调用 naisi_is_ext_license_valid 并确认返回 true。只验证同一请求内已有的有效 FULL/BASIC 证明;没有证明或证明失效时立即返回失败值,不现场补做完整校验。

授权类别:LICENSE;执行模式:PROOF。许可不代替登录、租户或权限上下文;身份与数据要求见本页参数及用途说明。

参数

$page

  • 类型:int
  • 必填:是
  • 默认值:无
  • 方向:输入参数。

请求页码;1 至 998 原样使用,page <= 0 或 page >= 999 时按兼容规则重置为第 1 页,不作为失败。

$row

  • 类型:int
  • 必填:是
  • 默认值:无
  • 方向:输入参数。

每页条数,必须大于 0;否则返回空数组。

$count

  • 类型:int
  • 必填:是
  • 默认值:无
  • 方向:输入参数。

实际数据总条数;完整分页要求非负,简单分页保留接口约定的状态语义。

$max_total

  • 类型:int
  • 必填:否
  • 默认值:0
  • 方向:输入参数。

参与分页计算的最大数据条数;0 表示不额外限制。

$is_simple_pagination

  • 类型:bool
  • 必填:否
  • 默认值:false
  • 方向:输入参数。

是否只计算并返回简单分页所需字段。

返回值

类型:array

返回结果数组;未授权或处理失败时按接口契约返回空数组。

调用示例

当前请求须满足上方调用前提;请检查实际返回值和引用输出,随机结果及数据包内容以运行环境为准。

$page = 10;
$row = 10;
$count = 10;
$max_total = 0;
$is_simple_pagination = false;

$result = naisi_get_pagination($page, $row, $count, $max_total, $is_simple_pagination);
var_export($result);

版本信息

  • 自版本:1.0.6
  • 实现模块:pagination
  • 授权类别:LICENSE / PROOF
  • 失败回退:[]
  • 文档同步:2026-10-18