Table Of ContentsPrevious topicNext topicThis Page |
Evénements et Modèles¶Événements et Gestionnaire d’événements¶Les modèles vous permettent d’écrire des événements qui seront générés lors de la réalisation d’une insertion/mise à jour(m.à.j.)/suppression. Il permettent de définir les règles métiers. Ce qui suit sont les événements supportés par Phalcon\Mvc\Model et leur ordre d’exécution:
Mise en œuvre d’événements dans la classe du Modèle¶La façon la plus facile pour faire en sorte qu’un modèle réagisse aux événement est de réaliser dans la classe une méthode du même nom que l’événement: <?php
namespace Store\Toys;
use Phalcon\Mvc\Model;
class Robots extends Model
{
public function beforeValidationOnCreate()
{
echo "Ceci est exécuté avant la création d'un Robot !";
}
}
Les événements peuvent être utiles pour assigner des valeurs avant la réalisation d’une opération comme par exemple: <?php
use Phalcon\Mvc\Model;
class Products extends Model
{
public function beforeCreate()
{
// Établir la date de création
$this->created_at = date("Y-m-d H:i:s");
}
public function beforeUpdate()
{
// Établir la date de modification
$this->modified_in = date("Y-m-d H:i:s");
}
}
Utilisation d’un Gestionnaire d’Événements personnalisé¶De plus, ce composant est intégré dans Phalcon\Events\Manager, ce qui signifie que nous pouvons créer des écouteurs qui s’exécutent lors du déclenchement d’un événement. <?php
namespace Store\Toys;
use Phalcon\Mvc\Model;
use Phalcon\Events\Event;
use Phalcon\Events\Manager as EventsManager;
class Robots extends Model
{
public function initialize()
{
$eventsManager = new EventsManager();
// Attache une fonction anonyme pour écouter les événements de "model"
$eventsManager->attach(
"model:beforeSave",
function (Event $event, $robot) {
if ($robot->name === "Scooby Doo") {
echo "Scooby Doo isn't a robot!";
return false;
}
return true;
}
);
// Attache le gestionnaire d'événement à l'événement
$this->setEventsManager($eventsManager);
}
}
Dans l’exemple précédent, le Gestionnaire d’Événements agit comme un pont entre l’objet et l’écouteur (la fonction anonyme). Les événements fuseront vers les écouteurs lors de la sauvegarde de ‘robots’: <?php
use Store\Toys\Robots;
$robot = new Robots();
$robot->name = "Scooby Doo";
$robot->year = 1969;
$robot->save();
Si vous voulez que tous les objets créés dans votre application utilisent le même EventsManager, vous devez alors l’assigner au Gestionnaire de Modèles: <?php
use Phalcon\Events\Event;
use Phalcon\Events\Manager as EventsManager;
// Inscription du service "modelsManager"
$di->setShared(
"modelsManager",
function () {
$eventsManager = new EventsManager();
// Attache une fonction anonyme en tant qu'écouteur pour les événements de "model"
$eventsManager->attach(
"model:beforeSave",
function (Event $event, $model) {
// Capture les événements produits par le modèle "Robots"
if (get_class($model) === "Store\\Toys\\Robots") {
if ($model->name === "Scooby Doo") {
echo "Scooby Doo isn't a robot!";
return false;
}
}
return true;
}
);
// Établissement d'un EventsManager par défaut
$modelsManager = new ModelsManager();
$modelsManager->setEventsManager($eventsManager);
return $modelsManager;
}
);
Si un écouteur retourne “faux” alors ceci interrompt l’opération en cours d’exécution. Journalisation des instructions SQL de bas niveau¶Losrqu’on utilise un composant de haut niveau d’abstraction tel que Phalcon\Mvc\Model pour accéder aux données, il devient difficile de savoir quelles sont les instructions qui sont finalement envoyées au SGBD. Phalcon\Mvc\Model est supporté en interne par Phalcon\Db. Phalcon\Logger interagit avec Phalcon\Db, fournissant des capacités de journalisation sur la couche d’abstraction de la base de données, ce qui nous permet de journaliser les instructions quand elles surviennent. <?php
use Phalcon\Logger;
use Phalcon\Events\Manager;
use Phalcon\Logger\Adapter\File as FileLogger;
use Phalcon\Db\Adapter\Pdo\Mysql as Connection;
$di->set(
"db",
function () {
$eventsManager = new EventsManager();
$logger = new FileLogger("app/logs/debug.log");
// Ecoute tous les événements de la base de données
$eventsManager->attach(
"db:beforeQuery",
function ($event, $connection) use ($logger) {
$logger->log(
$connection->getSQLStatement(),
Logger::INFO
);
}
);
$connection = new Connection(
[
"host" => "localhost",
"username" => "root",
"password" => "secret",
"dbname" => "invo",
]
);
// Assigne l'eventsManager à l'instance de l'adaptateur de bd
$connection->setEventsManager($eventsManager);
return $connection;
}
);
Comme les modèles utilisent la connexion par défaut à la base de données, toutes les instructions SQL envoyées au SGBD seront journalisées dans un fichier: <?php
use Store\Toys\Robots;
$robot = new Robots();
$robot->name = "Robby the Robot";
$robot->created_at = "1956-07-21";
if ($robot->save() === false) {
echo "Cannot save robot";
}
D’après le code ci-dessus, le fichier app/logs/db.log doit contenir quelque chose du genre: [Mon, 30 Apr 12 13:47:18 -0500][DEBUG][Resource Id #77] INSERT INTO robots
(name, created_at) VALUES ('Robby the Robot', '1956-07-21')
Profilage des instructions SQL¶Grâce à Phalcon\Db, le composant sous-jacent de Phalcon\Mvc\Model, il est possible de profiler les instructions SQL générées par l’ORM afin d’analyser la performance d’opérations en base de données. Avec ceci vous pouvez diagnostiquer des problèmes de performance et découvrir les goulots d’étranglement. <?php
use Phalcon\Db\Profiler as ProfilerDb;
use Phalcon\Events\Manager as EventsManager;
use Phalcon\Db\Adapter\Pdo\Mysql as MysqlPdo;
$di->set(
"profiler",
function () {
return new ProfilerDb();
},
true
);
$di->set(
"db",
function () use ($di) {
$eventsManager = new EventsManager();
// Récupère une instance partagée de DbProfiler
$profiler = $di->getProfiler();
// Ecoute tous les événements de base de données
$eventsManager->attach(
"db",
function ($event, $connection) use ($profiler) {
if ($event->getType() === "beforeQuery") {
$profiler->startProfile(
$connection->getSQLStatement()
);
}
if ($event->getType() === "afterQuery") {
$profiler->stopProfile();
}
}
);
$connection = new MysqlPdo(
[
"host" => "localhost",
"username" => "root",
"password" => "secret",
"dbname" => "invo",
]
);
// Assigne l'eventsManager à l'instance de l'adaptateur de bd
$connection->setEventsManager($eventsManager);
return $connection;
}
);
Profilons quelques requêtes: <?php
use Store\Toys\Robots;
// Envoi de quelques instructions SQL à la base
Robots::find();
Robots::find(
[
"order" => "name",
]
);
Robots::find(
[
"limit" => 30,
]
);
// Récupère les profils générés par le profileur
$profiles = $di->get("profiler")->getProfiles();
foreach ($profiles as $profile) {
echo "SQL Statement: ", $profile->getSQLStatement(), "\n";
echo "Start Time: ", $profile->getInitialTime(), "\n";
echo "Final Time: ", $profile->getFinalTime(), "\n";
echo "Total Elapsed Time: ", $profile->getTotalElapsedSeconds(), "\n";
}
Chaque profil généré contient le temps en millisecondes que chaque instruction prend pour compléter ainsi l’instruction SQL générée. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||