PHPのお勉強！

PHP TOP
PHP 8.4.2 Released!

    mysql_info

    (PHP 4 >= 4.3.0, PHP 5)

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

    警告

    この拡張モジュールは PHP 5.5.0 で非推奨になり、PHP 7.0.0 で削除されました。 MySQLi あるいは PDO_MySQL を使うべきです。詳細な情報は MySQL: API の選択 を参照ください。 この関数の代替として、これらが使えます。

    説明

    mysql_info(resource $link_identifier = NULL): string

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

    パラメータ

    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 値を 返すのは、文中で複数の値のリストが指定された場合に限ります。

    参考

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 4 notes

    up
    8
    info at granville dot nl
    19 years ago
    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;

    }
    up
    6
    eric at projectsatellite dot com
    21 years ago
    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);
    }
    up
    4
    tomas at matfyz dot cz
    16 years ago
    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
    up
    1
    bdobrica at gmail dot com
    18 years ago
    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.
    ＋add a note
    To Top