Zend_Paginatorで、検索条件付きページングをしてみる

開発メモるアル

自分なりの目線で情報を発信します。

[PR]

[PR]上記の広告は3ヶ月以上新規記事投稿のないブログに表示されています。新しい記事を書く事で広告が消えます。

2025/10/31 (Fri)

Zend_Paginatorで、検索条件付きページングをしてみる

Zend_Paginatorのサンプル続編です。

前回は、単純なページングのサンプルのみでしたが、

今回は検索条件（検索文字）付きのページングサンプルを紹介します。

検索機能付きの一覧画面が必要になることは日常茶飯事ですよねｗ

Zend_Paginator（本家マニュアル）

以下のテーブルからデータを取得して一覧を表示します。

■テーブル名

user

■カラム定義

id INT

name VARCHAR(16)

email VARCHAR(320)

※カラムの名前のつけ方が良くないのはサンプルなのでご容赦を。

　id、nameなんて名前は、個人的には実際には使わない方がいいと思います。

(例えば、HTMLのinputタグ等の属性と同じ名前だし・・・orz）

検索に使えるのは、以下４項目です。

ID (user.idに対応)
名前 (user.nameに対応)
メールアドレス (user.emailに対応)
表示件数 (対応カラム無し、１ページあたりの表示件数を指定)

■UserController.php

<?php
class UserController extends Zend_Controller_Action
{
// ユーザー一覧表示
public function userListAction()
{
// ページ番号のリクエストがあれば取得（無ければ1ページ目とする）
$pagenum = $this->getRequest()->getParam('page', 1);
// DBアダプタ生成
$dbAdapter = new Zend_Db_Adapter_Pdo_Mysql(array(
'host' => 'localhost',
'username' => 'xxxx',
'password' => 'xxxx',
'dbname' => 'xxxx'
));
// 検索条件リクエスト値を取得
$searchCond['id'] = $this->getRequest()->getParam('id', null);
$searchCond['name'] = $this->getRequest()->getParam('name', null);
$searchCond['email'] = $this->getRequest()->getParam('email', null);
$searchCond['show_count'] = $this->getRequest()->getParam('show_count', 10);
// SQL作成
$select = $dbAdapter->select()
->from(array('usr' => 'user'),
array('id', 'name', 'email', 'regdate'))
->order(array('id'));
// SQLに検索条件を追加
foreach ($this->searchCond as $colname => $colval) {
if (is_null($val) || $val === '') {
continue;
}
switch ($key) {
case 'id':
$select->where("{$colname} = ?", $colval);
break;
case 'name':
case 'email':
$select->where("{$colname} LIKE ?", "%{$colval}%");
break;
default:
break;
}
}
// ページネーターを取得
$adapter = new Zend_Paginator_Adapter_DbSelect($select);
$paginator = new Zend_Paginator($adapter);
// 現在ページを設定
$paginator->setCurrentPageNumber($pagenum);
// 1ページあたりの表示件数を設定（リクエストされた値を渡す）
$paginator->setItemCountPerPage($searchCond['show_count']);
// ビューにページネーターを渡す
$this->view->assign('userPaginator', $paginator);
// ビューを表示
$this->renderScript('admin/user_list.php');
}
}
// end of file

リクエストを受け付けるアクションです。

テーブルからデータを取得するZend_Paginatorを、ビューに渡しています。

検索条件として入力された検索文字のリクエスト値を取得し、

値が入力された場合のみwhere条件に追加しています。

Zend_Db_Selectオブジェクトを使っているため、

whereメソッドを呼び出すだけで条件に追加できます。

whereメソッドを複数回呼び出すと、それぞれの条件はANDで繋がります。

OR条件で繋げたい場合は、orWhereメソッドを使います。

詳しくはこちらを参照してください。

Zend_Db_Select（本家マニュアル）

■user_list.php

<html>
<head>
<title>ユーザー一覧</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf8">
</head>
<body>
<h1>ユーザー一覧</h1>
<form action="<?php
echo $this->url(
array('controller'=>'user', 'action'=>'user-list'),
'',
TRUE);
?>" method="get">
<table>
<thead></thead><tfoot></tfoot>
<tbody>
<tr>
<th>ID</th>
<td>
<input type="text" name="id" id="id"
value="<?php echo htmlspecialchars($this->searchCond['id'], ENT_QUOTES); ?>">
</td>
</tr>
<tr>
<th>名前</th>
<td>
<input type="text" name="name" id="name"
value="<?php echo htmlspecialchars($this->searchCond['name'], ENT_QUOTES); ?>">
</td>
</tr>
<tr>
<th>メールアドレス</th>
<td>
<input type="text" name="email" id="email"
value="<?php echo htmlspecialchars($this->searchCond['email'], ENT_QUOTES); ?>">
</td>
</tr>
<tr>
<th>表示件数</th>
<td>
<select name="show_count">
<?php $options = array('10', '20', '50', '100'); ?>
<?php foreach ($options as $optkey => $optval): ?>
<?php if ($optval === $this->searchCond['show_count']): ?>
<option value="<?php echo $optval; ?>" selected="selected">
<?php echo $optval; ?>
</option>
<?php else: ?>
<option value="<?php echo $optval; ?>">
<?php echo $optval; ?>
</option>
<?php endif; ?>
<?php endforeach; ?>
</select>
</td>
</tr>
</tbody>
</table>
<input type="button" id="btn_search" value="検索">
</form>
<br>
<table summary="ユーザー一覧">
<thead>
<tr>
<th>ID</th>
<th>名前</th>
<th>メールアドレス</th>
</tr>
</thead>
<tfoot></tfoot>
<tbody>
<?php foreach($this->userPaginator as $key => $user): ?>
<tr>
<td>
<?php echo $user['id']; ?>
</td>
<td>
<?php echo $user['name']; ?>
</td>
<td>
<?php echo $user['email']; ?>
</td>
</tr>
<?php endforeach; ?>
<?php if (count($this->userPaginator) === 0): ?>
<tr>
<td colspan="3">
データがありません
</td>
</tr>
<?php endif; ?>
</tbody>
</table>
<?php echo $this->paginationControl(
$this->inquiryPaginator,
'Sliding',
'pagination/userlist_pagination.phtml',
array(
'controller' => 'user',
'action' => 'user-list',
'id' => $this->searchCond['id'],
'name' => $this->searchCond['name'],
'email' => $this->searchCond['email'],
'show_count' => $this->searchCond['show_count']
)
);
?>
</body>
</html>