Um Elemente in Seiten darzustellen muß Zend_Paginator einen generellen Weg des Zugriffs auf diese Daten haben. Für diesen Zweck, läuft jeder Datenzugriff über Datenquellen Adapter. Verschiedene Adapter werden mit dem Zend Framework standardmäßig ausgeliefert:

Um eine Instanz von Zend_Paginator zu erstellen, muß ein Adapter an den Konstruktor übergeben werden:

$paginator = new Zend_Paginator(new Zend_Paginator_Adapter_Array($array));

Der Einfachheit halber kann man für die mit dem Zend Framework mitgelieferten Adapter die statische factory() verwenden:

$paginator = Zend_Paginator::factory($array);

Auch wenn die Instanz in diesem Fall technische zu verwenden ist, muß in der Controller Aktion der Seitendarstellung mitgeteilt werden welche Seitennummer der Benutzer angefragt hat. Das erlaubt Ihm auf die seitenweisen Daten zuzugreifen.

$paginator->setCurrentPageNumber($page);

Der einfachste Weg um diesen Wert zu verfolgen ist über eine URL. Auch wenn wir empfehlen einen Zend_Controller_Router_Interface-kompatiblen Router zu verwenden um dies zu bewerkstelligen, ist das keine Notwendigkeit.

Das folgende ist eine Beispielroute die in einer INI Konfigurationsdatei verwendet werden könnte:

routes.example.route = articles/:articleName/:page
routes.example.defaults.controller = articles
routes.example.defaults.action = view
routes.example.defaults.page = 1
routes.example.reqs.articleName = \w+
routes.example.reqs.page = \d+

Mit der obigen Route (und der Verwendung der Zend Framework MVC Komponenten), kann die aktuelle Seitenzahl wie folgt gesetzt werden:

$paginator->setCurrentPageNumber($this->_getParam('page'));

Es sind auch andere Optionen vorhanden; siehe Konfiguration für zusätzliche Informationen.

Schlußendlich muß die Paginator Instanz der View angehängt werden. Wenn Zend_View mit dem ViewRenderer Action Helfer verwendet wird, dann funktioniert das folgende:

$this->view->paginator = $paginator;

Die Verwendung der meisten Adapter ist recht zielgerichtet. Trotzdem benötigen die Datenbank Adapter detailiertere Erklärungen betreffend dem Empfang und dem Zählen von Daten aus der Datenbank.

Um die DbSelect und DbTableSelect Adapter zu verwenden muß man die Daten nicht direkt von der Datenbank empfangen. Beide Adapter führen den Empfang selbst durch, und Zählen auch die Anzahl der Seiten. Wenn zusätzliche Arbeit basieren auf den Ergebnissen des Adapters getan werden soll, kann die getItems() Methode des Adapters in der eigenen Anwendung erweitert werden.

Zusätzlich holen diese Adapter nicht alle Einträge von der Datenbank um sie zu zählen. Stattdessen manipuliert der Adapter die originale Abfrage um die entsprechende COUNT Abfrage zu erzeugen. Paginator führt dann diese COUNT Abfrage aus um die Anzahl der Zeilen zu erhalten. Das erfordert eine zusätzliche Beanspruchung der Datenbank, ist aber um ein vielfaches schneller als das komplette Ergebnisset zu holen und count() zu verwenden. Speziell bei einer großen Anzahl an Daten.

Der Datenbank Adapter versucht die effizienteste Abfrage zu erstellen die auf ziemlich allen modernen Datenbanken ausgefürt wird. Trotzdem ist es möglich das, abhängig von der eigenen Datenbank oder sogar dem Setup des eigenen Schemas, ein effizienterer Weg existiert um die Anzahl der Zeilen zu erhalten. Für dieses Szenario erlaubt es der Datenbank Adapter eine eigene COUNT Abfrage zu setzen. Wenn man zum Beispiel die Anzahl der Blog Posts in einer eigenen Tabelle speichert, kann eine schnellere Abfrage der Anzahl mit dem folgenden Setup erreicht werden:

$adapter = new Zend_Paginator_Adapter_DbSelect($db->select()->from('posts'));
$adapter->setRowCount(
    $db->select()
       ->from(
           'item_counts',
           array(
               Zend_Paginator_Adapter_DbSelect::ROW_COUNT_COLUMN => 'post_count'
           )
       )
);

$paginator = new Zend_Paginator($adapter);

Dieser Ansatz wird jetzt wahrscheinlich keine große Performance Verbesserung bei kleinen Datemengen und oder einfachen Abfragen ergeben. Aber bei komplexen Abfragen und großen Datenmengen kann ein ähnlicher Weg eine signifikante Performance Verbesserung ergeben.

Das View Skript wird verwendet um die Seitenelemente darzustellen (wenn Zend_Paginator verwendet wird um das zu tun) und die Seitenkontrollen anzuzeigen.

Weil Zend_Paginator Das SPL Interface IteratorAggregate integriert, ist das Durchlaufen von Elementen und deren Darstellung einfach.

<html>
<body>
<h1>Beispiel</h1>
<?php if (count($this->paginator)): ?>
<ul>
<?php foreach ($this->paginator as $item): ?>
  <li><?php echo $item; ?></li>
<?php endforeach; ?>
</ul>
<?php endif; ?>

<?php echo $this->paginationControl($this->paginator,
                                    'Sliding',
                                    'my_pagination_control.phtml'); ?>
</body>
</html>

