mysql_info

(PHP 4 >= 4.3.0, PHP 5)

mysql_info — 直近のクエリについての情報を得る

説明

string mysql_info ([ resource $link_identifier = NULL ] )

直近のクエリについての詳細な情報を返します。

パラメータ

link_identifier: MySQL 接続。指定されない場合、mysql_connect() により直近にオープンされたリンクが指定されたと仮定されます。そのようなリンクがない場合、引数を指定せずに mysql_connect() がコールした時と同様にリンクを確立します。リンクが見付からない、または、確立できない場合、 E_WARNING レベルのエラーが生成されます。

返り値

成功した場合に文についての情報、失敗した場合に FALSE を返します。どんな文が情報を返し、またそれがどのように見えるのかについては、以下の例を参照ください。ここに挙げられていない文では FALSE が返されます。

例

例1 該当する MySQL 文

情報を返す文の例です。数値はあくまで説明用の例で、実際の値はクエリの内容によって変わります。

INSERT INTO ... SELECT ...
String format: Records: 23 Duplicates: 0 Warnings: 0 
INSERT INTO ... VALUES (...),(...),(...)...
String format: Records: 37 Duplicates: 0 Warnings: 0 
LOAD DATA INFILE ...
String format: Records: 42 Deleted: 0 Skipped: 0 Warnings: 0 
ALTER TABLE
String format: Records: 60 Duplicates: 0 Warnings: 0 
UPDATE
String format: Rows matched: 65 Changed: 65 Warnings: 0

注意

注意:
INSERT ... VALUES 文で mysql_info() が非 FALSE 値を返すのは、文中で複数の値のリストが指定された場合に限ります。

参考

mysql_affected_rows() - 一番最近の操作で変更された行の数を得る
mysql_insert_id() - 直近のクエリで生成された ID を得る
mysql_stat() - 現在のシステムの状態を取得する

mysql_insert_id

mysql_get_server_info

[edit] Last updated: Fri, 25 May 2012

add a note User Contributed Notes mysql_info

tomas at matfyz dot cz 06-Dec-2008 03:57


Please note that the information on warning count cannot be taken from the mysql_info() due to mysql bugs #41283 and #41285:



http://bugs.mysql.com/?id=41283

http://bugs.mysql.com/?id=41285

bdobrica at gmail dot com 24-Apr-2006 12:18


As a solution to the problem pointed in the post reffering to mysql_affected_rows() returning 0 when you are making an update query and the fields are not modified although the query is valid, i'm posting the following function. It is very simple and based on a previous post.



function mysql_modified_rows () {

        $info_str = mysql_info();

        $a_rows = mysql_affected_rows();

        ereg("Rows matched: ([0-9]*)", $info_str, $r_matched);

        return ($a_rows < 1)?($r_matched[1]?$r_matched[1]:0):$a_rows;

        }



Hope you'll find it usefull.

info at granville dot nl 09-Nov-2005 03:25


Imade a quick conversion of eric's function just to count matched or affected rows from a query.



/**GD gdf_db_count_query_v1: returns the amount of rows matched or affected by the last query. Must be used immediately after the concerned query.

*/



function gdf_db_count_query($link = 'dbh') {

       

    $info_str = mysql_info($$link);



       if (ereg("Records: ([0-9]*)", $info_str, $count) == false) {

        ereg("Rows matched: ([0-9]*)", $info_str, $count);

    }

    

    return $count;



}

eric at projectsatellite dot com 22-Sep-2003 02:54


I agree that this is a useful function to use when trying to check on whether an update query matched a particular row. I created a simple function that returns an associative array with the values delineated in the returned string.



function get_mysql_info($linkid = null){

    $linkid? $strInfo = mysql_info($linkid) : $strInfo = mysql_info();

    

    $return = array();

    ereg("Records: ([0-9]*)", $strInfo, $records);

    ereg("Duplicates: ([0-9]*)", $strInfo, $dupes);

    ereg("Warnings: ([0-9]*)", $strInfo, $warnings);

    ereg("Deleted: ([0-9]*)", $strInfo, $deleted);

    ereg("Skipped: ([0-9]*)", $strInfo, $skipped);

    ereg("Rows matched: ([0-9]*)", $strInfo, $rows_matched);

    ereg("Changed: ([0-9]*)", $strInfo, $changed);

    

    $return['records'] = $records[1];

    $return['duplicates'] = $dupes[1];

    $return['warnings'] = $warnings[1];

    $return['deleted'] = $deleted[1];

    $return['skipped'] = $skipped[1];

    $return['rows_matched'] = $rows_matched[1];

    $return['changed'] = $changed[1];

    

    return $return;

}



After trying to update a row that may or may not exist, you can use the above function like so:



$vals = get_mysql_info($linkid);

if($vals['rows_matched'] == 0){

     mysql_query("INSERT INTO table values('val1','val2', 'valetc')", $linkid);

}

carl at NOSPAMthep dot lu dot se 06-Sep-2002 04:44


This function can be used as a workaround for a misfeature of MySQL: on an UPDATE, rows that aren't updated _solely because they looked the same before_ will not be seen in mysql_affected_rows(). This causes problems when you want to use the result of the update to determine if there's need to do an INSERT. With MySQL you can do an INSERT IGNORE if there's no risk of if failing because of a duplicate key other than the one used in the UPDATE. However, if this isn't the case or you want a bit of RDBMS independence, there's no easy/pretty workaround. I think I'll resort to doing a SELECT to determine the primary key before doing the update/insert, as using the CVS version of PHP isn't an option for me.

add a note