Zend_Db_Profiler kan worden geactiveerd om queries te profileren. Profielen bevatten de door de adapter uitgevoerde queries evenals de tijd die nodig was om de queries uit te voeren. Dit laat inspectie van de uitgevoerde queries toe zonder bijkomende debug code aan de klassen toe te voegen. Geavanceerd gebruik laat de ontwikkelaar filteren welke queries geprofileerd worden.

Activeren van de profiler kan op twee wijzen gebeuren: een directive aan de adapter constructor doorgeven, of door de adapter te vragen het later te activeren.

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

$params = array (
    'host'     => '127.0.0.1',
    'username' => 'arthur',
    'password' => '******',
    'dbname'   => 'camelot',
    'profiler' => true  // profiler activeren; naar false zetten om te de-activeren (standaard)
);

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

// profiler de-activeren:
$db->getProfiler()->setEnabled(false);

// profiler activeren:
$db->getProfiler()->setEnabled(true);
?>

De profiler kan op eender welk moment worden aangeroepen via de getProfiler() methode van de adapter:

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

Dit geeft een objectinstantie van Zend_Db_Profiler terug. Met deze instantie kan de ontwikkelaar je queries inspecteren via verscheidene methodes:

De teruggegeven waarde van getLastQueryProfile() en de individuele elementen van getQueryProfiles() zijn Zend_Db_Profiler_Query objecten die je de mogelijkheid geven om de individuele queries zelf te inspecteren:

De informatie die Zend_Db_Profiler verstrekt is handig voor het profileren van opstoppers in programma's en voor het debuggen van gebruikte queries. Bijvoorbeeld, om de exacte laatst uitgevoerde query te zien:

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

echo $query->getQuery();
?>

Misschien doet een pagina er lang over om afgebeeld te worden; gebruik dan de profiler om eerst het totaal aantal seconden van alle queries te verkrijgen, en dan de queries één voor één te doorlopen om uit te vinden welke het langste duurde:

<?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 $queryCount . ' queries uitgevoerd in ' . $totalTime . ' seconden' . "\n";
echo 'Gemiddelde query tijd: ' . $totalTime / $queryCount . ' seconden' . "\n";
echo 'Queries per seconde: ' . $queryCount / $totalTime . "\n";
echo 'Langste query tijd: ' . $longestTime . "\n";
echo "Langste query: \n" . $longestQuery . "\n";
?>

Bovenop query inspectie staat de profiler je ook toe de queries die worden geprofileerd te filteren. De volgende methodes kunnen op een Zend_Db_Profiler instantie worden uitgevoerd:

<?php
// Profileer alleen queries die langer dan 5 seconden duren:
$profiler->setFilterElapsedSecs(5);

// Profileer alle queries ongeacht de uitvoeringstijd:
$profiler->setFilterElapsedSecs(null);
?>

<?php
// profileer enkel SELECT queries
$profiler->setFilterQueryType(Zend_Db_Profiler::SELECT);

// profileer SELECT, INSERT, en UPDATE queries
$profiler->setFilterQueryType(Zend_Db_Profiler::SELECT | Zend_Db_Profiler::INSERT | Zend_Db_Profiler::UPDATE);

// profileer DELETE queries (zodat we kunnnen uitvissen waarom data maar blijft verdwijnen)
$profiler->setFilterQueryType(Zend_Db_Profiler::DELETE);

// Alle filters verwijderen
$profiler->setFilterQueryType(null);
?>

<?php
// Alleen SELECT query profielen verkrijgen
$profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::SELECT);

// Alleen SELECT, INSERT, en UPDATE query profielen verkrijgen
$profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::SELECT | Zend_Db_Profiler::INSERT | Zend_Db_Profiler::UPDATE);

// Alleen DELETE query profielen verkrijgen (zodat we kunnen nagaan waarom data maar blijft verdwijnen)
$profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::DELETE);
?>