Zend_Db_Profiler puede ser habilitado para Perfilar las consultas. Los Perfiles incluyen la consulta procesada por el adaptador como el tiempo as transcurrido en la ejecución de las consultas, permitiendo inspeccionar las consultas realizadas win necesidad de agregar información de depuración extra en el código de las clases. El uso avanzado también permite que el desarrollador filtre las consultas que desea perfilar.

Habilite el perfilador pasando una directiva al al constructor del adaptador, o pidiendole al adaptador permitirlo más adelante.

$params = array(
    'host'     => '127.0.0.1',
    'username' => 'webuser',
    'password' => 'xxxxxxxx',
    'dbname'   => 'test'
    'profiler' => true  // enciende el perfilador
                        // establezca false para deshabilitar (está deshabilitado por defecto)
);

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

// apagar el perfilador:
$db->getProfiler()->setEnabled(false);

// encender el perfilador:
$db->getProfiler()->setEnabled(true);

El valor de la opción ' profiler ' es flexible. Es interpretada de distintas formas dependiendo del tipo. Normalmente, debería usar un valor booleano simple, pero otros tipos le permiten personalizar el comportamiento del perfilador.

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

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

Una instancia del objeto perfilador hace que el adaptador use ese objeto. El tipo del objeto debe ser Zend_Db_Profiler o una subclase de este. 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 conteniendo algunas o todas las claves ' enabled ', ' instance ', y ' class '. Las claves ' enabled ' e ' instance ' corresponden a los tipos booleano y la instancia documentada previamente. La clave ' class ' es usada para nombrar la clase que usará el perfilador personalizado. La clase debe ser Zend_Db_Profiler o una subclase. La clase es instanciada sin argumentos de constructor. La opción ' class ' es ignorada cuando la opción ' instance ' está dada.

$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 conteniendo las propiedades, que son tratadas como las claves de array descritas recién. Por ejemplo, un archivo " config.ini " puede contener los siguientes datos:

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

Esta configuración puede ser aplicada con 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 ' debe ser usada como 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 este punto, obtenemos el perfilador usando el método getProfiler() del adaptador:

$profiler = $db->getProfiler();

Este retorna una instancia del objeto Zend_Db_Profiler . Con esta instancia, el desarrollador puede examinar las consultar usando una variedad de métodos:

El valor de retorno de getLastQueryProfile() y elementos individuales de getQueryProfiles() son Zend_Db_Profiler_Query objetos, que proporcionan la capacidad para inspeccionar cada una de las consultas:

La información que Zend_Db_Profiler provee es útil para perfilar cuellos de botella en aplicaciones, y para depurar consultas que han sido ejecutadas. Por instancia, para ver la consulta exacta que tuvo la última ejecución:

$query = $profiler->getLastQueryProfile();

echo $query->getQuery();

Tal vez una página se genera lentamente; use el perfilador para determinar primero el número total de segundos de todas las consultas, y luego recorrer paso a paso a través de las consultas para encontrar la más lenta:

$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 'Ejecutadas ' . $queryCount . ' consultas en ' . $totalTime .
     ' segundos' . "\n";
echo 'Promedio de tiempo de consulta: ' . $totalTime / $queryCount .
     ' segundos' . "\n";
echo 'Consultas por segundo: ' . $queryCount / $totalTime . "\n";
echo 'Tardanza de la consulta más lenta: ' . $longestTime . "\n";
echo "Consulta más lenta: \n" . $longestQuery . "\n";

Además de la inspección de consultas, el perfilador también le permite al desarrollador filtrar que consultas serán perfiladas. El siguiente método opera en una instancia de Zend_Db_Profiler :

// Solo perfilar consultas que tardan más de 5 segundos:
$profiler->setFilterElapsedSecs(5);

// Perfilar todas las consultas sin importar el tiempo:
$profiler->setFilterElapsedSecs(null);

// Perfilar solo consultas SELECT
$profiler->setFilterQueryType(Zend_Db_Profiler::SELECT);

// Perfila consultas SELECT, INSERT, y UPDATE
$profiler->setFilterQueryType(Zend_Db_Profiler::SELECT |
                              Zend_Db_Profiler::INSERT |
                              Zend_Db_Profiler::UPDATE);

// Perfilar consultas DELETE
$profiler->setFilterQueryType(Zend_Db_Profiler::DELETE);

// Remover todos los filtros
$profiler->setFilterQueryType(null);

// Obtiene solo perfiles de consultas SELECT
$profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::SELECT);

// Obtiene los perfiles de consultas SELECT, INSERT, y UPDATE
$profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::SELECT |
                                        Zend_Db_Profiler::INSERT |
                                        Zend_Db_Profiler::UPDATE);

// Obtiene solo perfiles de consultas DELETE
$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 más especificas.

// En tu archivo bootstrap

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

// Anexar el perfilador a tu adaptador de base de datos
$db->setProfiler($profiler)

// Despachar el controlador frontal

// Todas las consultas a la base de datos en tus archivos modelo, vista y controlador
// ahora serán perfilados y enviados a Firebug

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

// Anexar el perfilador a tu adaptador de base de datos
$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);

// Iniciar un buffer de las salidas
ob_start();

// Ahora se pueden ejecutar las consultas a la Base de Datos para ser perfiladas

// Enviar los datos de perfilado al navegador
$channel->flush();
$response->sendHeaders();