# mysql_query

(PHP 4, PHP 5)

mysql_query — 发送一条 MySQL 查询

Warning

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

- mysqli_query()
- PDO::query()

### 说明

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);
    ?>

### 参见

- mysql_connect() - 打开一个到 MySQL 服务器的连接
- mysql_error() - 返回上一个 MySQL 操作产生的文本错误信息
- mysql_real_escape_string() - 转义 SQL 语句中使用的字符串中的特殊字符，并考虑到连接的当前字符集
- mysql_result() - 取得结果数据
- mysql_fetch_assoc() - 从结果集中取得一行作为关联数组
- mysql_unbuffered_query() - 向 MySQL 发送一条 SQL 查询，并不获取和缓存结果的行