PHP mysql_query() 関数

定義と使用方法

mysql_query() 関数は MySQL クエリを実行します。

文法

mysql_query(query,connection)
パラメータ 説明
query 必須です。送信する SQL クエリを指定します。注:クエリ文字列はセミコロンで終了しないべきです。
connection オプションです。SQL 接続識別子を指定します。指定しない場合、最後にオープンされた接続が使用されます。

説明

オープンされた接続がない場合、この関数はパラメータなしで mysql_connect() 関数を呼び出し、接続を確立してその接続を使用しようとします。

返り値

mysql_query() は SELECT、SHOW、EXPLAIN または DESCRIBE ステートメントに対してリソース識別子を返します。クエリの実行に問題が発生した場合、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();
  }
?>