Zend_Db_Profiler puede habilitarse para permitir el perfilado de consultas. Los perfiles incluyen las consultas procesadas por el adaptador, así como el tiempo transcurrido para ejecutar las consultas, permitiendo inspeccionar las consultas que se han realizado sin necesidad de añadir código de depuración adicional a las clases. El uso avanzado también permite al desarrollador filtrar qué consultas se perfilan.

Habilite el perfilador pasando una directiva al constructor del adaptador, o pidiendo al adaptador que lo habilite más tarde.

$params = array(
    'host'     => '127.0.0.1',
    'username' => 'webuser',
    'password' => 'xxxxxxxx',
    'dbname'   => 'test'
    'profiler' => true  // turn on profiler
                        // set to false to disable (disabled by default)
);

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

// turn off profiler:
$db->getProfiler()->setEnabled(false);

// turn on profiler:
$db->getProfiler()->setEnabled(true);

El valor de la opción 'profiler' es flexible. Se interpreta de manera diferente según su tipo. La mayoría de las veces, debe usar un valor booleano simple, pero otros tipos le permiten personalizar el comportamiento del perfilador.

Un argumento booleano establece el perfilador como habilitado si es un valor TRUE, o deshabilitado si es FALSE. La clase del perfilador es la clase de perfilador predeterminada del adaptador, Zend_Db_Profiler.

$params['profiler'] = true;
$db = Zend_Db::factory('PDO_MYSQL', $params);

Una instancia de un objeto perfilador hace que el adaptador use ese objeto. El tipo del objeto debe ser Zend_Db_Profiler o una subclase del mismo. Habilitar el perfilador se hace por separado.

$profiler = MyProject_Db_Profiler();
$profiler->setEnabled(true);
$params['profiler'] = $profiler;
$db = Zend_Db::factory('PDO_MYSQL', $params);

El argumento puede ser un array asociativo que contenga cualquiera o todas las claves 'enabled', 'instance', y 'class'. Las claves 'enabled' y 'instance' corresponden a los tipos booleano e instancia documentados anteriormente. La clave 'class' se usa para nombrar una clase a usar para un perfilador personalizado. La clase debe ser Zend_Db_Profiler o una subclase. La clase se instancia sin argumentos de constructor. La opción 'class' se ignora cuando se proporciona la opción 'instance'.

$params['profiler'] = array(
    'enabled' => true,
    'class'   => 'MyProject_Db_Profiler'
);
$db = Zend_Db::factory('PDO_MYSQL', $params);

Finalmente, el argumento puede ser un objeto de tipo Zend_Config que contenga propiedades, que se tratan como las claves de array descritas anteriormente. Por ejemplo, un archivo "config.ini" podría contener los siguientes datos:

[main]
db.profiler.class   = "MyProject_Db_Profiler"
db.profiler.enabled = true

Esta configuración se puede aplicar mediante el siguiente código PHP:

$config = new Zend_Config_Ini('config.ini', 'main');
$params['profiler'] = $config->db->profiler;
$db = Zend_Db::factory('PDO_MYSQL', $params);

La propiedad 'instance' se puede usar como en el siguiente ejemplo:

$profiler = new MyProject_Db_Profiler();
$profiler->setEnabled(true);
$configData = array(
    'instance' => $profiler
    );
$config = new Zend_Config($configData);
$params['profiler'] = $config;
$db = Zend_Db::factory('PDO_MYSQL', $params);

En cualquier momento, obtenga el perfilador usando el método getProfiler() del adaptador:

$profiler = $db->getProfiler();

Esto devuelve una instancia de objeto Zend_Db_Profiler. Con esa instancia, el desarrollador puede examinar sus consultas usando una variedad de métodos:

El valor de retorno de getLastQueryProfile() y los elementos individuales de getQueryProfiles() son objetos Zend_Db_Profiler_Query, que proporcionan la capacidad de inspeccionar las consultas individuales en sí mismas:

La información que proporciona Zend_Db_Profiler es útil para perfilar cuellos de botella en aplicaciones, y para depurar consultas que se han ejecutado. Por ejemplo, para ver la consulta exacta que se ejecutó por última vez:

$query = $profiler->getLastQueryProfile();

echo $query->getQuery();

Quizás una página se está generando lentamente; use el perfilador para determinar primero el número total de segundos de todas las consultas, y luego recorrer las consultas para encontrar la que se ejecutó más tiempo:

$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";

Además de la inspección de consultas, el perfilador también permite al desarrollador filtrar qué consultas se perfilan. Los siguientes métodos operan sobre una instancia de Zend_Db_Profiler:

// Only profile queries that take at least 5 seconds:
$profiler->setFilterElapsedSecs(5);

// Profile all queries regardless of length:
$profiler->setFilterElapsedSecs(null);

// profile only SELECT queries
$profiler->setFilterQueryType(Zend_Db_Profiler::SELECT);

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

// profile DELETE queries
$profiler->setFilterQueryType(Zend_Db_Profiler::DELETE);

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

// Retrieve only SELECT query profiles
$profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::SELECT);

// Retrieve only SELECT, INSERT, and UPDATE query profiles
$profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::SELECT |
                                        Zend_Db_Profiler::INSERT |
                                        Zend_Db_Profiler::UPDATE);

// Retrieve DELETE query profiles
$profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::DELETE);

Un Perfilador Especializado es un objeto que hereda de Zend_Db_Profiler. Los Perfiladores Especializados tratan la información de perfilado de maneras específicas.

// In your bootstrap file

$profiler = new Zend_Db_Profiler_Firebug('All DB Queries');
$profiler->setEnabled(true);

// Attach the profiler to your db adapter
$db->setProfiler($profiler);

// Dispatch your front controller

// All DB queries in your model, view and controller
// files will now be profiled and sent to Firebug

$profiler = new Zend_Db_Profiler_Firebug('All DB Queries');
$profiler->setEnabled(true);

// Attach the profiler to your db adapter
$db->setProfiler($profiler);

$request  = new Zend_Controller_Request_Http();
$response = new Zend_Controller_Response_Http();
$channel  = Zend_Wildfire_Channel_HttpHeaders::getInstance();
$channel->setRequest($request);
$channel->setResponse($response);

// Start output buffering
ob_start();

// Now you can run your DB queries to be profiled

// Flush profiling data to browser
$channel->flush();
$response->sendHeaders();