PHP

PHP $_GETを使用したページング(ページネーション)の作り方

2016/12/01

以前「フォームやURLのパラメータから値を取得する$_GETの使い方」の記事で簡単なページングの例を作成しましたが、この記事ではもう少し実用的なページング(ページネーション)を紹介したいと思います。良いものができたら随時追加していく予定です。

前回のおさらい

前回は下記のような一番シンプルなページングを作成しました。

<?php
 
$totalPage = 10;
if (
  isset($_GET["page"]) &&
  $_GET["page"] > 0 &&
  $_GET["page"] <= $totalPage
) {
  $page = (int)$_GET["page"];
} else {
  $page = 1;
}
 
?>
<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <title>サンプル</title>
</head>
<body>
  <p>現在 <?php echo $page; ?> ページ目です。</p>
 
  <p>
    <?php if ($page > 1) : ?>
      <a href="?page=<?php echo ($page - 1); ?>">前のページへ</a>
    <?php endif; ?>
    <?php if ($page < $totalPage) : ?>
      <a href="?page=<?php echo ($page + 1); ?>">次のページへ</a>
    <?php endif; ?>
  </p>
 
</body>
</html>

» 実行結果

解説

$totalPage = 10;

3行目でトータルのページ数を指定しています。

if (
  isset($_GET["page"]) &&
  $_GET["page"] > 0 &&
  $_GET["page"] <= $totalPage
) {
  $page = (int)$_GET["page"];
} else {
  $page = 1;
}

4~12行目では、「URLのパラメータにpageが存在しない場合」「pageが0以下」「pageがトータルページを超えている場合」に1ページ目を表示するように処理しています。9行目では悪意のある値を受け付けないように数値にキャスト(変換)しています。

  <p>現在 <?php echo $page; ?> ページ目です。</p>

22行目では現在のページを表示しています。

    <?php if ($page > 1) : ?>
      <a href="?page=<?php echo ($page - 1); ?>">前のページへ</a>
    <?php endif; ?>

25〜27行目では、現在のページが2ページ目以降であれば1ページ戻るリンクを表示するようにしています。

    <?php if ($page < $totalPage) : ?>
      <a href="?page=<?php echo ($page + 1); ?>">次のページへ</a>
    <?php endif; ?>

28〜30行目では、現在のページがトータルページより小さければ1ページ進むリンクを表示するようにしています。

前後に指定したページ数を表示する

前後に指定したページ数を表示する方法です。

<?php
 
$totalPage = 20;
$range = 3;
if (
  isset($_GET["page"]) &&
  $_GET["page"] > 0 &&
  $_GET["page"] <= $totalPage
) {
  $page = (int)$_GET["page"];
} else {
  $page = 1;
}
 
?>
<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <title>サンプル</title>
</head>
<body>
  <p>現在 <?php echo $page; ?> ページ目です。</p>

  <p>
    <?php if ($page > 1) : ?>
      <a href="?page=<?php echo ($page - 1); ?>">前のページへ</a>
    <?php endif; ?>

    <?php for ($i = $range; $i > 0; $i--) : ?>
      <?php if ($page - $i < 1) continue; ?>
      <a href="?page=<?php echo ($page - $i); ?>"><?php echo ($page - $i); ?></a>
    <?php endfor; ?>

    <span><?php echo $page; ?></span>

    <?php for ($i = 1; $i <= $range; $i++) : ?>
      <?php if ($page + $i > $totalPage) break; ?>
      <a href="?page=<?php echo ($page + $i); ?>"><?php echo ($page + $i); ?></a>
    <?php endfor; ?>

    <?php if ($page < $totalPage) : ?>
      <a href="?page=<?php echo ($page + 1); ?>">次のページへ</a>
    <?php endif; ?>
  </p>

</body>
</html>

» 実行結果

解説

$totalPage = 10;
$range = 3;

3行目でトータルのページ数を指定、4行目で前後に表示するページ数を指定しています。

if (
  isset($_GET["page"]) &&
  $_GET["page"] > 0 &&
  $_GET["page"] <= $totalPage
) {
  $page = (int)$_GET["page"];
} else {
  $page = 1;
}

5~13行目では、「URLのパラメータにpageが存在しない場合」「pageが0以下」「pageがトータルページを超えている場合」に1ページ目を表示するように処理しています。10行目では悪意のある値を受け付けないように数値にキャスト(変換)しています。

  <p>現在 <?php echo $page; ?> ページ目です。</p>

23行目では現在のページを表示しています。

    <?php if ($page > 1) : ?>
      <a href="?page=<?php echo ($page - 1); ?>">前のページへ</a>
    <?php endif; ?>

26〜28行目では、現在のページが2ページ目以降であれば1ページ戻るリンクを表示するようにしています。

    <?php for ($i = $range; $i > 0; $i--) : ?>
      <?php if ($page - $i < 1) continue; ?>
      <a href="?page=<?php echo ($page - $i); ?>"><?php echo ($page - $i); ?></a>
    <?php endfor; ?>

30〜33行目では、$iに$rangeを代入し、$iを1ずつマイナスしながら0になるまでforで繰り返しを行います。
現在のページから$iを引いた数値が0以下になる場合、そのページは存在しないためcontinueでスキップします。1以上の場合はそのページへのリンクを表示します。

    <span><?php echo $page; ?></span>

35行目では、現在のページを表示しています。

    <?php for ($i = 1; $i <= $range; $i++) : ?>
      <?php if ($page + $i > $totalPage) break; ?>
      <a href="?page=<?php echo ($page + $i); ?>"><?php echo ($page + $i); ?></a>
    <?php endfor; ?>

37〜40行目では、$iに1を代入し、$iを1ずつプラスしながら$rangeになるまでforで繰り返しを行います。
現在のページに$iを足した数値がトータルページを超える場合、そのページは存在しないためbreakでループを終了します。超えない場合はそのページへのリンクを表示します。

    <?php if ($page < $totalPage) : ?>
      <a href="?page=<?php echo ($page + 1); ?>">次のページへ</a>
    <?php endif; ?>

42〜44行目では、現在のページがトータルページより小さければ1ページ進むリンクを表示するようにしています。

-PHP
-