CPagination

function actionIndex(){
    $criteria=new CDbCriteria();
    $count=Article::model()->count($criteria);
    $pages=new CPagination($count);

    // results per page
    $pages->pageSize=10;
    $pages->applyLimit($criteria);
    $models=Article::model()->findAll($criteria);

    $this->render('index', array(
    'models' => $models,
         'pages' => $pages
    ));
}

<?php foreach($models as $model): ?>
    // display a model
<?php endforeach; ?>

// display pagination
<?php $this->widget('CLinkPager', array(
    'pages' => $pages,
)) ?>

Подробное описание свойств

currentPage свойство

public integer getCurrentPage(boolean $recalculate=true)
public void setCurrentPage(integer $value)

индекс текущей страницы (нумерация с нуля). По умолчанию 0.

itemCount свойство

public integer getItemCount()
public void setItemCount(integer $value)

общее количество элементов. По умолчанию 0.

limit свойство только для чтения (доступно с версии v1.1.0)

public integer getLimit()

предел данных. Может быть использован для установки значения LIMIT для SQL-запроса, чтобы получить текущую страницу данных. Возвращает то же значение, что и pageSize.

offset свойство только для чтения (доступно с версии v1.1.0)

public integer getOffset()

смещение данных. Может быть использовано для установки значения OFFSET в SQL-запросе для извлечения текущей страницы данных.

pageCount свойство только для чтения

public integer getPageCount()

количество страниц

pageSize свойство

public integer getPageSize()
public void setPageSize(integer $value)

количество элементов на странице. По умолчанию 10.

pageVar свойство

public string $pageVar;

имя переменной GET, хранящей индекс текущей страницы. По умолчанию 'page'.

params свойство

public array $params;

параметры (имя=>значение), которые следует использовать вместо GET при генерации URL-адресов пагинации. По умолчанию null, что означает использование имеющихся GET-параметров.

route свойство

public string $route;

маршрут (ID контроллера и ID действия) для отображения постраничного содержимого. По умолчанию пустая строка, что означает использование текущего маршрута.

validateCurrentPage свойство (доступно с версии v1.1.4)

public boolean $validateCurrentPage;

необходимо ли гарантировать, что currentPage возвращает допустимый номер страницы. Когда это свойство истинно, значение, возвращаемое currentPage, всегда будет между 0 и (pageCount-1). Поскольку pageCount зависит от правильного значения itemCount, это означает, что вам необходимо знать общее количество элементов данных, когда вы хотите получить доступ к currentPage. Это подходит для запросов на основе SQL, но может быть нецелесообразно для других типов запросов (например, MongoDB). В таких случаях вы можете установить это свойство в false, чтобы пропустить проверку (тогда вам нужно будет выполнить проверку самостоятельно). По умолчанию значение true.

Подробное описание методов

__construct() метод

public void __construct(integer $itemCount=0)

public function __construct($itemCount=0)
{
    $this->setItemCount($itemCount);
}

Конструктор.

applyLimit() метод

public void applyLimit(CDbCriteria $criteria)

public function applyLimit($criteria)
{
    $criteria->limit=$this->getLimit();
    $criteria->offset=$this->getOffset();
}

Применяет LIMIT и OFFSET к указанным критериям запроса.

createPageUrl() метод

public string createPageUrl(CController $controller, integer $page)

public function createPageUrl($controller,$page)
{
    $params=$this->params===null ? $_GET : $this->params;
    if($page>0) // page 0 is the default
        $params[$this->pageVar]=$page+1;
    else
        unset($params[$this->pageVar]);
    return $controller->createUrl($this->route,$params);
}

Создает URL-адрес, подходящий для пагинации. Этот метод главным образом вызывается паджинаторами при создании URL-адресов, используемых для пагинации. По умолчанию вызывается метод createUrl контроллера с информацией о странице. Вы можете переопределить этот метод, если ваша схема URL-адресов не такая, как поддерживается методом createUrl контроллера.

getCurrentPage() метод

public integer getCurrentPage(boolean $recalculate=true)

public function getCurrentPage($recalculate=true)
{
    if($this->_currentPage===null || $recalculate)
    {
        if(isset($_GET[$this->pageVar]))
        {
            $this->_currentPage=(int)$_GET[$this->pageVar]-1;
            if($this->validateCurrentPage)
            {
                $pageCount=$this->getPageCount();
                if($this->_currentPage>=$pageCount)
                    $this->_currentPage=$pageCount-1;
            }
            if($this->_currentPage<0)
                $this->_currentPage=0;
        }
        else
            $this->_currentPage=0;
    }
    return $this->_currentPage;
}

getItemCount() метод

public integer getItemCount()

public function getItemCount()
{
    return $this->_itemCount;
}

getLimit() метод (доступно с версии v1.1.0)

public integer getLimit()

public function getLimit()
{
    return $this->getPageSize();
}

getOffset() метод (доступно с версии v1.1.0)

public integer getOffset()

public function getOffset()
{
    return $this->getCurrentPage()*$this->getPageSize();
}

getPageCount() метод

public integer getPageCount()

public function getPageCount()
{
    return (int)(($this->_itemCount+$this->_pageSize-1)/$this->_pageSize);
}

getPageSize() метод

public integer getPageSize()

public function getPageSize()
{
    return $this->_pageSize;
}

setCurrentPage() метод

public void setCurrentPage(integer $value)

public function setCurrentPage($value)
{
    $this->_currentPage=$value;
    $_GET[$this->pageVar]=$value+1;
}

setItemCount() метод

public void setItemCount(integer $value)

public function setItemCount($value)
{
    if(($this->_itemCount=$value)<0)
        $this->_itemCount=0;
}

setPageSize() метод

public void setPageSize(integer $value)

public function setPageSize($value)
{
    if(($this->_pageSize=$value)<=0)
        $this->_pageSize=self::DEFAULT_PAGE_SIZE;
}