mysqli::prepare

Last updated: Fri, 06 Nov 2009

mysqli::query

mysqli_query

(PHP 5)

mysqli::query -- mysqli_query — データベース上でクエリを実行する

説明

オブジェクト指向型（メソッド）:

mixed mysqli::query ( string $query [, int $resultmode ] )

手続き型:

mixed mysqli_query ( mysqli $link , string $query [, int $resultmode ] )

データベースに対してクエリ query を実行します。

機能的には、この関数は mysqli_real_query() に続けて mysqli_use_result() あるいは mysqli_store_result() をコールすることと同等です。

パラメータ

link

手続き型のみ: mysqli_connect() あるいは mysqli_init() が返すリンク ID。

query

クエリ文字列。

クエリ内のデータは適切にエスケープ. する必要があります。

resultmode

定数 MYSQLI_USE_RESULT あるいは MYSQLI_STORE_RESULT で、望みの挙動を指定します。デフォルトでは MYSQLI_STORE_RESULT を使用します。

MYSQLI_USE_RESULT を使用すると、 mysqli_free_result() をコールするまではそれ以降のコールはすべて Commands out of sync エラーを返します。

MYSQLI_ASYNC (mysqlnd で使用可能) を使用すると、クエリを非同期実行できるようになります。このクエリの結果を取得するには mysqli_poll() を使用します。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。 SELECT, SHOW, DESCRIBE あるいは EXPLAIN の場合は、mysqli_query() は結果オブジェクトを返します。

変更履歴

バージョン	説明
5.3.0	非同期クエリ機能が追加されました。

例

例1 オブジェクト指向型


<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

/* 接続状況をチェックします */
if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

/* テーブルを作成します。これは結果セットを返しません */
if ($mysqli->query("CREATE TEMPORARY TABLE myCity LIKE City") === TRUE) {
    printf("Table myCity successfully created.\n");
}

/* Select クエリを実行します。これは結果セットを返します */
if ($result = $mysqli->query("SELECT Name FROM City LIMIT 10")) {
    printf("Select returned %d rows.\n", $result->num_rows);

    /* 結果セットを開放します */
    $result->close();
}

/* 大量のデータを取得する必要がある場合は MYSQLI_USE_RESULT を使用します */
if ($result = $mysqli->query("SELECT * FROM City", MYSQLI_USE_RESULT)) {

    /* この結果セットが閉じられるまで、サーバとやりとりする関数は
       一切実行できないことに注意しましょう。関数をコールすると、
       'out of sync' エラーが発生します */
    if (!$mysqli->query("SET @a:='this will not work'")) {
        printf("Error: %s\n", $mysqli->error);
    }
    $result->close();
}

$mysqli->close();
?>

例2 手続き型


<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

/* 接続状況をチェックします */
if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

/* テーブルを作成します。これは結果セットを返しません */
if (mysqli_query($link, "CREATE TEMPORARY TABLE myCity LIKE City") === TRUE) {
    printf("Table myCity successfully created.\n");
}

/* Select クエリを実行します。これは結果セットを返します */
if ($result = mysqli_query($link, "SELECT Name FROM City LIMIT 10")) {
    printf("Select returned %d rows.\n", mysqli_num_rows($result));

    /* 結果セットを開放します */
    mysqli_free_result($result);
}

/* 大量のデータを取得する必要がある場合は MYSQLI_USE_RESULT を使用します */
if ($result = mysqli_query($link, "SELECT * FROM City", MYSQLI_USE_RESULT)) {

    /* この結果セットが閉じられるまで、サーバとやりとりする関数は
       一切実行できないことに注意しましょう。関数をコールすると、
       'out of sync' エラーが発生します */
    if (!mysqli_query($link, "SET @a:='this will not work'")) {
        printf("Error: %s\n", mysqli_error($link));
    }
    mysqli_free_result($result);
}

mysqli_close($link);
?>

上の例の出力は以下となります。

Table myCity successfully created.
Select returned 10 rows.
Error: Commands out of sync;  You can't run this command now

参考

mysqli_real_query() - SQL クエリを実行する
mysqli_multi_query() - データベース上でクエリを実行する
mysqli_free_result() - 結果に関連付けられたメモリを開放する

mysqli::real_connect

mysqli::prepare

Last updated: Fri, 06 Nov 2009

add a note User Contributed Notes
mysqli::query

Igor
24-Nov-2008 02:54


mysqli::query() can only execute one SQL statement.



Use mysqli::multi_query() when you want to run multiple SQL statements within one query.

ceo at l-i-e dot com
27-Aug-2008 02:51


Translation:

"Couldn't fetch mysqli"



You closed your connection and are trying to use it again.



It has taken me DAYS to figure out what this obscure error message means...

NUNTIUS
01-Feb-2008 09:33


This may or may not be obvious to people but perhaps it will help someone.





When running joins in SQL you may encounter a problem if you are trying to pull two columns with the same name. mysqli returns the last in the query when called by name. So to get what you need you can use an alias.





Below I am trying to join a user id with a user role. in the first table (tbl_usr), role is a number and in the second is a  text name (tbl_memrole is a lookup table). If I call them both as role I get the text as it is the last "role" in the query. If I use an alias then I get both as desired as shown below.





<?php


$sql = "SELECT a.uid, a.role AS roleid, b.role, 


            FROM tbl_usr a


            INNER JOIN tbl_memrole b


            ON a.role = b.id


            ";





    if ($result = $mysqli->query($sql)) {


        while($obj = $result->fetch_object()){


            $line.=$obj->uid;


            $line.=$obj->role;


            $line.=$obj->roleid;


        }


    }


    $result->close();


    unset($obj);


    unset($sql);


    unset($query);


    


