Doctrine_manual-1-2-en

Chapter 22: Event Listeners 320
Listing
22-26
Listing
22-27
• Doctrine_Event::RECORD_INSERT
• Doctrine_Event::RECORD_SERIALIZE
• Doctrine_Event::RECORD_UNSERIALIZE
• Doctrine_Event::RECORD_DQL_SELECT
• Doctrine_Event::RECORD_DQL_DELETE
• Doctrine_Event::RECORD_DQL_UPDATE
Here are some examples of hooks being used and the code that is returned:
class MyListener extends Doctrine_EventListener
{
public function preExec(Doctrine_Event $event)
{
$event->getCode(); // Doctrine_Event::CONN_EXEC
}
}
class MyRecord extends Doctrine_Record
{
public function preUpdate(Doctrine_Event $event)
{
$event->getCode(); // Doctrine_Event::RECORD_UPDATE
}
}
Getting the Invoker
The method getInvoker() returns the object that invoked the given event. For example for
event Doctrine_Event::CONN_QUERY the invoker is a Doctrine_Connection object.
Here is an example of using the record hook named preUpdate() that is invoked when a
Doctrine_Record instance is saved and an update is issued to the database:
class MyRecord extends Doctrine_Record
{
public function preUpdate(Doctrine_Event $event)
{
$event->getInvoker(); // Object(MyRecord)
}
}
Listing
22-28
Skip Next Operation
Doctrine_Event provides many methods for altering the execution of the listened method
as well as for altering the behavior of the listener chain.
For some reason you may want to skip the execution of the listened method. It can be done as
follows (note that preExec() could be any listener method):
class MyListener extends Doctrine_EventListener
{
public function preExec(Doctrine_Event $event)
{
// some business logic, then:
}
}
$event->skipOperation();
----------------- Brought to you by