ThinkPHP分页post请求实现post方式分页处理-ThinkPHP-PHP中文网

thinkphp分页默认不支持post请求，因其paginate()依赖get参数生成分页链接，而post无url参数，刷新或点击分页链接会转为get导致数据丢失；需手动传page参数并调用setpage()覆盖默认页码，再自定义表单提交或改用ajax。

thinkphp分页post请求实现post方式分页处理

ThinkPHP 分页为什么默认不支持 POST 请求

ThinkPHP 的 paginate() 方法底层依赖 URL 参数（GET）生成分页链接，直接调用时会把当前请求的 $_GET 中的 page 参数提取出来做偏移计算。POST 请求本身不携带可点击的 URL 参数，浏览器刷新或点击分页链接时会变成 GET，导致 POST 数据丢失、表单重复提交或 405 错误。

这不是 ThinkPHP 的 bug，而是 HTTP 协议和分页交互逻辑的天然冲突：分页链接本质是 GET 导航，而业务表单提交需要 POST 保数据。

如果你只是想“让分页按钮走 POST”，那必须自己接管分页 HTML 渲染，不能依赖 ->render() 自动生成的 a 标签
服务端仍需能从 POST 请求中识别当前页码，比如从 $_POST['page'] 或隐藏字段读取，而不是只看 $_GET['page']
ThinkPHP 6.x 的 paginate() 默认不检查 POST，所以你得手动传入页码

手动传入 page 参数并禁用自动 GET 解析

核心是绕过 paginate() 对 $_GET['page'] 的默认读取，改用你可控的来源（如 POST、session 或自定义字段）。

示例：控制器中接收 POST 表单并分页

// 控制器方法
public function search()
{
    $where = [];
    if ($keyword = $this->request->post('keyword/s')) {
        $where['title'] = ['like', "%{$keyword}%"];
    }

    // 手动获取 page，优先从 POST 取，fallback 到 GET（兼容直接访问）
    $page = (int) $this->request->post('page/d', 1);
    $page = max(1, $page);

    // 构造查询，手动传入 page 和每页数量
    $list = Db::name('article')
        ->where($where)
        ->paginate([
            'list_rows' => 10,
            'page'      => $page,
            'var_page'  => 'page', // 这个 key 仅影响后续 render() 中的参数名，不参与当前查询
        ]);

    // 关键：重置分页对象的当前页，否则 render() 仍会读 $_GET
    $list->setPage($page);

    $this->assign('list', $list);
    return $this->fetch();
}

setPage($page) 是关键，它覆盖了分页对象内部的当前页状态，避免 render() 渲染时再去查 $_GET
var_page 设置的是分页链接里用的参数名（如 ?page=2），不影响 POST 场景的数据来源；但如果你后续要让 JS 提交分页，就得统一这个 key
不要在模板里直接写 {$list->render()} —— 它生成的是 GET 链接，必须重写分页 HTML

模板中用 form 替代 a 标签实现 POST 分页

不能再用默认的 {$list->render()}，得手写每个分页项为 <form method="post"></form>，把当前页码作为 hidden 字段提交。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

示例模板片段（ThinkPHP 6 模板语法）：

{notempty name="list"}
<div class="pagination">
    <form method="post" class="page-form">
        <input type="hidden" name="keyword" value="{$Think.post.keyword|default=''}"><input type="hidden" name="page" value="1"><button type="submit">首页</button>
    </form>

    {if $list->currentPage() > 1}
    <form method="post" class="page-form">
        <input type="hidden" name="keyword" value="{$Think.post.keyword|default=''}"><input type="hidden" name="page" value="{$list->currentPage()-1}"><button type="submit">上一页</button>
    </form>
    {/if}

    {volist name="list->render().links" id="link"}
        {if strpos($link, 'href') !== false}
            <form method="post" class="page-form">
                <input type="hidden" name="keyword" value="{$Think.post.keyword|default=''}"><input type="hidden" name="page" value="{:get_url_param($link, 'page')}"><button type="submit">{:strip_tags($link)}</button>
            </form>
        {else /}
            <span class="current">{:strip_tags($link)}</span>
        {/if}
    {/volist}

    {if $list->hasMore()}
    <form method="post" class="page-form">
        <input type="hidden" name="keyword" value="{$Think.post.keyword|default=''}"><input type="hidden" name="page" value="{$list->currentPage()+1}"><button type="submit">下一页</button>
    </form>
    {/if}

    <form method="post" class="page-form">
        <input type="hidden" name="keyword" value="{$Think.post.keyword|default=''}"><input type="hidden" name="page" value="{$list->lastPage()}"><button type="submit">尾页</button>
    </form>
</div>
{/notempty}

每个 <form></form> 都带完整业务参数（如 keyword），否则翻页后搜索条件丢失
注意 get_url_param() 是自定义函数，用于从原始 $link HTML 中提取 href="?page=3" 里的 page 值；也可以改用正则或简单字符串截取
按钮样式靠 CSS 控制，避免多个 submit 挤在一起，建议加 .page-form { display: inline-block; }