?>


In this situation I guess I could have just renamed the role column in the first table roleid and that would have taken care of it, but it was a learning experience.

jcwebb at dicoe dot com
15-May-2007 08:42


When building apps, i like to see the whole statement when if fails.

<?php

$q="SELECT somecolumn FROM sometable"; //some instruction

$r=mysqli_query($DBlink,$q) or die(mysqli_error($DBlink)." Q=".$q);

?>

If theres an error (like my numerous typing mistakes) this shows the entire instruction.

Good for development (not so good on production servers - simply find and replace when finished: $r=mysqli_query($DBlink,$q); )



Hope it helps. Jon

antiriad at gmail dot com
12-Mar-2007 06:55


this is a variant of mysqli_query that returns output parameters as a rowset.



<?php

  function mysqli_exec($link, $command)

  {

      $select = '';

      $i2 = 0;

      

      while (true)

      {

      $i1 = strpos($command, '@', $i2);

      

      if ($i1 === false)

          break;

          

      $field = '';

      $i2 = $i1 + 1;

      

      while ($i2 < strlen($command) && 

          ($command[$i2] >= '0' && $command[$i2] <= '9') ||

          ($command[$i2] >= 'A' && $command[$i2] <= 'Z') ||

          ($command[$i2] >= 'a' && $command[$i2] <= 'z') ||

          ($command[$i2] == '_'))

          $i2++;

          

      $field = substr($command, $i1 + 1, $i2 - $i1 - 1);

          

      if (strlen($select) == 0)

        $select = "select @{$field} as $field";

      else                    

          $select = $select . ", @{$field} as $field";

      }

      

      if (strlen($select) > 0)

      {      

        mysqli_query($link, $command);

        return mysqli_query($link, $select);

      }

      else

        return mysqli_query($link, $command);

  }

?>



an example:



<?php

  $link = mysqli_connect('localhost', 'myusr', 'mypass') or die ('Error connecting to mysql: ' . mysqli_error($link));

  mysqli_select_db($link, 'clips');

  

  $user_name = 'test';

  $result = mysqli_exec($link, "call do_user_login('$user_name', @session_id, @msg)");

  

  while ($row = mysqli_fetch_assoc($result))

  {

    echo "session_id : {$row['session_id']} <br>";

    echo "msg        : {$row['msg']} <br>";

  }

?>

info at ff dot net
08-May-2006 11:12


Calling Stored Procedures



Beeners' note/example will not work. Use mysqli_multi_query() to call a Stored Procedure. SP's have a second result-set which contains the status: 'OK' or 'ERR'. Using mysqli_query will not work, as there are multiple results.



<?php

$sQuery="CALL SomeSP('params')";

if(!mysqli_multi_query($sqlLink,$sQuery)) {

  // your error handler 

}

$sqlResult=mysqli_store_result($sqlLink);



if(mysqli_more_results($this->sqlLink))//Catch 'OK'/'ERR'

  while(mysqli_next_result($this->sqlLink));

?>



You will have to rewrite/expand this a bit for more usability of course, but it's just an example.

Beeners
08-Jan-2006 08:16


Stored Procedures.



Use mysqli_query to call a stored procedure that returns a result set. 



Here is a short example:



<?php

$mysqli = new mysqli(DBURI,DBUSER,DBPASS,DBNAME);

if (mysqli_connect_errno()) 

{

  printf("Connection failed: %s\n", mysqli_connect_error());

  exit();

}



$SQL = "CALL my_procedure($something)";

if ( ($result = $mysqli->query($SQL))===false )

{

  printf("Invalid query: %s\nWhole query: %s\n", $mysqli->error, $SQL);

  exit();

}



while ($myrow = $result->fetch_array(MYSQLI_ASSOC))

{

  $aValue[]=$myrow["a"];

  $bValue[]=$myrow["b"];

}

$result->close();

$mysqli->close();

?>

I hope this saves someone some time.

andrey at php dot net
07-Aug-2005 07:03


WARNING: This function was buggy on 64bit machines till 5.0.5. Affected versions 5.0.0-5.0.4. The problem appears when a value for the third parameter is passed - this will lead to instant FALSE returned by the function. Therefore if you need to use unbuffered query don't use this function with the aforementioned versions but you mysqli_real_query() and mysqli_use_result().

If you have the rights to patch you PHP installation the fix is easy:

In file ext/mysqli/myslqi_nonapi.c, function PHP_FUNCTION(mysqli_query)

change

unsigned int resultmode=0;

to

unsigned long resultmode=0;



Thanks!

hunreal at gmail dot com
13-Aug-2004 09:24


Use difference collation/character for connect, result.

You can set the collation before your query.



E.g. want to set the collation to utf8_general_ci 

you can send the query "SET NAMES 'utf8'" first



<?php

$mysqli=new mysqli('localhost', 'root', 'password', 'test');

$mysqli->query("SET NAMES 'utf8'");

$q=$mysqli->query("select * from test");

while($r=$q->fetch_assoc()) {

    print_r($r);

}

?>



There are many variables about character settings.

By running sql command, SHOW VARIABLES LIKE 'char%'; 

There are some variables control the character usage.



character_set_client

character_set_connection

character_set_database

character_set_results

character_set_server

character_set_system



Also SET NAMES can repalce with one or some settings like SET character_set_results='utf8';

add a note

mysqli::real_connect

mysqli::prepare

Last updated: Fri, 06 Nov 2009