如何将Drupal分页索引从0起始改为从1起始？

嘿，这个需求我之前在项目里刚好实现过，分享几个关键步骤帮你把Drupal的分页从0起始改成1起始，让URL里第一页显示?page=1：

1. 拦截并修改请求中的page参数 #

Drupal内部默认用page=0识别第一页，我们需要在请求进入系统前，把前端传入的page值减1，让内部逻辑保持兼容，同时对外展示1起始的页码。可以用hook_request_alter来实现：

/**
 * Implements hook_request_alter().
 */
function YOUR_MODULE_request_alter(&$request) {
  // 处理前端传入的page参数
  if ($request->query->has('page')) {
    $page = (int) $request->query->get('page');
    // 如果传入的page是1或更大，减1后传给系统；如果是0或负数，重置为0
    $request->query->set('page', max(0, $page - 1));
  }
}

2. 修改分页链接的生成逻辑 #

接下来要让Drupal生成的分页按钮链接（比如节点列表、Views的分页）显示?page=1而非?page=0，这需要调整分页链接的参数拼接逻辑，用hook_preprocess_pager来处理：

/**
 * Implements hook_preprocess_pager().
 */
function YOUR_MODULE_preprocess_pager(&$variables) {
  // 遍历所有分页链接项
  foreach ($variables['items'] as &$item) {
    // 替换已有的page参数值（加1）
    if (isset($item['href']) && strpos($item['href'], 'page=') !== FALSE) {
      $current_page = (int) substr(strrchr($item['href'], '='), 1);
      $new_page = $current_page + 1;
      $item['href'] = str_replace('page=' . $current_page, 'page=' . $new_page, $item['href']);
    }
    // 给「第一页」链接加上?page=1（避免默认不带page参数的情况）
    if (isset($item['text']) && $item['text'] == 'First' && strpos($item['href'], 'page=') === FALSE) {
      $item['href'] .= (strpos($item['href'], '?') !== FALSE ? '&' : '?') . 'page=1';
    }
  }
}

3. 处理Views分页的特殊情况 #

如果你的分页来自Views模块，可能需要额外调整Views的页码识别逻辑，确保分页数据正确加载：

/**
 * Implements hook_views_pre_view().
 */
function YOUR_MODULE_views_pre_view(&$view, &$display_id, &$args) {
  if ($view->display_handler->get_option('use_pager')) {
    // 获取经过预处理后的内部页码（0起始）
    $internal_page = \Drupal::request()->query->get('page', 0);
    // 给Views设置正确的当前页码
    $view->set_current_page($internal_page);
  }
}

关键注意事项 #

• 把代码里的YOUR_MODULE替换成你实际的自定义模块名称，确保模块处于启用状态
• 测试所有分页场景：节点列表、Views页面、自定义开发的分页组件，避免出现链接错误或数据偏移
• 修改后记得清空Drupal缓存，让新的hook逻辑生效
• 如果你有自定义开发的分页逻辑，手动调整页码计算：比如数据库查询的LIMIT偏移量，原本是$page * $limit，现在要改成($page - 1) * $limit（因为外部传入的page是1起始）

内容的提问来源于stack exchange，提问作者sam