Yii框架CLinkPager分页组件传递变量报错，如何解决？

我之前也碰到过这个坑，咱们一步步来排查解决：

1. 先确认控制器里的分页逻辑是否正确 #

CLinkPager依赖CPagination实例来生成分页链接，你得先在控制器的action里正确创建并传递这个实例到视图，这是最容易出错的地方：

public function actionYourPage()
{
    // 第一步：获取总数据条数（必须！否则分页不知道总共有多少页）
    $totalCount = YourModel::model()->count(); // 或者用原生SQL统计也行

    // 第二步：创建CPagination实例
    $pages = new CPagination($totalCount);
    $pages->pageSize = 10; // 设置每页显示10条数据，可自定义

    // 第三步：查询分页后的数据
    $data = YourModel::model()->findAll(array(
        'limit' => $pages->pageSize,
        'offset' => $pages->currentPage * $pages->pageSize,
    ));

    // 第四步：把$pages和数据一起传到视图！重点！
    $this->render('your-view-name', array(
        'data' => $data,
        'pages' => $pages, // 必须传这个变量，视图里才能用
    ));
}

如果用CActiveDataProvider的话更简单，直接把provider的pagination传递过去就行：

$dataProvider = new CActiveDataProvider('YourModel', array(
    'pagination' => array('pageSize' => 10),
));
$this->render('your-view-name', array(
    'dataProvider' => $dataProvider,
    'pages' => $dataProvider->pagination,
));

2. 排查"未定义索引"的常见原因 #

你提到的"未定义索引"错误，大概率是这两个情况：

• 视图里的$pages变量根本不存在：检查控制器的render方法里有没有把$pages传进来，别漏写了。
• 分页参数名不匹配：CLinkPager默认用page作为URL里的分页参数（比如?page=2），如果你的URL规则修改了参数名（比如用p），得在CPagination里设置pageVar：

  $pages->pageVar = 'p'; // 这样分页链接就会变成?p=2
  

3. 视图里CLinkPager的正确写法 #

确保$pages是有效的CPagination实例后，视图里的代码就没问题了，还可以加一些自定义优化：

<?php $this->widget('CLinkPager', array(
    'pages' => $pages,
    'maxButtonCount' => 5, // 最多显示5个分页按钮，避免太长
    'header' => '<div class="pagination-header">共'.$pages->pageCount.'页</div>',
    'firstPageLabel' => '首页',
    'lastPageLabel' => '末页',
    'prevPageLabel' => '← 上一页',
    'nextPageLabel' => '下一页 →',
    'htmlOptions' => array('class' => 'pagination'), // 加个CSS类方便样式调整
)); ?>

最后快速排查步骤 #

1. 在视图开头加var_dump($pages);，看看是不是CPagination实例，要是显示undefined就是控制器没传对。
2. 检查控制器里有没有给CPagination设置总条数，没设置的话分页逻辑会直接报错。

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