萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 文章內容分頁核心技術深度解析

兩大分頁策略對比

策略一:按字數強制分頁

原理:設定每頁字數上限 → 計算總字數 → 推算總頁數 → 使用 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();

文章內容分頁完整流程

  1. 編輯端:整合編輯器分頁按鈕,插入 <hr class="page-break">。
  2. 儲存端:原文入庫,不做任何處理。
  3. 讀取端:
    $segments = explode('<hr class="page-break">', $content);
    $total    = count($segments);
    $page     = max(1, min($total, (int)($_GET['page'] ?? 1)));
    echo $segments[$page - 1];
    // 配合 Pager 類輸出分頁導航

進階優化方向

  • 緩存分頁片段:將分割後的片段序列化存入 Redis,避免每次請求重複 explode()。
  • SEO 優化:為每頁輸出 <link rel="prev/next">、canonical 標籤,防止內容重複收錄。
  • 無限滾動支援:AJAX 載入下一片段,配合 History API 更新 URL。

分頁符策略雖需編輯器配合,但從維護性、呈現品質、擴展性綜合評估,遠優於機械字數截斷,是成熟 CMS 的標準選擇。

copyright © 萬盛學電腦網 all rights reserved