Der Aufruf des View Helfers fast am Ende ist zu beachten. PaginationControl nimmt bis zu vier Parameter: die Paginator Instanz, einen Scrolling Stil, eine partielle View und ein Array von zusätzlichen Parametern.

Die zweiten und dritten Parameter sind sehr wichtig. Wobei die partielle View verwendet wird um festzustellen wie die Seitenkontrollen aussehen sollten, und der Scrolling Stil verwendet wird um zu kontrollieren wie er sich verhalten sollte. Angenommen die partielle View ist im Stil einer Suchseiten Kontrolle, wie anbei:

Was passiert wenn der Benutzer den "next" Link ein paar Mal anklickt? Nun, viele Dinge könnten geschehen. Die aktuelle Seitennummer könnte in der Mitte stehen während man durchklickt (wie sie es auf Yahoo macht!), oder sie könnte bis zum Ende des Seitenbereichs ansteigen und dann auf der linken Seite erscheinen wenn der Benutzer ein weiteres Mal "next" klickt. Die Seitennummer könnte sogar größer und kleiner werden während der Benutzer auf sie zugreift (oder "scrollt). (wie es auf Google geschieht).

Es gibt view Scrolling Stile die mit dem Zend Framework geliefert werden:

Der vierte und letzte Parameter ist reserviert für ein assoziatives Array an zusätzlichen Variablen das in der partiellen View vorhanden sein sill (über $this). Für Instanzen, können diese Werte extra URL Parameter für Seitendarstellungslinks enthalten.

Durch das Setzen von einer standardmäßigen partiellen View, einem standardmäßigen Scrolling Stil und einer View Instanz kann dei Aufruf der PaginationControl komplett eliminiert werden:

Zend_Paginator::setDefaultScrollingStyle('Sliding');
Zend_View_Helper_PaginationControl::setDefaultViewPartial(
    'my_pagination_control.phtml'
);
$paginator->setView($view);

Wenn alle diese Werte gesetzt sind, kann die Seitenkontrolle im View Skript mit einem einfachen echo Statement dargestellt werden:

<?php echo $this->paginator; ?>

$smarty->assign('pages', $paginator->getPages());

{$pages->pageCount}

<!--
Siehe http://developer.yahoo.com/ypatterns/pattern.php?pattern=searchpagination
-->

<?php if ($this->pageCount): ?>
<div class="paginationControl">
<!-- Vorheriger Seitenlink -->
<?php if (isset($this->previous)): ?>
  <a href="<?php echo $this->url(array('page' => $this->previous)); ?>">
    &lt; Vorher
  </a> |
<?php else: ?>
  <span class="disabled">&lt; Vorher</span> |
<?php endif; ?>

<!-- Anzahl an Seitenlinks -->
<?php foreach ($this->pagesInRange as $page): ?>
  <?php if ($page != $this->current): ?>
    <a href="<?php echo $this->url(array('page' => $page)); ?>">
      <?php echo $page; ?>
    </a> |
  <?php else: ?>
    <?php echo $page; ?> |
  <?php endif; ?>
<?php endforeach; ?>

<!-- Nächster Seitenlink -->
<?php if (isset($this->next)): ?>
  <a href="<?php echo $this->url(array('page' => $this->next)); ?>">
    Nächster &gt;
  </a>
<?php else: ?>
  <span class="disabled">Nächster &gt;</span>
<?php endif; ?>
</div>
<?php endif; ?>

<!--
Siehe http://developer.yahoo.com/ypatterns/pattern.php?pattern=itempagination
-->

<?php if ($this->pageCount): ?>
<div class="paginationControl">
<?php echo $this->firstItemNumber; ?> - <?php echo $this->lastItemNumber; ?>
of <?php echo $this->totalItemCount; ?>

<!-- First page link -->
<?php if (isset($this->previous)): ?>
  <a href="<?php echo $this->url(array('page' => $this->first)); ?>">
    First
  </a> |
<?php else: ?>
  <span class="disabled">First</span> |
<?php endif; ?>

<!-- Vorheriger Seitenlink -->
<?php if (isset($this->previous)): ?>
  <a href="<?php echo $this->url(array('page' => $this->previous)); ?>">
    &lt; Vorheriger
  </a> |
<?php else: ?>
  <span class="disabled">&lt; Vorheriger</span> |
<?php endif; ?>

<!-- Next page link -->
<?php if (isset($this->next)): ?>
  <a href="<?php echo $this->url(array('page' => $this->next)); ?>">
    Nächster &gt;
  </a> |
<?php else: ?>
  <span class="disabled">Nächster &gt;</span> |
<?php endif; ?>

<!-- Last page link -->
<?php if (isset($this->next)): ?>
  <a href="<?php echo $this->url(array('page' => $this->last)); ?>">
    Last
  </a>
<?php else: ?>
  <span class="disabled">Last</span>
<?php endif; ?>

</div>
<?php endif; ?>

<?php if ($this->pageCount): ?>
<select id="paginationControl" size="1">
<?php foreach ($this->pagesInRange as $page): ?>
  <?php $selected = ($page == $this->current) ? ' selected="selected"' : ''; ?>
  <option value="<?php
        echo $this->url(array('page' => $page)); ?>"<?php echo $selected ?>>
    <?php echo $page; ?>
  </option>
<?php endforeach; ?>
</select>
<?php endif; ?>

<script type="text/javascript"
     src="http://ajax.googleapis.com/ajax/libs/prototype/1.6.0.2/prototype.js">
</script>
<script type="text/javascript">
$('paginationControl').observe('change', function() {
    window.location = this.options[this.selectedIndex].value;
})
</script>