PHP hook, building hooks in your application
Introduction
One of the real challenges in building any type of framework, core or application is making it possible for the developers to hook into the business logic at specific points. Since PHP is not event based, nor it works with interrupts you have to come up an alternative.
The test case
Lets assume we are the main developers of a webshop framework. Programmers can use our framework to build complete webshops. Programmers can manage the orders that are placed on the webshop with the order class. The order class is part of our framework and we don’t want it to be extended by any programmer. However we don’t want to limit to programmers in their possibilities to hook into the orders process.
For example programmers should be able to send an email to the webshopowner if an order changes from one specific delivery status to another. This functionality is not part of the default behavior in our framework and is custom for the progammers webshop implementation.
Like said before, PHP doesn’t provide interrupts or real events so we need to come up with another way to implement hooks into our application. Lets take a look at the observer pattern.
Implementing the Observer pattern
The observer pattern is a design-pattern that describes a way for objects to be notified to specific state-changes in objects of the application.
For the first implementation we can use SPL. The SPL provides in two simple objects:
SPLSubject
- attach (new observer to attach)
- detach (existing observer to detach)
- notify (notify all observers)
SPLObserver
- update (Called from the subject (i.e. when it’s value has changed).
iOrderRef = $iOrderRef;
// Get order information from the database or an other resources
$this->iStatus = Order::STATUS_SHIPPED;
}
/**
* Attach an observer
*
* @param SplObserver $oObserver
* @return void
*/
public function attach(SplObserver $oObserver)
{
$sHash = spl_object_hash($oObserver);
if (isset($this->aObservers[$sHash])) {
throw new Exception('Observer is already attached');
}
$this->aObservers[$sHash] = $oObserver;
}
/**
* Detach observer
*
* @param SplObserver $oObserver
* @return void
*/
public function detach(SplObserver $oObserver)
{
$sHash = spl_object_hash($oObserver);
if (!isset($this->aObservers[$sHash])) {
throw new Exception('Observer not attached');
}
unset($this->aObservers[$sHash]);
}
/**
* Notify the attached observers
*
* @param string $sEvent, name of the event
* @param mixed $mData, optional data that is not directly available for the observers
* @return void
*/
public function notify()
{
foreach ($this->aObservers as $oObserver) {
try {
$oObserver->update($this);
} catch(Exception $e) {
}
}
}
/**
* Add an order
*
* @param array $aOrder
* @return void
*/
public function delete()
{
$this->notify();
}
/**
* Return the order reference number
*
* @return int
*/
public function getRef()
{
return $this->iOrderRef;
}
/**
* Return the current order status
*
* @return int
*/
public function getStatus()
{
return $this->iStatus;
}
/**
* Update the order status
*/
public function updateStatus($iStatus)
{
$this->notify();
// ...
$this->iStatus = $iStatus;
// ...
$this->notify();
}
}
/**
* Order status handler, observer that sends an email to secretary
* if the status of an order changes from shipped to delivered, so the
* secratary can make a phone call to our customer to ask for his opinion about the service
*
* @package Shop
*/
class OrderStatusHandler implements SplObserver
{
/**
* Previous orderstatus
* @var int
*/
protected $iPreviousOrderStatus;
/**
* Current orderstatus
* @var int
*/
protected $iCurrentOrderStatus;
/**
* Update, called by the observable object order
*
* @param Observable_Interface $oSubject
* @param string $sEvent
* @param mixed $mData
* @return void
*/
public function update(SplSubject $oSubject)
{
if(!$oSubject instanceof Order) {
return;
}
if(is_null($this->iPreviousOrderStatus)) {
$this->iPreviousOrderStatus = $oSubject->getStatus();
} else {
$this->iCurrentOrderStatus = $oSubject->getStatus();
if($this->iPreviousOrderStatus === Order::STATUS_SHIPPED && $this->iCurrentOrderStatus === Order::STATUS_DELIVERED) {
$sSubject = sprintf('Order number %d is shipped', $oSubject->getRef());
//mail('secratary@example.com', 'Order number %d is shipped', 'Text');
echo 'Mail sended to the secratary to help her remember to call our customer for a survey.';
}
}
}
}
$oOrder = new Order(26012011);
$oOrder->attach(new OrderStatusHandler());
$oOrder->updateStatus(Order::STATUS_DELIVERED);
$oOrder->delete();
?>
There are several problems with the implementation above. To most important disadvantage is that we have only one update method in our observer. In this update method we don’t know when and why we are getting notified, just that something happened. We should keep track of everything that happens in the subject. (Or use debug_backtrace… just joking, don’t even think about using it that way ever!).
Taking it a step further, events
Lets take a look at the next example, we will extend the Observer implementation with some an additional parameter for the eventname that occured.
Finishing up, optional data
iOrderRef = $iOrderRef;
// Get order information from the database or something else...
$this->iStatus = Order::STATUS_SHIPPED;
}
/**
* Attach an observer
*
* @param Observer_Interface $oObserver
* @return void
*/
public function attachObserver(Observer_Interface $oObserver)
{
$sHash = spl_object_hash($oObserver);
if (isset($this->aObservers[$sHash])) {
throw new Exception('Observer is already attached');
}
$this->aObservers[$sHash] = $oObserver;
}
/**
* Detach observer
*
* @param Observer_Interface $oObserver
* @return void
*/
public function detachObserver(Observer_Interface $oObserver)
{
$sHash = spl_object_hash($oObserver);
if (!isset($this->aObservers[$sHash])) {
throw new Exception('Observer not attached');
}
unset($this->aObservers[$sHash]);
}
/**
* Notify the attached observers
*
* @param string $sEvent, name of the event
* @param mixed $mData, optional data that is not directly available for the observers
* @return void
*/
public function notifyObserver($sEvent, $mData=null)
{
foreach ($this->aObservers as $oObserver) {
try {
$oObserver->update($this, $sEvent, $mData);
} catch(Exception $e) {
}
}
}
/**
* Add an order
*
* @param array $aOrder
* @return void
*/
public function add($aOrder = array())
{
$this->notifyObserver('onAdd');
}
/**
* Return the order reference number
*
* @return int
*/
public function getRef()
{
return $this->iOrderRef;
}
/**
* Return the current order status
*
* @return int
*/
public function getStatus()
{
return $this->iStatus;
}
/**
* Update the order status
*/
public function updateStatus($iStatus)
{
$this->notifyObserver('onBeforeUpdateStatus');
// ...
$this->iStatus = $iStatus;
// ...
$this->notifyObserver('onAfterUpdateStatus');
}
}
/**
* Order status handler, observer that sends an email to secretary
* if the status of an order changes from shipped to delivered, so the
* secratary can make a phone call to our customer to ask for his opinion about the service
*
* @package Shop
*/
class OrderStatusHandler implements Observer_Interface
{
protected $iPreviousOrderStatus;
protected $iCurrentOrderStatus;
/**
* Update, called by the observable object order
*
* @param Observable_Interface $oObservable
* @param string $sEvent
* @param mixed $mData
* @return void
*/
public function update(Observable_Interface $oObservable, $sEvent, $mData=null)
{
if(!$oObservable instanceof Order) {
return;
}
switch($sEvent) {
case 'onBeforeUpdateStatus':
$this->iPreviousOrderStatus = $oObservable->getStatus();
return;
case 'onAfterUpdateStatus':
$this->iCurrentOrderStatus = $oObservable->getStatus();
if($this->iPreviousOrderStatus === Order::STATUS_SHIPPED && $this->iCurrentOrderStatus === Order::STATUS_DELIVERED) {
$sSubject = sprintf('Order number %d is shipped', $oObservable->getRef());
//mail('secratary@example.com', 'Order number %d is shipped', 'Text');
echo 'Mail sended to the secratary to help her remember to call our customer for a survey.';
}
}
}
}
$oOrder = new Order(26012011);
$oOrder->attachObserver(new OrderStatusHandler());
$oOrder->updateStatus(Order::STATUS_DELIVERED);
$oOrder->add();
?>
Now we are able to take action on different events that occur.
Disadvantages
Although this implementation works quite well there are some drawbacks. One of those drawbacks is that we need to dispatch an event in our framework, if we don’t programmers can’t hook into our application. Triggering events everywhere give us a small performance penalty however I do think this way of working gives the programmers a nice way to hook into your application on those spots that you want them to hook in.
Just for the record
Notice that this code is just an example and can still use some improvements, for example: each observer is initialized even it will maybe never be notified, therefore I suggest to make use of lazy in some cases for loading the objects. There are other systems to hook into an application, more to follow!
Hello to every body, it’s my first visit of this
web site; this website contains remarkable and really excellent data
designed for visitors.
slot 777
28 Oct 25 at 12:00 am
купить номера виртуальные
MiguelActic
28 Oct 25 at 12:01 am
kraken ссылка
kraken сайт
Henryamerb
28 Oct 25 at 12:01 am
наркологическая служба [url=https://narkologicheskaya-klinika-25.ru]https://narkologicheskaya-klinika-25.ru[/url] .
narkologicheskaya klinika_apPl
28 Oct 25 at 12:02 am
kraken vk6
kraken onion
Henryamerb
28 Oct 25 at 12:02 am
buchmacher ausbildung
Also visit my webpage :: ausländische wettanbieter mit paypal
– Susanne,
Susanne
28 Oct 25 at 12:02 am
услуги гидроизоляции подвала [url=www.gidroizolyaciya-podvala-cena.ru/]www.gidroizolyaciya-podvala-cena.ru/[/url] .
gidroizolyaciya podvala cena_wxKt
28 Oct 25 at 12:02 am
J’ai un veritable coup de c?ur pour Sugar Casino, ca offre un plaisir vibrant. La selection de jeux est impressionnante, proposant des jeux de cartes elegants. Le bonus initial est super. Le suivi est impeccable. Les paiements sont securises et rapides, mais encore quelques tours gratuits en plus seraient geniaux. En conclusion, Sugar Casino offre une experience inoubliable. Notons egalement le site est rapide et engageant, permet une immersion complete. Un avantage le programme VIP avec des avantages uniques, garantit des paiements rapides.
Commencer ici|
vibeknightan1zef
28 Oct 25 at 12:03 am
Этап
Узнать больше – http://narkologicheskaya-klinika-klin8.ru/
MartyBak
28 Oct 25 at 12:03 am
купить диплом института [url=https://rudik-diplom12.ru]купить диплом института[/url] .
Diplomi_zaPi
28 Oct 25 at 12:05 am
медицинский наркологический центр [url=https://www.narkologicheskaya-klinika-25.ru]https://www.narkologicheskaya-klinika-25.ru[/url] .
narkologicheskaya klinika_khPl
28 Oct 25 at 12:07 am
кракен маркетплейс
кракен клиент
Henryamerb
28 Oct 25 at 12:07 am
наркологическая клиника город [url=http://narkologicheskaya-klinika-25.ru]http://narkologicheskaya-klinika-25.ru[/url] .
narkologicheskaya klinika_fmPl
28 Oct 25 at 12:12 am
minimal kreatif kontol
minimal kreatif kontol
28 Oct 25 at 12:12 am
Автоматические выключатели
JulioGer
28 Oct 25 at 12:13 am
наркологические услуги в москве [url=https://narkologicheskaya-klinika-28.ru]https://narkologicheskaya-klinika-28.ru[/url] .
narkologicheskaya klinika_rkMa
28 Oct 25 at 12:13 am
кракен вход
кракен онион
Henryamerb
28 Oct 25 at 12:14 am
наркологические клиники москва [url=https://narkologicheskaya-klinika-25.ru]наркологические клиники москва[/url] .
narkologicheskaya klinika_wyPl
28 Oct 25 at 12:14 am
медицинский наркологический центр [url=narkologicheskaya-klinika-28.ru]медицинский наркологический центр[/url] .
narkologicheskaya klinika_cgMa
28 Oct 25 at 12:15 am
The staff at 수원토닥이 are kind, skilled, and professional.
suwon.clickn.co.kr
28 Oct 25 at 12:17 am
купить диплом в волжском [url=www.rudik-diplom12.ru/]купить диплом в волжском[/url] .
Diplomi_hgPi
28 Oct 25 at 12:17 am
байк Регистратор: Твой свидетель в спорной ситуации.
WilliamTut
28 Oct 25 at 12:18 am
прием смс
MiguelActic
28 Oct 25 at 12:19 am
купить диплом стоматолога [url=rudik-diplom1.ru]купить диплом стоматолога[/url] .
Diplomi_gcer
28 Oct 25 at 12:20 am
https://t.me/s/bs_1Win/427
Georgerah
28 Oct 25 at 12:21 am
Pretty! This was an extremely wonderful post.
Many thanks for supplying these details.
https://www.kaskus.co.id/redirect?url=https://www.rmcaudiodirect.com/products.html
28 Oct 25 at 12:21 am
кракен официальный сайт
kraken онлайн
Henryamerb
28 Oct 25 at 12:22 am
наркологическая платная клиника [url=https://www.narkologicheskaya-klinika-25.ru]https://www.narkologicheskaya-klinika-25.ru[/url] .
narkologicheskaya klinika_lvPl
28 Oct 25 at 12:22 am
kraken vk6
kraken darknet market
Henryamerb
28 Oct 25 at 12:23 am
сколько стоит купить диплом медсестры [url=www.frei-diplom15.ru]сколько стоит купить диплом медсестры[/url] .
Diplomi_dzoi
28 Oct 25 at 12:23 am
https://t.me/bs_1Win/1170
Georgerah
28 Oct 25 at 12:23 am
ремонт в подвале [url=gidroizolyaciya-podvala-cena.ru]gidroizolyaciya-podvala-cena.ru[/url] .
gidroizolyaciya podvala cena_coKt
28 Oct 25 at 12:24 am
Ich bin absolut begeistert von Cat Spins Casino, es sorgt fur ein fesselndes Erlebnis. Das Angebot an Titeln ist riesig, inklusive dynamischer Sportwetten. Mit einfachen Einzahlungen. Der Support ist effizient und professionell. Auszahlungen sind blitzschnell, in seltenen Fallen ein paar zusatzliche Freispiele waren klasse. Insgesamt, Cat Spins Casino sorgt fur ununterbrochenen Spa?. Daruber hinaus die Plattform ist visuell ansprechend, zum Weiterspielen animiert. Ein tolles Extra die lebendigen Community-Events, schnelle Zahlungen garantieren.
Mehr entdecken|
SolarRiderik3zef
28 Oct 25 at 12:25 am
сырость в подвале многоквартирного дома [url=https://gidroizolyaciya-cena-8.ru/]https://gidroizolyaciya-cena-8.ru/[/url] .
gidroizolyaciya cena_wdKn
28 Oct 25 at 12:25 am
Круглосуточная наркологическая помощь — это не громкая вывеска, а чётко выстроенная логистика, где каждый шаг измерим и объясним. В клинике «УралМед Трезвость» мы работаем по принципу «одна цель — один клинический шаг — одно окно оценки», чтобы исключить полипрагмазию и сохранить прогнозируемость результатов. Выездные бригады прибывают без маркировки, используют компактное оборудование и поддерживают спокойную коммуникацию: только факты, никакой стигмы и давления. Такой формат минимизирует тревогу пациента и близких, а также снижает риск срывов за счёт последовательной, поэтапной стабилизации.
Детальнее – [url=https://narkologicheskaya-klinika-v-chelyabinske16.ru/]наркологическая клиника наркологический центр[/url]
Jamesbah
28 Oct 25 at 12:25 am
Ich habe eine Leidenschaft fur Cat Spins Casino, es ist ein Hotspot fur Spielspa?. Es gibt unzahlige packende Spiele, mit modernen Slots in ansprechenden Designs. Mit einfachen Einzahlungen. Der Kundendienst ist hervorragend. Gewinne kommen sofort an, von Zeit zu Zeit gro?zugigere Angebote waren klasse. Kurz gesagt, Cat Spins Casino bietet ein unvergessliches Erlebnis. Zudem die Seite ist schnell und einladend, und ladt zum Verweilen ein. Ein gro?es Plus die zahlreichen Sportwetten-Moglichkeiten, die die Community enger zusammenschwei?en.
Jetzt entdecken|
StarHeartix8zef
28 Oct 25 at 12:26 am
Иногда домашний маршрут лишь создаёт иллюзию экономии времени. Если есть спутанность сознания, выраженная дезориентация, галлюцинации, повторные судороги, нестабильное давление, сильная одышка или неукротимая рвота с обезвоживанием, безопаснее начинать в стационаре. Там рядом диагностика и пост 24/7, любое решение принимается сразу, а коррекция схемы не упирается в бытовые ограничения квартиры.
Детальнее – [url=https://narkologicheskaya-klinika-voskresensk8.ru/]narkologicheskaya-klinika-dispanser[/url]
Joshuaboype
28 Oct 25 at 12:26 am
купить диплом программиста [url=https://rudik-diplom1.ru]купить диплом программиста[/url] .
Diplomi_ther
28 Oct 25 at 12:27 am
кракен vk6
kraken обмен
Henryamerb
28 Oct 25 at 12:27 am
В первые два часа после прибытия бригады важно не «сделать побольше», а принять наименьшее количество решений, которое реально меняет картину. Команда фиксирует базовую линию (ЧСС, АД, SpO?, температура, шкала тошноты/тремора), даёт антиеметический мост и запускает регидратацию. При тахикардии — добавляет антивегетативный контур. Семья получает сценарий ночи: когда приглушить свет, когда предложить воду, какие цифры на тонометре считать нормой и при каких — звонить. Такой протокол экономит время и силы, а главное — превращает вечер из хаотичного в управляемый, снижая риск ночных экстренных вызовов и «эмоциональных качелей».
Подробнее – [url=https://kapelnicza-ot-zapoya-v-chelyabinske16.ru/]вызвать капельницу от запоя[/url]
Craigtic
28 Oct 25 at 12:28 am
клиники наркологические москва [url=narkologicheskaya-klinika-28.ru]narkologicheskaya-klinika-28.ru[/url] .
narkologicheskaya klinika_viMa
28 Oct 25 at 12:28 am
https://mannvital.shop/# MannVital
GregoryJes
28 Oct 25 at 12:30 am
Наркологическая клиника в клинике в Нижнем Новгороде специализируется на диагностике, лечении и реабилитации пациентов с алкогольной и наркотической зависимостью. Основная цель деятельности учреждения — восстановление физического здоровья и психологической устойчивости человека, оказавшегося в состоянии зависимости. В клинике применяются современные методы терапии, доказавшие эффективность в медицинской практике. Все процедуры проводятся конфиденциально, с соблюдением медицинских стандартов и под контролем квалифицированных специалистов.
Получить дополнительную информацию – https://narkologicheskaya-clinika-v-nizhnem-novgorode16.ru/
Nicolascruby
28 Oct 25 at 12:31 am
клиника наркологическая [url=http://www.narkologicheskaya-klinika-25.ru]клиника наркологическая[/url] .
narkologicheskaya klinika_miPl
28 Oct 25 at 12:31 am
где купить диплом образование [url=https://www.rudik-diplom1.ru]где купить диплом образование[/url] .
Diplomi_ever
28 Oct 25 at 12:31 am
wett strategien
Feel free to surf to my blog Sportwetten Bonus Ohne Einzahlung Bestandskunden
Sportwetten Bonus Ohne Einzahlung Bestandskunden
28 Oct 25 at 12:31 am
купить диплом в новочебоксарске [url=https://www.rudik-diplom12.ru]https://www.rudik-diplom12.ru[/url] .
Diplomi_mnPi
28 Oct 25 at 12:32 am
вирт сим
MiguelActic
28 Oct 25 at 12:33 am
Ich bin vollig uberzeugt von Cat Spins Casino, es ist ein Hotspot fur Spielspa?. Die Spielauswahl ist beeindruckend, mit aufregenden Live-Casino-Erlebnissen. Er steigert das Spielvergnugen sofort. Der Support ist schnell und freundlich. Gewinne kommen sofort an, von Zeit zu Zeit ein paar zusatzliche Freispiele waren klasse. Kurz und bundig, Cat Spins Casino ist perfekt fur Casino-Liebhaber. Zusatzlich die Seite ist schnell und ansprechend, eine vollstandige Eintauchen ermoglicht. Ein gro?es Plus ist das VIP-Programm mit besonderen Vorteilen, regelma?ige Boni bieten.
Mehr sehen|
omegaqueenan2zef
28 Oct 25 at 12:34 am
kraken vk2
kraken darknet market
Henryamerb
28 Oct 25 at 12:34 am