
mysql_query
(PHP 4, PHP 5)
mysql_query — 发送一条 MySQL 查询
Warning
本扩展自 PHP 5.5.0
起已废弃,并在将来会被移除。应使用 MySQLi
或 PDO_MySQL 扩展来替换之。参见
MySQL:选择 API 指南以及相关 FAQ 以获取更多信息。用以替代本函数的有:
mysqli_query()
PDO::query()
说明
resource mysql_query
( string $query
[, resource $link_identifier = NULL
] )
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。
$result