mysqli::query

(PHP 5, PHP 7)

mysqli :: query - mysqli_query - 对数据库执行查询

描述

面向对象的风格

程序风格

对数据库执行一次query。

对于非DML查询（不是INSERT，UPDATE或DELETE），该函数类似于调用mysqli_real_query（），后跟mysqli_use_result（）或mysqli_store_result（）。

注意：如果将语句传递给服务器的max_allowed_pa​​cket的语句长度超过mysqli_query（），则返回的错误代码根据您使用的是MySQL本机驱动程序（mysqlnd）还是MySQL客户端库（libmysqlclient）而有所不同。行为如下：

• Linux上的mysqlnd 返回一个1153的错误代码。错误消息表示“得到的数据包大于max_allowed_pa​​cket字节”。

• Windows上的mysqlnd返回错误代码2006.此错误消息意味着“服务器已经消失”。

• 所有平台上的ibmysqlclient都会返回错误代码2006.

参数

link

仅以过程化样式：由mysqli_connect() 或 mysqli_init() 返回的链接标识。

query

查询字符串。

查询中的数据应正确转义。

resultmode

要么是常数，MYSQLI_USE_RESULT要么 MYSQLI_STORE_RESULT取决于期望的行为。默认情况下，MYSQLI_STORE_RESULT使用。

如果你使用MYSQLI_USE_RESULT所有后续的调用，将会返回错误的命令不同步，除非你调用mysqli_free_result()

用MYSQLI_ASYNC（可用于mysqlnd），可以异步执行查询。 然后使用mysqli_poll()从这些查询中获取结果。

返回值

失败时返回 FALSE，通过mysqli_query() 成功执行SELECT, SHOW, DESCRIBE或EXPLAIN查询会返回一个mysqli_result 对象，其他查询则返回TRUE。

更新日志

范例

示例＃1 mysqli :: query()示例

面向对象风格

<?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* check connection */ if ($mysqli->connect_errno) { printf("Connect failed: %s\n", $mysqli->connect_error);     exit(); } /* Create table doesn't return a resultset */ if ($mysqli->query("CREATE TEMPORARY TABLE myCity LIKE City") === TRUE) { printf("Table myCity successfully created.\n"); } /* Select queries return a resultset */ if ($result = $mysqli->query("SELECT Name FROM City LIMIT 10")) { printf("Select returned %d rows.\n", $result->num_rows); /* free result set */ $result->close(); } /* If we have to retrieve large amount of data we use MYSQLI_USE_RESULT */ if ($result = $mysqli->query("SELECT * FROM City", MYSQLI_USE_RESULT)) { /* Note, that we can't execute any functions which interact with the        server until result set was closed. All calls will return an        'out of sync' error */ if (!$mysqli->query("SET @a:='this will not work'")) { printf("Error: %s\n", $mysqli->error);     } $result->close(); } $mysqli->close(); ?>

过程化风格

<?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error());     exit(); } /* Create table doesn't return a resultset */ if (mysqli_query($link, "CREATE TEMPORARY TABLE myCity LIKE City") === TRUE) { printf("Table myCity successfully created.\n"); } /* Select queries return a resultset */ if ($result = mysqli_query($link, "SELECT Name FROM City LIMIT 10")) { printf("Select returned %d rows.\n", mysqli_num_rows($result)); /* free result set */ mysqli_free_result($result); } /* If we have to retrieve large amount of data we use MYSQLI_USE_RESULT */ if ($result = mysqli_query($link, "SELECT * FROM City", MYSQLI_USE_RESULT)) { /* Note, that we can't execute any functions which interact with the        server until result set was closed. All calls will return an        'out of sync' error */ if (!mysqli_query($link, "SET @a:='this will not work'")) { printf("Error: %s\n", mysqli_error($link));     } mysqli_free_result($result); } mysqli_close($link); ?>

以上例程会输出：

表myCity成功创建。
选择返回的10行。
错误：命令不同步; 你现在不能运行这个命令

参见

• mysqli_real_query（） - 执行一个SQL查询

• mysqli_multi_query（） - 对数据库执行查询

• mysqli_free_result（） - 释放与结果关联的内存

← mysqli::prepare

mysqli::real_connect →