编辑“︁PHP结果集处理”︁

= PHP结果集处理 =

== 介绍 ==
'''PHP结果集处理'''是指在PHP中从数据库查询中获取数据后，对返回的结果集（Result Set）进行操作和管理的过程。结果集通常是由MySQLi或PDO等数据库扩展在执行SELECT查询后返回的数据集合。处理结果集包括遍历数据、获取特定行或列、统计行数等操作，是PHP数据库编程的核心部分。

对于初学者来说，理解结果集处理是掌握PHP数据库操作的关键步骤；对于高级用户，优化结果集处理能提升应用性能和代码可维护性。

== 基本操作 ==

=== 获取结果集 ===
使用MySQLi或PDO执行查询后，会返回一个结果集对象。以下是两种扩展的示例：

==== MySQLi 示例 ====
<syntaxhighlight lang="php">
<?php
$conn = new mysqli("localhost", "username", "password", "database");
$result = $conn->query("SELECT id, name FROM users");
// $result 是结果集对象
?>
</syntaxhighlight>

==== PDO 示例 ====
<syntaxhighlight lang="php">
<?php
$conn = new PDO("mysql:host=localhost;dbname=database", "username", "password");
$stmt = $conn->query("SELECT id, name FROM users");
// $stmt 是PDOStatement对象，包含结果集
?>
</syntaxhighlight>

=== 遍历结果集 ===

==== MySQLi 遍历 ====
<syntaxhighlight lang="php">
while ($row = $result->fetch_assoc()) {
    echo "ID: " . $row['id'] . ", Name: " . $row['name'] . "\n";
}
</syntaxhighlight>

==== PDO 遍历 ====
<syntaxhighlight lang="php">
foreach ($stmt->fetchAll(PDO::FETCH_ASSOC) as $row) {
    echo "ID: " . $row['id'] . ", Name: " . $row['name'] . "\n";
}
</syntaxhighlight>

=== 结果集方法对比 ===
{| class="wikitable"
|-
! 操作 !! MySQLi !! PDO
|-
| 获取关联数组 || <code>fetch_assoc()</code> || <code>fetch(PDO::FETCH_ASSOC)</code>
|-
| 获取行数 || <code>num_rows</code> || <code>rowCount()</code>
|-
| 获取所有结果 || <code>fetch_all()</code> || <code>fetchAll()</code>
|}

== 高级处理技术 ==

=== 分页处理 ===
结果集分页是Web应用的常见需求，使用LIMIT子句和结果集计数实现：

<syntaxhighlight lang="php">
$page = isset($_GET['page']) ? (int)$_GET['page'] : 1;
$perPage = 10;
$offset = ($page - 1) * $perPage;

$result = $conn->query("SELECT * FROM products LIMIT $offset, $perPage");
$total = $conn->query("SELECT COUNT(*) FROM products")->fetch_row()[0];
</syntaxhighlight>

=== 大数据集处理 ===
对于大型结果集，使用无缓冲查询防止内存溢出：

<syntaxhighlight lang="php">
$conn->real_query("SELECT * FROM large_table");
$result = $conn->use_result(); // 无缓冲结果集

while ($row = $result->fetch_assoc()) {
    // 逐行处理
}
</syntaxhighlight>

== 实际案例 ==

=== 用户列表展示 ===
一个完整的用户数据获取和展示示例：

<syntaxhighlight lang="php">
<?php
// 连接数据库
$conn = new mysqli("localhost", "user", "password", "app_db");

// 查询用户
$result = $conn->query("SELECT id, username, email FROM users WHERE active=1");

// 处理结果
echo "<ul class='user-list'>";
while ($user = $result->fetch_assoc()) {
    echo "<li>";
    echo "<span class='user-id'>{$user['id']}</span>";
    echo "<span class='username'>{$user['username']}</span>";
    echo "<span class='email'>{$user['email']}</span>";
    echo "</li>";
}
echo "</ul>";

// 释放资源
$result->free();
$conn->close();
?>
</syntaxhighlight>

=== 数据导出CSV ===
将结果集导出为CSV格式：

<syntaxhighlight lang="php">
header('Content-Type: text/csv');
header('Content-Disposition: attachment; filename="export.csv"');

$output = fopen('php://output', 'w');
$result = $conn->query("SELECT * FROM products");

// 写入标题行
fputcsv($output, array_keys($result->fetch_assoc()));
$result->data_seek(0); // 重置指针

// 写入数据行
while ($row = $result->fetch_assoc()) {
    fputcsv($output, $row);
}

fclose($output);
</syntaxhighlight>

== 性能优化 ==

=== 结果集内存管理 ===
处理完结果集后应及时释放内存：

<syntaxhighlight lang="php">
$result->free(); // MySQLi
// 或
$stmt->closeCursor(); // PDO
</syntaxhighlight>

=== 预处理语句 ===
使用预处理语句提高安全性和性能：

<syntaxhighlight lang="php">
$stmt = $conn->prepare("SELECT * FROM users WHERE id = ?");
$stmt->bind_param("i", $userId);
$stmt->execute();
$result = $stmt->get_result();
</syntaxhighlight>

== 常见问题 ==

=== 空结果集检查 ===
正确处理可能为空的结果集：

<syntaxhighlight lang="php">
if ($result->num_rows === 0) {
    echo "没有找到记录";
} else {
    // 处理数据
}
</syntaxhighlight>

=== 数据类型转换 ===
注意数据库类型到PHP类型的自动转换：

{| class="wikitable"
|-
! SQL类型 !! PHP类型
|-
| INT, BIGINT || integer
|-
| FLOAT, DOUBLE || float
|-
| VARCHAR, TEXT || string
|-
| DATETIME || string (可转换为DateTime对象)
|}

== 总结 ==
PHP结果集处理是数据库交互的核心环节。掌握基本遍历方法后，应学习：
* 结果集元数据获取
* 大数据集的内存优化
* 预处理语句的使用
* 不同数据库驱动的特性差异

通过合理的结果集处理，可以构建高效、可靠的数据库应用。

[[Category:编程语言]]
[[Category:PHP]]
[[Category:PHP数据库操作]]