mysql_info

(PHP 4 >= 4.3.0, PHP 5, PECL mysql:1.0)

mysql_info — Lit des informations à propos de la dernière requête MySQL

Description

string mysql_info ([ resource $link_identifier ] )

Lit des informations à propos de la dernière requête MySQL.

Liste de paramètres

link_identifier: La connexion MySQL. S'il n'est pas spécifié, la dernière connexion ouverte avec la fonction mysql_connect() sera utilisée. Si une telle connexion n'est pas trouvée, la fonction tentera d'ouvrir une connexion, comme si la fonction mysql_connect() avait été appelée sans argument. Si aucune connexion n'est trouvée ou établie, une alerte E_WARNING est générée.

Valeurs de retour

Retourne des informations sur une requête en cas de succès, ou FALSE si une erreur survient. Regardez l'exemple ci-dessous pour savoir quelles sortes de requêtes fournissent des informations et avoir un aperçu des informations retournées. Les sortes de requêtes qui ne sont pas listées retournent FALSE.

Exemples

Exemple #1 Requêtes MySQL

Requêtes qui retournent des valeurs. Les nombres ne sont là que pour illustrer l'exemple ; ces valeurs correspondent à la requête.

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

Notes

Note: mysql_info() retourne une valeur différente de FALSE pour les commandes INSERT ... VALUES uniquement si plusieurs jeux de valeurs à insérer ont été spécifiés dans la commande.

Voir aussi

mysql_insert_id

mysql_get_server_info

Last updated: Fri, 22 Aug 2008

add a note User Contributed Notes
mysql_info

bdobrica at gmail dot com
24-Apr-2006 09: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 12: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 11: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
07-Sep-2002 01: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

mysql_insert_id

mysql_get_server_info

Last updated: Fri, 22 Aug 2008