原理:設定每頁字數上限 → 計算總字數 → 推算總頁數 → 使用 mb_substr() 截取對應區間內容。
痛點:HTML 標籤截斷導致結構破壞(如未閉合的 <div>、<table>),需引入 HTMLPurifier 或自寫標籤閉合邏輯,複雜度高且效能損耗大。
原理:編輯器插入特定分頁符(如 <hr class="page"> 或 <!--nextpage-->)→ 前端儲存時不處理 → 顯示時 explode() 分割 → 根據頁碼輸出對應片段。
優勢:語義切分符合閱讀習慣、天然避免標籤破壞、編輯器易整合(TinyMCE、CKEditor 均支援分頁按鈕)。
<?php
/**
* 通用分頁顯示類
* 支援兩種模式:簡易模式(首頁/上頁/下頁/尾頁)與經典數字模式
*/
class Pager
{
private $totalPages;
private $currentPage;
private $subPages = 10; // 數字模式顯示頁碼數
private $linkTemplate = ''; // 連結模板,含 {page} 佔位符
private $mode = 2; // 1=簡易 2=經典
private $lang = [
'first' => '首頁', 'prev' => '上一頁',
'next' => '下一頁', 'last' => '尾頁',
];
public function __construct($totalPages, $currentPage = 1, $subPages = 10, $linkTemplate = '', $mode = 2)
{
$this->totalPages = max(1, (int)$totalPages);
$this->currentPage = max(1, min($this->totalPages, (int)$currentPage));
$this->subPages = max(3, (int)$subPages);
$this->mode = $mode;
if ($linkTemplate) {
$this->linkTemplate = strpos($linkTemplate, '{page}') !== false
? $linkTemplate
: rtrim($linkTemplate, '?&') . (strpos($linkTemplate, '?') ? '&' : '?') . 'page={page}';
} else {
$this->linkTemplate = $_SERVER['PHP_SELF'] . '?page={page}';
}
}
public function render()
{
return $this->mode === 1 ? $this->simpleMode() : $this->classicMode();
}
private function simpleMode()
{
$html = "共 {$this->totalPages} 頁 ";
$html .= $this->link(1, $this->lang['first']);
$html .= $this->link(max(1, $this->currentPage - 1), $this->lang['prev']);
$html .= $this->link(min($this->totalPages, $this->currentPage + 1), $this->lang['next']);
$html .= $this->link($this->totalPages, $this->lang['last']);
return $html;
}
private function classicMode()
{
$half = (int)($this->subPages / 2);
$start = max(1, $this->currentPage - $half);
$end = min($this->totalPages, $start + $this->subPages - 1);
if ($end - $start + 1 < $this->subPages) {
$start = max(1, $end - $this->subPages + 1);
}
$html = "第 {$this->currentPage}/{$this->totalPages} 頁 ";
$html .= $this->link(1, $this->lang['first']);
$html .= $this->link(max(1, $this->currentPage - 1), $this->lang['prev']);
for ($i = $start; $i <= $end; $i++) {
if ($i === $this->currentPage) {
$html .= "[$i] ";
} else {
$html .= $this->link($i, $i);
}
}
$html .= $this->link(min($this->totalPages, $this->currentPage + 1), $this->lang['next']);
$html .= $this->link($this->totalPages, $this->lang['last']);
return $html;
}
private function link($page, $text)
{
$url = str_replace('{page}', $page, $this->linkTemplate);
return "$text ";
}
}
// 使用範例
require_once 'Pager.php';
$pager = new Pager($totalPages, $currentPage);
echo $pager->render();
<hr class="page-break">。$segments = explode('<hr class="page-break">', $content);
$total = count($segments);
$page = max(1, min($total, (int)($_GET['page'] ?? 1)));
echo $segments[$page - 1];
// 配合 Pager 類輸出分頁導航explode()。<link rel="prev/next">、canonical 標籤,防止內容重複收錄。分頁符策略雖需編輯器配合,但從維護性、呈現品質、擴展性綜合評估,遠優於機械字數截斷,是成熟 CMS 的標準選擇。