Zend_Db_Profiler peut être activé pour permettre le profilage de requêtes. Les profils incluent les requête exécutées par l'adapteur, ainsi que leur temps d'exécution, permettant l'inspection des requêtes qui ont été exécutées sans avoir besoin de rajouter du code spécifique au débuggage aux classes. L'utilisation avancé permet aussi au developpeur de filtrer quelles requêtes il souhaite profiler.

Le profileur s'active soir en passant une directive au constructeur de l'adapteur, soit en spécifiant à l'adapteur de l'activer plus tard.

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

$params = array (
    'host'     => '127.0.0.1',
    'username' => 'malory',
    'password' => '******',
    'dbname'   => 'camelot',
    'profiler' => true  // turn on profiler; set to false to disable (default)
);

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

// coupe le profileur:
$db->getProfiler()->setEnabled(false);

// active le profileur:
$db->getProfiler()->setEnabled(true);
?>

Vous pouvez récupérer le profileur en utilisant la méthode getProfiler() de l'adapteur:

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

Ceci retourne une instance de Zend_Db_Profiler. Avec cette instance, le développeur peut examiner les requêtes en utilisant un éventail de méthodes :

La valeur de retour de getLastQueryProfile() et les élements individuels de getQueryProfiles() sont des objets de type Zend_Db_Profiler_Query qui permettent d'inspecter les requêtes:

L'information que Zend_Db_Profiler founie est utile pour profiler des goulets d'étranglement dans les applications, ainsi que pour débugger les requêtes qui viennent d'être exécutées. Pour le moment, pour voir la dernière requête qui vient de s'exécuter:

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

echo $query->getQuery();
?>

Si une page se génère lentement, utilisez le profileur pour déterminer le nombre total de requêtes, et ensuite passer d'une requête à l'autre pour voir laquelle a été la plus longue:

<?php
$tempsTotal       = $profileur->gettotalElapsedSeconds();
$nombreRequetes   = $profileur->getTotalNumQueries();
$tempsLePlusLong  = 0;
$requeteLaPlusLongue = null;

foreach ($profileur->getQueryProfiles() as $query) {
    if ($query->getElapsedSecs() > $tempsLePlusLong) {
        $tempsLePlusLong  = $query->getElapsedSecs();
        $requeteLaPlusLongue = $query->getQuery();
    }
}

echo 'Executé ' . $nombreRequetes . ' requêtes en ' . $tempsTotal . ' secondes' . "\n";
echo 'Temps moyen : ' . $nombreRequetes / $tempsTotal . ' secondes' . "\n";
echo 'Requête la plus lente : ' . $tempsLePlusLong . "\n";
echo "Requête la plus longue : \n" . $requeteLaPlusLongue . "\n";
?>

En plus de l'inspection de requête, le profileur permet aussi au développeur de filtrer quelles requêtes il veut profiler. Les méthodes suivantes fonctionnent avec une instance de Zend_Db_Profiler :

<?php
// Seules les requêtes qui durent au moins 5 secondes sont profilées:
$profileur->setFilterElapsedSecs(5);

// Profil de toutes les requête, peu importe leur longueur:
$profileur->setFilterElapsedSecs(null);
?>

<?php
// profile uniquement les requêtes SELECT
$profileur->setFilterQueryType(Zend_Db_Profiler::SELECT);

// profile les requêtes SELECT, INSERT, et UPDATE
$profileur->setFilterQueryType(Zend_Db_Profiler::SELECT | Zend_Db_Profiler::INSERT | Zend_Db_Profiler::UPDATE);

// profile les requêtes DELETE
$profileur->setFilterQueryType(Zend_Db_Profiler::DELETE);

// Efface tous les filtres
$profileur->setFilterQueryType(null);
?>

            <?php
// Récupère uniquement les profils des requêtes SELECT
$profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::SELECT);

// Récupère uniquement les profils des requêtes SELECT, INSERT, et UPDATE
$profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::SELECT | Zend_Db_Profiler::INSERT | Zend_Db_Profiler::UPDATE);

// Récupère uniquement les profils des requêtes DELETE (on peut donc comprendre pourquoi les données
// disparaissent)
$profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::DELETE);
?>