Php/docs/function.mysql-query

来自菜鸟教程
跳转至:导航、​搜索

mysql_query

(PHP 4, PHP 5)

mysql_query发送一条 MySQL 查询


Warning 本扩展自 PHP 5.5.0 起已废弃,并在自 PHP 7.0.0 开始被移除。应使用 MySQLiPDO_MySQL 扩展来替换之。参见 MySQL:选择 API 指南以及相关 FAQ 来获取更多信息。用以替代本函数的有:


说明

mysql_query ( string $query [, resource $link_identifier = NULL ] ) : resource

mysql_query() 向与指定的 link_identifier 关联的服务器中的当前活动数据库发送一条查询(不支持多条查询)。


参数

query

SQL 查询语句

查询字符串不应以分号结束。 查询中被嵌入的数据应该正确地转义

link_identifier

MySQL 连接。如不指定连接标识,则使用由 mysql_connect() 最近打开的连接。如果没有找到该连接,会尝试不带参数调用 mysql_connect() 来创建。如没有找到连接或无法建立连接,则会生成 E_WARNING 级别的错误。


返回值

mysql_query() 仅对 SELECT,SHOW,DESCRIBE, EXPLAIN 和其他语句 语句返回一个 resource,如果查询出现错误则返回 false

对于其它类型的 SQL 语句,比如INSERT, UPDATE, DELETE, DROP 之类, mysql_query() 在执行成功时返回 true,出错时返回 false

返回的结果资源应该传递给 mysql_fetch_array() 和其他函数来处理结果表,取出返回的数据。

假定查询成功,可以调用 mysql_num_rows() 来查看对应于 SELECT 语句返回了多少行,或者调用 mysql_affected_rows() 来查看对应于 DELETE,INSERT,REPLACE 或 UPDATE 语句影响到了多少行。

如果没有权限访问查询语句中引用的表时,mysql_query() 也会返回 false


范例

Example #1 无效的查询

以下查询语法上有错,因此 mysql_query() 失败并返回 false


<?php$result = mysql_query('SELECT * WHERE 1=1');if (!$result) {    die('Invalid query: ' . mysql_error());}?>

Example #2 有效的查询

以下查询语法正确,所以 mysql_query() 返回了一个 resource


<?php// 这应该由用户提供,下面是一个示例$firstname = 'fred';$lastname  = 'fox';// 构造查询// 这是执行 SQL 最好的方式// 更多例子参见 mysql_real_escape_string()$query = sprintf("SELECT firstname, lastname, address, age FROM friends     WHERE firstname='%s' AND lastname='%s'",    mysql_real_escape_string($firstname),    mysql_real_escape_string($lastname));// 执行查询$result = mysql_query($query);// 检查结果// 下面显示了实际发送给 MySQL 的查询,以及出现的错误。这对调试很有帮助。if (!$result) {    $message  = 'Invalid query: ' . mysql_error() . "\n";    $message .= 'Whole query: ' . $query;    die($message);}// 结果的使用// 尝试 print $result 并不会取出结果资源中的信息// 所以必须至少使用其中一个 mysql 结果函数// 参见 mysql_result(), mysql_fetch_array(), mysql_fetch_row() 等。while ($row = mysql_fetch_assoc($result)) {    echo $row['firstname'];    echo $row['lastname'];    echo $row['address'];    echo $row['age'];}// 释放关联结果集的资源// 在脚本结束的时候会自动进行mysql_free_result($result);?>

参见