PHP mysql_query() -funktio

Määrittely ja käyttö

mysql_query() -funktio suorittaa yhden MySQL-kysynnän.

Syntaksi

mysql_query(query,connection)
Parametrit Kuvaus
query Välttämätön. Määrittää lähetettävän SQL-kysynnän. Huomautus: kyselymerkkijono ei saa päättyä pisteyteen.
connection Valinnainen. Määrittää SQL-yhteyden tunnisteen. Jos sitä ei määritetä, käytetään edellistä avointa yhteyttä.

Selitys

Jos yhteyttä ei ole avoinna, tätä funktiota kutsutaan parametrittomasti mysql_connect() -funktioon yhteyden luomiseksi ja käytettäväksi.

Palautusarvo

mysql_query() palauttaa resurssimerkinnän vain SELECT, SHOW, EXPLAIN tai DESCRIBE lauseille, jos kysely suoritetaan virheellisesti, palauttaa FALSE.

对于其它类型的 SQL 语句,mysql_query() 在执行成功时返回 TRUE,出错时返回 FALSE。

非 FALSE 的返回值意味着查询是合法的并能够被服务器执行。这并不说明任何有关影响到的或返回的行数。很有可能一条查询执行成功了但并未影响到或并未返回任何行。

提示和注释

注释:该函数自动对记录集进行读取和缓存。如需运行非缓存查询,请使用 mysql_unbuffered_query()

实例

例子 1

<?php
$con = mysql_connect("localhost","mysql_user","mysql_pwd");
if (!$con)
  {
  die('Could not connect: ' . mysql_error());
  }
$sql = "SELECT * FROM Person";
mysql_query($sql,$con);
// 一些代码
mysql_close($con);
?>

例子 2

通过 mysql_query() 函数创建一个新数据库:

<?php
$con = mysql_connect("localhost","mysql_user","mysql_pwd");
if (!$con)
  {
  die('Could not connect: ' . mysql_error());
  }
$sql = "CREATE DATABASE my_db";
if (mysql_query($sql,$con))
  {
  echo "Database my_db created";
  }
else
  {
  echo "Error creating database: " . mysql_error();
  }
?>