PEAR::Pagerをインストールして使ってみる

自宅iMacのVMware FusionにインストールしているUbuntu Server 9.0.4に、PHPのPEARライブラリ「PEAR::Pager」をインストール。

PEAR::Pagerはページネーション（ページ送りとか、ページングとも言う）機能を簡単に実装できるパッケージ。

PEARの各パッケージをインストールするには（この場合はPEAR::Pager）PEARパッケージマネージャの「php-pear」が必要。これがPEARの各パッケージをインストールするための窓口となってくれる。

ちなみに、Ubuntuではこのパッケージマネージャが未インストール状態で、PEARのパッケージをインストールしようとすると

$ pear install Pager
The program 'pear' is currently not installed.  You can install it by typing:
sudo apt-get install php-pear

と表示される。「pear」がインストールされてませんよと。そして、それをインストールするには「sudo apt-get install php-pear」とタイピングして実行するといいですよと。親切だ。

なので、このメッセージに従ってphp-pearをまずはインストールする。（sudoというのはroot権限でこのコマンドを実行するということ）

php-pearのインストール

$ sudo apt-get install php-pear

これでPEARのパッケージマネージャがインストールされた。つづいて本題のPEAR::Pagerパッケージのインストール。これも同様にsudoをコマンドの先頭につけて、管理者権限でインストールする。

PEAR::Pagerのインストール

$ sudo pear install Pager

Pagerパッケージをインストールして、何がどこに入ったのかを一応確認してみる。
（pearのlistというコマンドを使って）

$ pear list Pager
Installed Files For Pager
=========================
Type Install Path
doc  /usr/share/php/docs/Pager/examples/example.php
doc  /usr/share/php/docs/Pager/examples/Pager_Wrapper.php
test /usr/share/php/tests/Pager/tests/all_tests.php
test /usr/share/php/tests/Pager/tests/multibyte_post.php
test /usr/share/php/tests/Pager/tests/pager_include.php
test /usr/share/php/tests/Pager/tests/pager_jumping_noData_test.php
test /usr/share/php/tests/Pager/tests/pager_jumping_test.php
test /usr/share/php/tests/Pager/tests/pager_jumping_tests.php
test /usr/share/php/tests/Pager/tests/pager_noData_test.php
test /usr/share/php/tests/Pager/tests/pager_post_test.php
test /usr/share/php/tests/Pager/tests/pager_post_tests.php
test /usr/share/php/tests/Pager/tests/pager_post_test_simple.php
test /usr/share/php/tests/Pager/tests/pager_sliding_noData_test.php
test /usr/share/php/tests/Pager/tests/pager_sliding_notExpanded_test.php
test /usr/share/php/tests/Pager/tests/pager_sliding_test.php
test /usr/share/php/tests/Pager/tests/pager_sliding_tests.php
test /usr/share/php/tests/Pager/tests/pager_test.php
test /usr/share/php/tests/Pager/tests/pager_tests.php
test /usr/share/php/tests/Pager/tests/pager_test_xss.php
test /usr/share/php/tests/Pager/tests/pager_wrapper_include.php
test /usr/share/php/tests/Pager/tests/pager_wrapper_test.php
test /usr/share/php/tests/Pager/tests/README
test /usr/share/php/tests/Pager/tests/simple_include.php
php  /usr/share/php/Pager.php
php  /usr/share/php/Pager/Common.php
php  /usr/share/php/Pager/HtmlWidgets.php
php  /usr/share/php/Pager/Jumping.php
php  /usr/share/php/Pager/Pager.php
php  /usr/share/php/Pager/Sliding.php

簡単なコードを実際に記述して、このパッケージ（Pager）が利用出来る状態になっているのかを確認する。（パッケージをincludeで読み込んで機能を利用可能にし、ページネーションのナビゲーションリンクと現在のページ番号を表示してみる）

paging_sample.php

 200,
    "delta" => 10,
    "perPage" => 8
);

$pager =& Pager::factory($options);
$navi = $pager -> getLinks();
print($navi["all"]);

$currentPageID = $pager -> getCurrentPageID();

echo "現在のページ番号は" . $currentPageID . "です。";

このファイルにブラウザでアクセスして表示してみると、こんな感じ。

とりあえずPagerパッケージは無事インストールできて、機能も利用できている模様。

あとは、実際にページネーションが必要なコンテンツを作成して実践＆確認していくという感じ。