上一篇
php mysql函数返回值有哪些？不同函数返回值类型是什么？
在PHP与MySQL交互的过程中，函数的返回值是开发者判断操作结果、获取数据以及进行错误处理的核心依据，无论是连接数据库、执行查询还是处理结果集，每个函数都有其特定的返回值规则,理解这些规则对于编写稳定可靠的数据库操作代码至关重要。
从数据库连接开始，mysqli_connect()函数用于建立与MySQL服务器的连接，如果连接成功，它会返回一个mysqli对象，该对象后续用于所有数据库操作；如果连接失败，则返回false。$conn = mysqli_connect("localhost", "username", "password", "database")，成功时$conn是一个可用的连接对象，失败时可通过mysqli_connect_error()获取错误信息，而面向对象的mysqli构造函数（如new mysqli(...)）在连接失败时会抛出一个mysqli_sql_exception异常，此时需要通过trycatch块捕获异常,这与面向过程的错误处理方式有所不同。
对于查询执行函数，mysqli_query()和面向对象的mysqli::query()是常用方法，当执行SELECT、SHOW、DESCRIBE或EXPLAIN等返回结果集的查询时，如果成功，函数返回一个mysqli_result对象，通过该对象可以遍历查询结果；如果查询失败（如语法错误），则返回false，对于非SELECT语句（如INSERT、UPDATE、DELETE），执行成功时返回true，失败时返回false。$result = mysqli_query($conn, "SELECT * FROM users")，若成功，$result是一个结果集对象，可通过mysqli_fetch_assoc($result)逐行获取数据；若执行INSERT语句成功，mysqli_query()返回true，此时可通过mysqli_affected_rows($conn)获取受影响的行数。
获取结果集数据的函数中，mysqli_fetch_assoc()返回一个关联数组，键名为结果集中的列名，若没有更多行则返回false；mysqli_fetch_row()返回一个索引数组，键名为数字索引，同样无数据时返回false；mysqli_fetch_array()可同时获取关联和索引数组，通过第二个参数（如MYSQLI_ASSOC、MYSQLI_NUM、MYSQLI_BOTH）指定类型，默认为MYSQLI_BOTH，无数据时返回false，而mysqli_fetch_object()则将结果行转换为对象，属性名为列名，无数据时返回false，需要注意的是，这些函数会移动结果集的内部指针，每次调用返回下一行数据，当所有数据遍历完毕后，再次调用将返回false。
关于数据操作的影响，mysqli_affected_rows($conn)返回前一次INSERT、UPDATE或DELETE操作受影响的行数，对于SELECT操作无意义；若发生错误，则返回1。mysqli_insert_id($conn)返回最后一条INSERT查询生成的自增ID，适用于需要获取新记录ID的场景,如用户注册后获取用户ID。
错误处理方面，mysqli_error($conn)返回上一个MySQL操作的错误描述字符串，无错误时返回空字符串；mysqli_errno($conn)返回错误代码，数值类型，面向对象中，mysqli::error和mysqli::errno属性可直接获取错误信息。
以下表格归纳了常用PHP MySQL函数的返回值：
| 函数名 | 返回值（成功） | 返回值（失败） | 说明 |
|---|---|---|---|
| mysqli_connect() | mysqli对象 | false | 建立数据库连接 |
| mysqli_query() | SELECT返回mysqli_result对象，其他返回true | false | 执行SQL查询语句 |
| mysqli_fetch_assoc() | 关联数组（列名作为键） | false（无更多数据） | 从结果集获取一行作为关联数组 |
| mysqli_fetch_row() | 索引数组（数字作为键） | false（无更多数据） | 从结果集获取一行作为索引数组 |
| mysqli_affected_rows() | 受影响的行数（整数） | 1（错误或无影响） | 获取INSERT/UPDATE/DELETE影响的行数 |
| mysqli_insert_id() | 最后插入行的自增ID | 0（无自增ID或未执行插入） | 获取最后一条插入记录的ID |
| mysqli_error() | 错误信息字符串 | 空字符串（无错误） | 获取上一个操作的错误描述 |
在实际开发中，务必根据函数返回值进行逻辑判断，例如执行查询后先检查$result是否为false，再遍历结果集；插入数据后通过mysqli_insert_id()获取新ID，结合面向过程的错误处理函数（如mysqli_error()）或面向对象的异常处理，可以及时发现并解决数据库操作中的问题,确保应用的健壮性。
相关问答FAQs
Q1：为什么mysqli_query()执行SELECT语句后返回的是mysqli_result对象，而其他语句返回true或false？
A1：这是因为SELECT语句会返回一个结果集（包含查询到的数据），需要通过mysqli_result对象来遍历和处理数据；而非SELECT语句（如INSERT、UPDATE、DELETE）主要用于执行数据修改操作，不返回结果集，因此执行成功时只需返回true表示操作完成，失败时返回false表示操作出错,这种设计让开发者能明确区分是否需要处理结果数据。
Q2：使用mysqli_fetch_assoc()遍历结果集时，为什么循环结束后变量会保留最后一行的数据？
A2：mysqli_fetch_assoc()在遍历完所有数据后返回false，但此时变量（如$row）仍保留最后一次成功获取的数据行（即结果集的最后一行），如果需要在循环结束后清空变量，可以手动将其赋值为null，例如在循环外设置$row = null，或者在循环结束后通过unset($row)释放变量,避免后续逻辑误用残留数据。
