PHP读取TXT文本并分页显示的实现逻辑与优化方案

结果与目标

目标是实现一个能够读取指定 .txt 文件内容，并根据用户请求的页码（$page）动态截取并展示对应部分内容的脚本。最终效果包括：

• 自动计算文件总页数。
• 支持首页、上一页、下一页、尾页导航链接。
• 正确处理中英文混合内容，避免截断导致乱码。

准备条件

• 环境要求：PHP 5.3 及以上版本（推荐使用 PHP 7+ 或 8+以获得更好性能），Web服务器已启用。
  输入文件：存在一个可访问的 example.txt 文件，路径需正确设置。
  参数说明：通过 URL 参数 ?page=N 传递当前页码，默认为第1页。

真实操作顺序

第1步：初始化会话与页码参数

目的：获取用户指定的页码，若无则默认从第1页开始。

入口：PHP脚本开头。

动作：启动Session以维持状态（可选，若仅依赖URL参数可省略），检查GET参数中的 page。

<?php
// 启动会话（如需存储全局状态）
session_start();

// 获取当前页码，默认值为1
$page = isset($_GET['page']) && is_numeric($_GET['page']) ? intval($_GET['page']) : 1;
if ($page < 1) {
    $page = 1;
}
?>

第2步：读取文件并计算分页总数

目的：确定文本总长度及需要分多少页。

入口：业务逻辑处理部分。

动作：使用 file_get_contents 读取文件内容，使用 mb_strlen 计算多字节字符串长度（针对UTF-8中文友好），设定每页最大字符数（如5000字）。

// 假设文件大小适中（<10MB），可直接读入内存
$content = file_get_contents('example.txt');
if ($content === false) {
    die("无法读取文件");
}

// 使用 mb_strlen 准确计算字符数（而非字节数），适合中英文混排
$length = mb_strlen($content, 'UTF-8');
$pageSize = 5000; // 每页显示的字符数
$pageCount = ceil($length / $pageSize); // 向上取整计算总页数

// 如果页码超出范围，强制修正为最后一页或第一页
if ($page > $pageCount && $pageCount > 0) {
    $page = $pageCount;
} else if ($page > $pageCount && $pageCount == 0) {
    $page = 1;
}

第3步：安全截取当前页内容

目的：提取当前页应展示的子字符串，避免在中文字符中间截断。

入口：HTML输出前的PHP处理区。

动作：使用 mb_substr 函数，根据起始位置和长度截取。注意：mb_substr 的第3个参数是“长度”，第4个参数是“起始位置”（从0开始计数）。需将页码转换为偏移量。

// 计算起始字符索引 (当前页-1) * 每页长度
$startIndex = ($page - 1) * $pageSize;

// 截取当前页内容：起始索引, 长度5000, 编码UTF-8
$currentPageContent = mb_substr($content, $startIndex, $pageSize, 'UTF-8');

// 如果需要保留换行符并在HTML中显示，可将 \n 替换为 <br>
$displayContent = nl2br(htmlspecialchars($currentPageContent));
echo $displayContent;

第4步：生成分页导航

目的：提供页面跳转控制。

入口：页面底部HTML区域。

动作：构建HTML链接，包含首页、上一页、下一页、尾页。判断当前是否为首尾页以禁用相应链接。

<div class="pagination">
    <a href="?page=1">首页
    
        <a href="?page=<?= $page - 1 ?>">上一页
    

    <span><?= $page ?> / <?= $pageCount ?> 页

    
        <a href="?page=<?= $page + 1 ?>">下一页
    
    尾页