ここではSymgony1.0.17をベースにデータベースを参照したページネーション機能とデータベースへの参照問合せで頻繁に使用する演算子の使用例について紹介します。

ページネーション

アクションクラスへメソッドの追加

アクションクラスへ次のメソッドを追加します。

  // 省略  

  public function executeList()
  {
    $c = new Criteria();
    $c->add(ProductPeer::＜カラム名＞, ＜値＞, ＜演算子(クラスメゾット)＞);
    $c->addDescendingOrderByColumn(ProductPeer::NAME);

    $pager = new sfPropelPager('Product', ＜表示させる件数＞);
    $pager->setCriteria($c);
    $pager->setPage($this->getRequestParameter('page', 0));
    $pager->init();

    $this->pager = $pager;
  }

改ページリンクの作成

次にページャーリンクの関数を用意します。

アプリケーションディレクトリ内のlibディレクトリ内にhelperディレクトリを作成し次のファイルを作成します。

作成ファイル：PagerHelper.php

<?php

function pager_navigation($pager, $uri, $num = 8, $attach= '')
{
  $navigation = '';

  if ($pager->haveToPaginate())
  {
    $uri .= (preg_match('/\?/', $uri) ? '&' : '?');
    $uri .= 'page=';

    if($num + 1 < $pager->getPage()){
      $navigation .= '<li>'.link_to('<<', $uri.'1').'</li>';
    }
    if ($pager->getPage() > 1){
      $navigation .= '<li>'.link_to('<', $uri.$pager->getPreviousPage()).'</li>';
    }

    $stcnt = ($pager->getPage() <= $num) ? 1 : $pager->getPage() - $num;
    $encnt = ($pager->getPage() > ($pager->getLastPage() - 3)) ? $pager->getLastPage() : $pager->getPage() + $num;
    if($encnt > $pager->getLastPage()){
      $encnt = $pager->getLastPage();
    }

    for($i = $stcnt; $i <= $encnt; $i++)
    {
      if ($i == $pager->getPage()) {
        // if ($page == $pager->getPage()) {
        $navigation .= '<li class="active"><a href="#">'.$i.'</a></li>';
      }else {
        $navigation .= '<li>'.link_to($i, $uri.$i).'</li>';
      }
    }


    if($pager->getPage() <  $pager->getLastPage()){
      $navigation .= '<li>'.link_to('>', $uri.$pager->getNextPage()).'</li>';
    }
    if($pager->getPage() + $num <  $pager->getLastPage()){
      $navigation .= '<li>'.link_to('>>', $uri.$pager->getLastPage()).'</li>';
    }
  }

  return '<ul class="pagination '.$attach.'">'.$navigation.'</ul>';
}

ページ情報（プロパティ）の作成

先程作成したPageHelper.phpに表示しているページが全何件中、何処から何処まで表示しているか表示する機能を追加します。

function pager_infomation($pager, $format = '{total}件中 （{from}～{to}件表示）', $emp = 'Not found.')
{
  $infomation = '';
  if ($pager->getNbResults() > 0 ) {
    $total = $pager->getNbResults();
    if ($total > 0) {
      $from = $pager->getMaxPerPage() * ($pager->getPage()  - 1) + 1;
    }else {
      $from = $pager->getMaxPerPage() * ($pager->getPage()  - 1);
    }
    $to = $pager->getMaxPerPage() * ($pager->getPage()  - 1) + count($pager->getResults());
    $infomation = str_replace('{total}', $total, $format);
    $infomation = str_replace('{from}', $from, $infomation);
    $infomation = str_replace('{to}', $to, $infomation);
  }else {
    $infomation = $emp;
  }
  return $infomation;
}

ビュー（テンプレート）の作成

次はビューファイル（listSuccess.php）の内容です。

<?php use_helper('Pager') ?>
<table>
  <caption><?php echo pager_infomation($pager) ?></caption>
  <thead>
    <th>品名</th>
    <th>状態</th>
    <th>金額</th>
    <th>製造番号</th>
  </thead>
  <tbody>
    <?php foreach($pager->getResults() as $product): ?>
      <tr>
        <th><?php echo $product->getName() ?></th>
        <th><?php echo $product->getStatus() ?></th>
        <th><?php echo $product->getPrice() ?></th>
        <th><?php echo $product->getSerial() ?></th>
      </tr>
    <?php endforeach; ?>
  </tbody>
</table>
<?php echo pager_navigation($pager, '＜アクションクラス名＞/list') ?>

Propelのページネーションの例は以上です。

SQLの演算子の使用例

次の表に演算子の使用例を紹介します。