PHP中实现JSON数据数组分页的教程-php教程-PHP中文网

PHP中实现JSON数据数组分页的教程

DDD

发布： 2025-11-29 10:50:02

原创

746人浏览过

PHP中实现JSON数据数组分页的教程

本教程详细介绍了如何使用php为从json文件加载的数据实现分页功能。内容涵盖了json数据的正确解析、从url获取分页参数、计算每页显示的数据范围，以及将这些逻辑整合到现有html输出中，最终实现高效且用户友好的数据展示。

在Web开发中，当需要展示大量数据时，分页是必不可少的功能。它能够将庞大的数据集分解成若干个更小的、易于管理的部分，从而提升页面加载速度和用户体验。本教程将以一个从JSON文件读取博客文章并进行分页显示的场景为例，详细讲解如何在PHP中实现这一功能。

1. JSON数据结构与预处理

首先，我们需要一个结构良好且有效的JSON文件作为数据源。原始问题中提供的JSON示例存在语法错误，特别是在email字段中。一个有效的JSON结构示例如下：

{
  "blogs": {
    "1": {
      "slug": "blog/cfsdgfdgfd",
      "cover_image": "cfsdgfdgfd.jpg",
      "author": {
        "name": "dsfdsaf",
        "image": "fdsafas",
        "email": "fdsafsa"
      },
      "heading": "fdgdfg",
      "excerpt": "sdfdsfdsaf",
      "date_added": "2019-04-25T12:21:31+10:00",
      "date_modified": "2021-12-07T14:05:12+10:00",
      "visible": "1",
      "comments": "0",
      "status": "1"
    },
    "2": {
      "slug": "blog/hxgch",
      "cover_image": "fdghhfd.jpg",
      "author": {
        "name": "fdghf",
        "image": "zhd",
        "email": "kjhgk"
      },
      "heading": "kjhkhjg",
        "excerpt": "hgfdhfd",
      "date_added": "2019-05-09T13:31:04+10:00",
      "date_modified": "2021-12-07T11:40:49+10:00",
      "visible": "1",
      "comments": "0",
      "status": "1"
    }
  }
}

登录后复制

在PHP中，我们使用file_get_contents()读取JSON文件内容，然后使用json_decode()将其解析为PHP数据结构。为了方便后续操作，建议将其解析为关联数组，而不是对象，通过传递true作为json_decode()的第二个参数实现：

$jsonFilePath = 'data/blogs.json'; // 替换为你的JSON文件路径
$fileData = file_get_contents($jsonFilePath);
$jsonData = json_decode($fileData, true); // 解析为关联数组

// 检查JSON解析是否成功
if ($jsonData === null && json_last_error() !== JSON_ERROR_NONE) {
    die("Error parsing JSON: " . json_last_error_msg());
}

// 提取实际的博客文章数据
$allBlogs = $jsonData['blogs'] ?? [];

登录后复制

2. 分页核心逻辑实现

分页的核心在于确定当前页需要显示哪些数据项。这涉及到获取当前页码、定义每页显示数量，并据此计算数据的起始和结束索引。

立即学习“PHP免费学习笔记（深入）”；

2.1 获取分页参数

我们通常通过URL查询字符串（例如 ?page=2）来获取当前页码。为了程序的健壮性，需要对获取到的页码进行验证和默认值设置。

$itemsPerPage = 30; // 每页显示的文章数量
$currentPage = isset($_GET['page']) ? (int)$_GET['page'] : 1; // 获取当前页码，默认为第一页

// 确保页码不小于1
if ($currentPage < 1) {
    $currentPage = 1;
}

登录后复制

2.2 计算数据索引范围

有了当前页码和每页显示数量，我们可以计算出当前页数据在完整数据集中对应的起始索引和结束索引。

$startIndex = ($currentPage - 1) * $itemsPerPage;
$endIndex = $startIndex + $itemsPerPage;

登录后复制

2.3 筛选并显示当前页数据

现在，我们可以遍历所有博客文章，并结合之前计算出的索引范围来筛选出当前页需要显示的文章。同时，我们还需要保留原始代码中的过滤条件（status === '1', visible === '1', date_added 在当前日期之前）。

极限网络办公Office Automation

专为中小型企业定制的网络办公软件,富有竞争力的十大特性： 1、独创 web服务器、数据库和应用程序全部自动傻瓜安装，建立企业信息中枢只需3分钟。 2、客户机无需安装专用软件，使用浏览器即可实现全球办公。 3、集成Internet邮件管理组件，提供web方式的远程邮件服务。 4、集成语音会议组件，节省长途话费开支。 5、集成手机短信组件，重要信息可直接发送到员工手机。 6、集成网络硬

查看详情

$filteredBlogs = [];
foreach ($allBlogs as $blogId => $blogData) {
    // 应用原始的过滤条件
    if ($blogData['status'] === '1' && $blogData['visible'] === '1' && strtotime($blogData['date_added']) <= strtotime(date('r'))) {
        $filteredBlogs[] = $blogData;
    }
}

