从MySQL多表获取数据并生成结构化JSON的PHP教程

admin 百科 2025-12-14 14

本教程详细介绍了如何使用php和mysqli从多个数据库表中独立查询数据，并将这些数据集合到一个单一的、结构化的json对象中。文章涵盖了数据库连接、执行多条select语句、处理结果集以及最终通过`json_encode`函数生成符合api输出要求的json格式数据，为前端应用或api接口提供统一的数据源。

在现代Web开发中，后端API经常需要从关系型数据库的多个表中获取数据，并将其整合成一个易于前端应用消费的JSON格式。本文将指导您如何使用PHP和MySQLi扩展实现这一目标，以地理位置数据（国家、城市、社区）为例，演示如何从多个独立表中查询数据，并将其组织成一个统一的JSON结构。

数据库结构概述

假设我们有以下三个MySQL表，它们之间存在逻辑上的父子关系：

Countries (国家表)
- countryId (主键)
- countryName
Cities (城市表)
- cityId (主键)
- cityName
- countryId (外键，关联Countries表)
Neighborhoods (社区表)
- neighborhoodId (主键)
- neighborhoodName
- cityId (外键，关联Cities表)

我们的目标是获取这三个表的所有数据，并将其输出为以下JSON格式：

{
  "Countries": [
    { "countryId": "...", "countryName": "..." }
  ],
  "Cities": [
    { "cityId": "...", "cityName": "...", "countryId": "..." }
  ],
  "Neighborhoods": [
    { "neighborhoodId": "...", "neighborhoodName": "...", "cityId": "..." }
  ]
}

登录后复制

实现步骤

要实现上述目标，我们需要执行以下几个核心步骤：

从MySQL多表获取数据并生成结构化JSON的PHP教程-第2张图片-佛山资讯网

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

建立数据库连接：使用PHP的mysqli扩展连接到MySQL数据库。
执行多条查询：针对每个需要获取数据的表，执行独立的SELECT查询。
处理结果集：遍历每个查询的结果集，将行数据逐一存入独立的PHP数组中。
构建最终数据结构：将这些独立的数组组合成一个大的关联数组，其键名对应最终JSON的顶级键。
编码为JSON：使用json_encode()函数将PHP数组转换为JSON字符串并输出。

1. 建立数据库连接

首先，我们需要一个函数或代码块来建立与MySQL数据库的连接。良好的实践包括错误处理，以确保在连接失败时能够提供有用的信息。

<?php
// 数据库连接参数
$dbHost = "your_db_host";      // 例如: localhost
$dbUser = "your_db_username";  // 您的数据库用户名
$dbPass = "your_db_password";  // 您的数据库密码
$dbName = "your_db_name";      // 您的数据库名称

// 建立MySQLi连接
$connection = new mysqli($dbHost, $dbUser, $dbPass, $dbName);

// 检查连接是否成功
if ($connection->connect_errno) {
    // 连接失败，输出错误信息并终止脚本
    http_response_code(500); // 设置HTTP状态码为500 Internal Server Error
    echo json_encode(["error" => "Failed to connect to MySQL: " . $connection->connect_error]);
    exit();
}

// 设置字符集，防止中文乱码
$connection->set_charset("utf8mb4");

// 声明用于存储各个表数据的数组
$countriesData = [];
$citiesData = [];
$neighborhoodsData = [];

// ... 后续代码 ...

?>

登录后复制