用 mysqli_result::data_seek 反向读取结果集，实现 MySQL 查询倒序遍历的方法

gitbox 2025-09-17

在日常开发中，我们经常需要从 MySQL 数据库中获取结果集，并对结果集进行遍历。默认情况下，mysqli_query 返回的结果集是按查询顺序存储的。如果我们想要结果集，有几种方式可以实现，其中一个简单高效的方法是利用 PHP 的 mysqli_result::data_seek 函数。

什么是 mysqli_result::data_seek

mysqli_result::data_seek 是 PHP 提供的一个方法，它允许开发者将结果集的内部指针移动到指定的行上。其基本用法如下：

<span><span>mysqli_result::</span><span><span class="hljs-title function_ invoke__">data_seek</span></span><span>(</span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$offset</span></span><span>): </span><span><span class="hljs-keyword">bool</span></span><span>
</span></span>

$offset 表示目标行的索引，从 0 开始。
返回值为布尔类型，如果成功返回 true，失败返回 false。

使用场景

当我们希望倒序遍历结果集时，最直接的办法是从结果集的最后一行开始向前读取，而不必在 SQL 查询中使用 ORDER BY ... DESC。这样在某些情况下可以减少对数据库的压力，尤其是数据量非常大的时候。

示例代码

假设我们有一个 MySQL 表 users，包含字段 id 和 name，我们想倒序输出用户列表：

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$mysqli</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title function_ invoke__">mysqli</span></span><span>(</span><span><span class="hljs-string">"localhost"</span></span><span>, </span><span><span class="hljs-string">"username"</span></span><span>, </span><span><span class="hljs-string">"password"</span></span><span>, </span><span><span class="hljs-string">"database"</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;connect_error) {
    </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"连接失败: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;connect_error);
}

</span><span><span class="hljs-variable">$sql</span></span><span> = </span><span><span class="hljs-string">"SELECT id, name FROM users"</span></span><span>;
</span><span><span class="hljs-variable">$result</span></span><span> = </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">query</span></span><span>(</span><span><span class="hljs-variable">$sql</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$result</span></span><span>) {
    </span><span><span class="hljs-variable">$num_rows</span></span><span> = </span><span><span class="hljs-variable">$result</span></span><span>-&gt;num_rows;

    </span><span><span class="hljs-comment">// 倒序遍历结果集</span></span><span>
    </span><span><span class="hljs-keyword">for</span></span><span> (</span><span><span class="hljs-variable">$i</span></span><span> = </span><span><span class="hljs-variable">$num_rows</span></span><span> - </span><span><span class="hljs-number">1</span></span><span>; </span><span><span class="hljs-variable">$i</span></span><span> &gt;= </span><span><span class="hljs-number">0</span></span><span>; </span><span><span class="hljs-variable">$i</span></span><span>--) {
        </span><span><span class="hljs-variable">$result</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">data_seek</span></span><span>(</span><span><span class="hljs-variable">$i</span></span><span>); </span><span><span class="hljs-comment">// 将内部指针移动到第 $i 行</span></span><span>
        </span><span><span class="hljs-variable">$row</span></span><span> = </span><span><span class="hljs-variable">$result</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">fetch_assoc</span></span><span>();
        </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"ID: "</span></span><span> . </span><span><span class="hljs-variable">$row</span></span><span>[</span><span><span class="hljs-string">'id'</span></span><span>] . </span><span><span class="hljs-string">", Name: "</span></span><span> . </span><span><span class="hljs-variable">$row</span></span><span>[</span><span><span class="hljs-string">'name'</span></span><span>] . </span><span><span class="hljs-string">"\n"</span></span><span>;
    }

    </span><span><span class="hljs-variable">$result</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">free</span></span><span>();
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"查询失败: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;error;
}

</span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">close</span></span><span>();
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

运行原理

$result->num_rows 获取结果集总行数。
for 循环从最后一行 $num_rows - 1 开始，逐步向前移动。
使用 $result->data_seek($i) 定位到指定行。
调用 $result->fetch_assoc() 获取当前行数据。

这种方法不需要修改 SQL 查询顺序，而且在某些需要动态控制遍历顺序的场景非常有用。

优点与注意事项

优点：

简单易用，直接在 PHP 层面控制遍历顺序。
对小型结果集非常高效。

注意事项：

对大型结果集，如果内存消耗过大，仍建议在 SQL 层使用 ORDER BY 进行排序。
data_seek 仅适用于 mysqli_query 返回的 mysqli_result 对象，不适用于非缓冲查询。

总结

通过 mysqli_result::data_seek，我们可以轻松实现结果集的倒序遍历，无需依赖 SQL 的排序功能。它为 PHP 开发者提供了更灵活的控制方式，特别适合对查询结果进行动态处理的场景。

相关标签:
mysqli_result