// 获取符合条件的总文章数
$totalItems = count($filteredBlogs);

// 计算总页数
$totalPages = ceil($totalItems / $itemsPerPage);

// 确保当前页码不超过总页数
if ($currentPage > $totalPages && $totalPages > 0) {
    $currentPage = $totalPages;
    $startIndex = ($currentPage - 1) * $itemsPerPage;
    $endIndex = $startIndex + $itemsPerPage;
}

// 提取当前页的文章
$paginatedBlogs = array_slice($filteredBlogs, $startIndex, $itemsPerPage);

登录后复制

3. 整合数据展示与HTML输出

将上述分页逻辑与原始的HTML输出代码结合。注意，由于我们将JSON解析为关联数组，所以访问数据时需要使用方括号[]而不是箭头->。

foreach ($paginatedBlogs as $values){
    // 注意：原始代码中有一个 `foreach ($data as $key => $values)` 的嵌套循环，
    // 但在处理 `json_decode($fileData, true)` 后的 `$allBlogs` 时，
    // `$values` 已经是单个博客对象的数据，不需要额外的嵌套循环。
    // 如果原始JSON的结构要求，可能需要调整。这里假设 `$values` 直接是博客数据。

    echo '
        <article class="col-12 col-md-6 col-xl-4 mb-4" itemscope itemtype="https://schema.org/Article">
            <div class="blog-article" data-href="{{domain}}/' . strip_tags($values['slug']) . '">
                <link itemprop="image" href="{{cdn}}/uploads/' . str_replace('blog/', '', strip_tags($values['cover_image'])) . '" />
                <picture>
                    @@##@@
                </picture>

                <h3 itemprop="headline">' . strip_tags($values['heading']) . '</h3>

                <div class="d-flex align-items-center flex-wrap align-content-start mt-3">
                    <figure>
                        @@##@@
                    </figure>

                    <div class="author" itemprop="author">' . strip_tags($values['author']['name']) . '</div> <time itemprop="datePublished" datetime="' . date('c', strtotime($values['date_added'])) . '" class="date">' . date('d F Y', strtotime($values['date_added'])) . '</time>
                </div>

                <p>' . strip_tags($values['excerpt']) . '</p>

                <a href="{{domain}}/' . strip_tags($values['slug']) . '" title="Read: ' . strip_tags($values['heading']) . '" itemprop="url">Continue Reading <i class="icon-right-1"></i></a>
            </div>
        </article>
    ';
}

登录后复制

4. 完整示例代码

下面是一个将所有部分整合在一起的完整PHP脚本示例。请根据您的实际情况替换$jsonFilePath、{{domain}}和{{cdn}}等占位符，并确保imageLoad函数已定义。

 $blogData) {
    // 应用原始的过滤条件
    if (isset($blogData['status']) && $blogData['status'] === '1' &&
        isset($blogData['visible']) && $blogData['visible'] === '1' &&
        isset($blogData['date_added']) && strtotime($blogData['date_added']) <= strtotime(date('r'))) {
        $filteredBlogs[] = $blogData;
    }
}

$totalItems = count($filteredBlogs); // 符合条件的总文章数
$totalPages = ceil($totalItems / $itemsPerPage); // 计算总页数

// 确保当前页码不超过总页数
if ($totalPages > 0 && $currentPage > $totalPages) {
    $currentPage = $totalPages;
} elseif ($totalPages == 0) { // 如果没有符合条件的文章
    $currentPage = 1;
}

$startIndex = ($currentPage - 1) * $itemsPerPage;
// 从过滤后的文章数组中提取当前页的文章
$paginatedBlogs = array_slice($filteredBlogs, $startIndex, $itemsPerPage);

// 3. 整合数据展示与HTML输出
?>



    
    
    博客文章列表 - 分页
    
    
    


    
        最新博客文章
        
            没有找到符合条件的文章。';
            } else {
                foreach ($paginatedBlogs as $values){
                    // 假设 {{domain}} 和 {{cdn}} 是您前端框架或配置中定义的常量或变量
                    // 这里为了示例，我们直接使用占位符
                    $domain = 'https://yourdomain.com';
                    $cdn = 'https://yourcdn.com';

                    echo '
                        
                            
                                
                                
                                    @@##@@
                                

                                ' . strip_tags($values['heading']) . '

                                
                                    
                                        @@##@@
                                    

                                    ' . strip_tags($values['author']['name']) . '
 ' . date('d F Y', strtotime($values['date_added'])) . '
                                

                                ' . strip_tags($values['excerpt']) . '

                                Continue Reading 
                            
                        
                    ';
                }
            }
            ?>
        

        
        
            
                 1): ?>
                    
                        
                            «
                        
                    
                

                
                    
                        
                    
                

                
                    
                        
                            »