PHP-MySQLi-Debug-Queries.php

Quell Code

<h1>[PHP][MySQLi] Debug Queries</h1>
<p>Ein kleines Tutorial wie man einfach SQL-Scripte in PHP mit MySQLi debuggen kann.</p>

<p>
<span>Dieses Tutorial funktioniert NICHT mit prepared Statements</span>
</p>
<h2>Ausgangslage</h2>

<p>
Immer und immer wieder kommt man an den Punkt, dass ein in PHP zusammengesetztes Query nicht das macht was man will. Darum hier mal eine Anleitung, damit ich sie nicht immer wieder schreiben muss.
</p>

<p>
Wir haben einen einfachen Code, der ein Update auf die Datenbank macht. Nun updated dieser Code aber nichts in der Datenbank und wir finden noch nicht heraus warum. In der folgenden Anleitung werden wir anhand dieses Beispiels sehen wie man eine einfache Fehleranalyse durchführen kann um solche Probleme zu lösen.
</p>

<h5>Object oriented style</h5>
<pre>
&lt;?php
    $db = new mysqli('localhost', 'root', '', 'test');
 
    $value = 'test';
	$where = 6;
	$sql  = "UPDATE myTable SET feld_1 = {$value}  WHERE id = {$where};";
	$db->query($sql);
	echo $db->affected_rows;
?></pre>

<h5>Procedural style</h5>

<pre>

&lt;php
    $db = mysqli_connect('localhost', 'root', '', 'test');
 
	$value = 'test';
	$where = 6;
	$sql  = "UPDATE myTable SET feld_1 = {$value}  WHERE id = {$where};";
	mysqli_query($db, $sql);
	echo mysqli_affected_rows($db);
?>
</pre>
<h2>Lösung</h2>
<h3> Report Error All</h3>

<p>
Als erstes ergänzen wir unseren Code mal um die folgende Zeile um uns alle Fehlermeldungen auszugeben.
</p>
<pre>
  error_reporting(E_ALL);
ini_set('display_errors', 1);ß  
</pre>
<blockquote><div class="no">
Danke an saftmeister vom Tutorial.de-Forum für den Hiwenis auf ini_set('display_errors', 1):<br>
Seit PHP 5.sonstwas sind die empfohlenen Einstellungen, das display_errors auf 0 steht und log_errors auf 1. Folglich landen die 
Fehler nicht im Browser sondern in den Webserver-Logs.</div></blockquote>

<p>
Anschliessend testen wir erneut und schauen ob eine Sinnvolle Fehlermeldung erscheint.
</p>

</div>

<h5>Object oriented style &amp; Procedural style</h5>

<pre>
&lt;?php
    error_reporting(E_ALL);
    ini_set('display_errors', 1);
...
?>
</pre>

<p>
Diese Zeile sollte wieder entfernt werden, bevor man in die produktive Umgebung geht. 
Mehr dazu findest du in der PHP-Doku ? <a href="http://php.net/manual/de/security.errors.php" class="urlextern" target="_blank" title="http://php.net/manual/de/security.errors.php" rel="nofollow noopener">http://php.net/manual/de/security.errors.php</a>
</p>

</div>

<h3> Query-String ausgeben</h3>
<p>
Führte der erste Schritt noch nicht zu einem Resultat, so können wir noch den generierten Query-String testen.
Dazu geben wir diesen mittels echo() aus (Nicht das Result von mysqli_query, 
sondern den zusammengesetzten Query-String).  Zudem versuchen wir noch die Fehlermeldung 
herauszukriegen. Wir erweitern also das mysqli_query() um die Errorausgabe mysqli_error() .
</p>

<h5>Object oriented style</h5>

<pre>

&lt;?php
    error_reporting(E_ALL);
    ini_set('display_errors', 1);
 
    $db = new mysqli('localhost', 'root', '', 'test');
 
    $value = 'test';
	$where = 6;
	$sql  = "UPDATE myTable SET feld_1 = {$value}  WHERE id = {$where};";
 
    echo "{$sql}<br />\n";
	$db->query($sql) or die($db->error);
	echo $db->affected_rows;
?>
</pre>

<h5>Procedural style</h5>

<pre>

&lt;?php
    error_reporting(E_ALL);
    ini_set('display_errors', 1);
 
    $db = mysqli_connect('localhost', 'root', '', 'test');
 
    $value = 'test';
    $where = 6;
    $sql  = "UPDATE myTable SET feld_1 = {$value}  WHERE id = {$where};";
 
    echo "{$sql}<br />\n";
    mysqli_query($db, $sql) or die(mysqli_error());
    echo mysqli_affected_rows($db);
?>
</pre>

<p>
In der Ausgabe erscheint dann etwa das Folgende: Unser SQL und eine Fehlermeldung
</p>
<pre>
UPDATE myTable SET feld_1 = test WHERE id = 6;
Unknown column 'feld_1' in 'field list'
</pre>

<p>
So haben wir eine Fehlermeldung die etwas aussagt und das SQL, wie es an die Datenbank abgesetzt wird. 
Mit diesen Informationen können andere Programmierer in Foren etc. besser helfen als 'nur' mit der Meldung 'Es geht nicht'.
</p>

<p>
Geübte SQL-Leser sehen hier sofort den Fehler.  test ist natürlich kein Feld sondern ein String und sollte in '…' gesetzt werden.
</p>

<h3> Testen mit phpMyAdmin</h3>
<p>
Um das Sql zu verfeinern und zu testen kann man dieses nun aus der Ausgabe kopieren und mit phpMyAdmin oder einem anderen Tool für MySQL
testen und anpassen bis es funktioniert. Das funktionierende SQL anschliessend wieder zurück in den PHP-Code implentieren
</p>
<p>
Unser korrigiertes und getestete SQL sieht dann so aus
</p>
<pre>
UPDATE myTable SET feld_1 = 'test'  WHERE id = 6;
</pre>

<h3> Korrektur einpflegen</h3>
<p>
Zum Schluss müssen wir nur noch das error_reporting() sowie unser echo() wieder entfernen und unseren koriggiertes SQL in den Code einpflegen.
Und so sieht dann der funktionierende Code aus
</p>

<h5>Object oriented style</h5>
<pre>
&lt;?php
    $db = new mysqli('localhost', 'root', '', 'test');
 
    $value = 'test';
	$where = 6;
	$sql  = "UPDATE myTable SET feld_1 = '{$value}''  WHERE id = {$where};";
	$db->query($sql) or die($db->error);
	echo $db->affected_rows;
?>
</pre>
<h5>Procedural style</h5>
<pre>
&lt;?php
    $db = mysqli_connect('localhost', 'root', '', 'test');
 
    $value = 'test';
    $where = 6;
    $sql  = "UPDATE myTable SET feld_1 = '{$value}'  WHERE id = {$where};";
    mysqli_query($db, $sql) or die(mysqli_error($db));
    echo mysqli_affected_rows($db);
?>
</pre>