Zend_Db_Profiler kann aktiviert werden, um das Erstellen von Profilen für Abfragen zu erlauben. Die Profile enthalten die Abfragen, die durch den Adapter verarbeitet worden sind, sowie die Laufzeit der Abfragen, um die Kontrolle der verarbeiteten Abfragen zu ermöglichen, ohne das extra Code für das Debugging zu den Klassen hinzugefügt werden muß. Die erweiterte Verwendung ermöglicht den Entwickler sogar zu filtern, welche Abfragen aufgezeichnet werden sollen.

Der Profiler wird entweder durch die Übergabe eines Parameters an den Konstruktor des Adapters oder zu einem späteren Zeitpunkt direkt an den Adapter aktiviert.

<?php
require_once 'Zend/Db.php';

$params = array (
    'host'     => '127.0.0.1',
    'username' => 'malory',
    'password' => '******',
    'dbname'   => 'camelot',
    'profiler' => true  // aktiviere den Profiler; false, um ihn zu deaktivieren (Standard)
);

$db = Zend_Db::factory('PDO_MYSQL', $params);

// deaktiviere Profiler
$db->getProfiler()->setEnabled(false);

// aktiviere Profiler
$db->getProfiler()->setEnabled(true);
?>

Der Profiler kann jederzeit über die Adapter Methode getProfiler() geholt werden:

<?php
$profiler = $db->getProfiler();
?>

Dies gibt eine Zend_Db_Profiler Objektinstanz zurück. Mit dieser Instanz kann der Entwickler seine Abfragen mit Hilfe von verschiedenen Methoden untersuchen:

Der Rückgabewert von getLastQueryProfile() und die einzelnen Elemente von getQueryProfiles() sind Zend_Db_Profiler_Query Objekte, welche die Möglichkeit bieten, die individuellen Abfragen zu untersuchen:

Die Informationen, die Zend_Db_Profiler bereitstellt, sind nützlich, um Engpässe in der Anwendung zu ermitteln und um Abfragen zu überprüfen, die durchgeführt worden sind. Um zum Beispiel die genaue Abfrage zu sehen, die zuletzt durchgeführt worden ist:

<?php
$query = $profiler->getLastQueryProfile();

echo $query->getQuery();
?>

Vielleicht wird eine Seite langsam erstellt; verwende den Profiler, um zuerst die gesamte Laufzeit aller Abfragen zu ermitteln und dann durchlaufe die Abfragen, um die am längsten laufende zu finden:

<?php
$totalTime    = $profiler->getTotalElapsedSecs();
$queryCount   = $profiler->getTotalNumQueries();
$longestTime  = 0;
$longestQuery = null;

foreach ($profiler->getQueryProfiles() as $query) {
    if ($query->getElapsedSecs() > $longestTime) {
        $longestTime  = $query->getElapsedSecs();
        $longestQuery = $query->getQuery();
    }
}

echo 'Executed ' . $queryCount . ' queries in ' . $totalTime . ' seconds' . "\n";
echo 'Average query length: ' . $totalTime / $queryCount . ' seconds' . "\n";
echo 'Queries per second: ' . $queryCount / $totalTime . "\n";
echo 'Longest query length: ' . $longestTime . "\n";
echo "Longest query: \n" . $longestQuery . "\n";
?>

Zusätzlich zum Untersuchen von Anfragen erlaubt der Profiler dem Entwickler auch zu filtern, welche Abfragen aufgezeichnet werden sollen. Die folgenden Methoden arbeiten mit einer Zend_Db_Profiler Instanz:

<?php
// Zeichne nur Abfragen auf, die mindestens 5 Sekunden laufen:
$profiler->setFilterElapsedSecs(5);

// Zeichne alle Abfragen unabhängig von deren Laufzeit auf:
$profiler->setFilterElapsedSecs(null);
?>

<?php
// zeichne nur SELECT Abfragen auf
$profiler->setFilterQueryType(Zend_Db_Profiler::SELECT);

// zeichne SELECT, INSERT und UPDATE Abfragen auf
$profiler->setFilterQueryType(Zend_Db_Profiler::SELECT | Zend_Db_Profiler::INSERT | Zend_Db_Profiler::UPDATE);

// zeichne DELETE Abfragen auf (damit wir herausfinden, warum Daten verloren gehen)
$profiler->setFilterQueryType(Zend_Db_Profiler::DELETE);

// Remove all filters
$profiler->setFilterQueryType(null);
?>

<?php
// Hole nur SELECT Abfragen zurück
$profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::SELECT);

// Hole nur SELECT, INSERT un UPDATE Abfragen zurück
$profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::SELECT | Zend_Db_Profiler::INSERT | Zend_Db_Profiler::UPDATE);

// Hole DELETE Abfragen zuürck (damit wir herausfinden, warum Daten verloren gehen)
$profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::DELETE);
?>