|
|
@@ -1,5 +1,5 @@
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
-<!-- EN-Revision: 17178 -->
|
|
|
+<!-- EN-Revision: 19484 -->
|
|
|
<!-- Reviewed: no -->
|
|
|
<sect1 id="zend.db.profiler" xmlns:xi="http://www.w3.org/2001/XInclude">
|
|
|
<title>Zend_Db_Profiler</title>
|
|
|
@@ -42,68 +42,86 @@ $db->getProfiler()->setEnabled(true);
|
|
|
]]></programlisting>
|
|
|
|
|
|
<para>
|
|
|
- La valeur de l'option <code>profiler</code> est souple. Elle est interprétée
|
|
|
+ La valeur de l'option <property>profiler</property> est souple. Elle est interprétée
|
|
|
différemment suivant son type. La plupart du temps, vous devriez simplement utiliser une
|
|
|
variable booléenne, mais d'autres valeurs vous permettent de personnaliser le
|
|
|
comportement du profileur.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Un argument booléen active le profileur si c'est une valeur <constant>TRUE</constant>, ou
|
|
|
- le désactive si <constant>FALSE</constant>. La classe de profileur est celle par défaut, par
|
|
|
- exemple <classname>Zend_Db_Profiler</classname>. <programlisting language="php"><![CDATA[
|
|
|
+ Un argument booléen active le profileur si c'est une valeur <constant>TRUE</constant>,
|
|
|
+ ou le désactive si <constant>FALSE</constant>. La classe de profileur est celle par
|
|
|
+ défaut, par exemple <classname>Zend_Db_Profiler</classname>.
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <programlisting language="php"><![CDATA[
|
|
|
$params['profiler'] = true;
|
|
|
$db = Zend_Db::factory('PDO_MYSQL', $params);
|
|
|
]]></programlisting>
|
|
|
- </para>
|
|
|
|
|
|
<para>
|
|
|
Une instance d'un objet profileur fait que l'adaptateur utilise cet objet. L'objet
|
|
|
doit être de type <classname>Zend_Db_Profiler</classname> ou une sous-classe.
|
|
|
- L'activation du profileur est faite séparément. <programlisting language="php"><![CDATA[
|
|
|
+ L'activation du profileur est faite séparément.
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <programlisting language="php"><![CDATA[
|
|
|
$profiler = Mon_Db_Profiler();
|
|
|
$profiler->setEnabled(true);
|
|
|
$params['profiler'] = $profiler;
|
|
|
$db = Zend_Db::factory('PDO_MYSQL', $params);
|
|
|
]]></programlisting>
|
|
|
- </para>
|
|
|
|
|
|
<para>
|
|
|
L'argument peut être un tableau associatif contenant une ou toutes les clés
|
|
|
- suivantes : "<code>enabled</code>", "<code>instance</code>", et "<code>class</code>".
|
|
|
- Les clés "<code>enabled</code>" et "<code>instance</code>" correspondent aux types
|
|
|
- booléen et instance décrites ci-dessus. La clé "<code>class</code>" est utilisée pour
|
|
|
+ suivantes : "<property>enabled</property>", "<property>instance</property>", et
|
|
|
+ "<property>class</property>". Les clés "<property>enabled</property>" et
|
|
|
+ "<property>instance</property>" correspondent aux types booléen et instance décrites
|
|
|
+ ci-dessus. La clé "<property>class</property>" est utilisée pour
|
|
|
nommer une classe à prendre en tant que profileur personnalisé. La classe doit être de
|
|
|
type <classname>Zend_Db_Profiler</classname> ou une sous-classe. La classe est
|
|
|
- instanciée sans aucun argument de constructeur. L'option "<code>class</code>" est
|
|
|
- ignorée quand l'option "<code>instance</code>" est fournie. <programlisting
|
|
|
- role="php"><![CDATA[
|
|
|
+ instanciée sans aucun argument de constructeur. L'option "<property>class</property>"
|
|
|
+ est ignorée quand l'option "<property>instance</property>" est fournie.
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <programlisting
|
|
|
+ language="php"><![CDATA[
|
|
|
$params['profiler'] = array(
|
|
|
'enabled' => true,
|
|
|
'class' => 'Mon_Db_Profiler'
|
|
|
);
|
|
|
$db = Zend_Db::factory('PDO_MYSQL', $params);
|
|
|
]]></programlisting>
|
|
|
- </para>
|
|
|
|
|
|
<para>
|
|
|
Enfin, l'argument peut être un objet de type <classname>Zend_Config</classname>
|
|
|
contenant des propriétés, qui sont traitées comme les clés de tableaux décrites
|
|
|
- ci-dessus. Par exemple, une fichier "config.ini" peut contenir les données
|
|
|
- suivantes :
|
|
|
- <programlisting language="ini"><![CDATA[
|
|
|
+ ci-dessus. Par exemple, un fichier "<filename>config.ini</filename>" peut
|
|
|
+ contenir les données suivantes :
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <programlisting language="ini"><![CDATA[
|
|
|
[main]
|
|
|
db.profiler.class = "Mon_Db_Profiler"
|
|
|
db.profiler.enabled = true
|
|
|
]]></programlisting>
|
|
|
- Cette configuration peut être appliquée par le code PHP suivant :
|
|
|
- <programlisting language="php"><![CDATA[
|
|
|
+
|
|
|
+ <para>
|
|
|
+ Cette configuration peut être appliquée par le code <acronym>PHP</acronym>
|
|
|
+ suivant :
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <programlisting language="php"><![CDATA[
|
|
|
$config = new Zend_Config_Ini('config.ini', 'main');
|
|
|
$params['profiler'] = $config->db->profiler;
|
|
|
$db = Zend_Db::factory('PDO_MYSQL', $params);
|
|
|
]]></programlisting>
|
|
|
- La propriété "<code>instance</code>" peut être utilisée comme ceci :
|
|
|
- <programlisting language="php"><![CDATA[
|
|
|
+
|
|
|
+ <para>
|
|
|
+ La propriété "<property>instance</property>" peut être utilisée comme ceci :
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <programlisting language="php"><![CDATA[
|
|
|
$profiler = new Mon_Db_Profiler();
|
|
|
$profiler->setEnabled(true);
|
|
|
$configData = array(
|
|
|
@@ -113,7 +131,6 @@ $config = new Zend_Config($configData);
|
|
|
$params['profiler'] = $config;
|
|
|
$db = Zend_Db::factory('PDO_MYSQL', $params);
|
|
|
]]></programlisting>
|
|
|
- </para>
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="zend.db.profiler.using">
|
|
|
@@ -137,35 +154,37 @@ $profileur = $db->getProfiler();
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>getTotalNumQueries()</methodname> retourne le nombre total de requêtes
|
|
|
- profilées.
|
|
|
+ <methodname>getTotalNumQueries()</methodname> retourne le nombre total de
|
|
|
+ requêtes profilées.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>getTotalElapsedSecs()</methodname> retourne le nombre total de secondes
|
|
|
- écoulées pour chaque requête profilée.
|
|
|
+ <methodname>getTotalElapsedSecs()</methodname> retourne le nombre total de
|
|
|
+ secondes écoulées pour chaque requête profilée.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>getQueryProfiles()</methodname> retourne un tableau de tous les profils de
|
|
|
- requêtes.
|
|
|
+ <methodname>getQueryProfiles()</methodname> retourne un tableau de tous les
|
|
|
+ profils de requêtes.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>getLastQueryProfile()</methodname> retourne le profil de requête le plus
|
|
|
- récent, peut importe si la requête à fini de s'exécuter ou pas (si l'exécution
|
|
|
- n'est pas finie, le temps de fin sera <constant>NULL</constant>).
|
|
|
+ <methodname>getLastQueryProfile()</methodname> retourne le profil de requête le
|
|
|
+ plus récent, peut importe si la requête à fini de s'exécuter ou pas (si
|
|
|
+ l'exécution n'est pas finie, le temps de fin sera <constant>NULL</constant>).
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
- <para><methodname>clear()</methodname> nettoie tous les anciens profils de la pile.</para>
|
|
|
+ <para>
|
|
|
+ <methodname>clear()</methodname> nettoie tous les anciens profils de la pile.
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
|
|
|
@@ -179,11 +198,11 @@ $profileur = $db->getProfiler();
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>getQuery()</methodname> retourne le <acronym>SQL</acronym> de la requête sous forme de texte.
|
|
|
- Le texte de <acronym>SQL</acronym> d'une requête préparée avec des paramètres est le texte au
|
|
|
- moment où la requête a été préparée, donc il contient les emplacements de
|
|
|
- paramètre, mais pas les valeurs utilisées quand la déclaration est
|
|
|
- exécutée.
|
|
|
+ <methodname>getQuery()</methodname> retourne le <acronym>SQL</acronym> de la
|
|
|
+ requête sous forme de texte. Le texte de <acronym>SQL</acronym> d'une requête
|
|
|
+ préparée avec des paramètres est le texte au moment où la requête a été
|
|
|
+ préparée, donc il contient les emplacements de paramètre, mais pas les
|
|
|
+ valeurs utilisées quand la déclaration est exécutée.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
@@ -191,16 +210,16 @@ $profileur = $db->getProfiler();
|
|
|
<para>
|
|
|
<methodname>getQueryParams()</methodname> retourne un tableau des valeurs de
|
|
|
paramètres utilisées lors de l'exécution d'une requête préparée. Ceci inclue à
|
|
|
- la fois les paramètres attachés et les arguments de de la méthode
|
|
|
- <methodname>execute()</methodname>. Les clés du tableau sont les positions (base 1) ou les
|
|
|
- noms des paramètres.
|
|
|
+ la fois les paramètres attachés et les arguments de la méthode
|
|
|
+ <methodname>execute()</methodname>. Les clés du tableau sont les positions
|
|
|
+ (base 1) ou les noms des paramètres.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>getElapsedSecs()</methodname> retourne le nombre de secondes d'exécution
|
|
|
- de la requête.
|
|
|
+ <methodname>getElapsedSecs()</methodname> retourne le nombre de secondes
|
|
|
+ d'exécution de la requête.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
@@ -219,8 +238,8 @@ echo $query->getQuery();
|
|
|
|
|
|
<para>
|
|
|
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 :
|
|
|
+ total de requêtes, et ensuite passer d'une requête à l'autre pour voir laquelle
|
|
|
+ a été la plus longue :
|
|
|
</para>
|
|
|
|
|
|
<programlisting language="php"><
mikaelkael