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!
Одним из ключевых аспектов является определение стадии зависимости, что можно подробнее изучить на официальном портале Министерства здравоохранения РФ. Там представлена актуальная информация о современных стандартах диагностики и лечения.
Ознакомиться с деталями – https://narkologicheskaya-klinika-krasnodar0.ru/chastnaya-narkologicheskaya-klinika-v-krasnodare/
ThomasIdeaf
19 Jul 25 at 3:48 pm
MediMexicoRx: tadalafil mexico pharmacy – MediMexicoRx
LewisSoump
19 Jul 25 at 3:48 pm
купить диплом с занесением реестра [url=http://arus-diplom35.ru/]купить диплом с занесением реестра[/url] .
Diplomi_hkOn
19 Jul 25 at 3:50 pm
вывод из запоя
vivod-iz-zapoya-kaluga005.ru
лечение запоя калуга
alkogolizmkalugaNeT
19 Jul 25 at 3:50 pm
Because the admin of this website is working, no uncertainty very shortly it will be
well-known, due to its quality contents.
quickratey.com
19 Jul 25 at 3:55 pm
онлайн оценка дорогих часов [url=https://ocenka-chasov-onlajn9.ru/]ocenka-chasov-onlajn9.ru[/url] .
ocenka chasov onlain_ujMn
19 Jul 25 at 3:59 pm
https://expresscarerx.online/# health rx pharmacy
RobertEmard
19 Jul 25 at 3:59 pm
лестницы на второй этаж на заказ [url=lestnicy-na-metallokarkase-4.ru]лестницы на второй этаж на заказ[/url] .
lestnici na metallokarkase_qoPr
19 Jul 25 at 3:59 pm
После вашего звонка диспетчер фиксирует заявку и передаёт её свободному специалисту. Нарколог связывается для уточнения симптомов, времени начала запоя и наличия сопутствующих заболеваний, чтобы привезти нужные препараты.
Исследовать вопрос подробнее – [url=https://kapelnica-ot-zapoya-voronezh.ru/]kapelnicza-ot-zapoya-na-domu voronezh[/url]
Patricktip
19 Jul 25 at 4:05 pm
Excellent beat ! I wish to apprentice while you amend your web site,
how could i subscribe for a blog site? The
account aided me a acceptable deal. I had been a little bit acquainted of this your broadcast provided bright
clear idea
Fake designer bags
19 Jul 25 at 4:09 pm
https://gidro-vanna-dush.ru
Lesteretedy
19 Jul 25 at 4:10 pm
построить дом в области [url=http://www.stroitelstvo-doma-1.ru]построить дом в области[/url] .
stroitelstvo doma_gjsn
19 Jul 25 at 4:11 pm
купить диплом занесенный в реестр [url=https://www.arus-diplom35.ru]купить диплом занесенный в реестр[/url] .
Diplomi_edOn
19 Jul 25 at 4:12 pm
mostbet sport [url=https://mostbet4073.ru/]mostbet sport[/url]
mostbet_bsot
19 Jul 25 at 4:22 pm
дом для проживания под ключ [url=https://www.stroitelstvo-doma-1.ru]дом для проживания под ключ[/url] .
stroitelstvo doma_rwsn
19 Jul 25 at 4:24 pm
частный пансионат для пожилых людей
pansionat-tula002.ru
пансионат для лежачих пожилых
narkologiyakrasnodarNeT
19 Jul 25 at 4:27 pm
диплом настоящий купить с занесением в реестр [url=https://www.arus-diplom32.ru]https://www.arus-diplom32.ru[/url] .
Diplomi_bmpi
19 Jul 25 at 4:31 pm
строительство дома под ключ область [url=www.stroitelstvo-doma-1.ru/]строительство дома под ключ область[/url] .
stroitelstvo doma_fisn
19 Jul 25 at 4:31 pm
melbet mobile [url=melbet3004.com]melbet mobile[/url]
melbet_cvMt
19 Jul 25 at 4:32 pm
Стандартная процедура включает внутривенное введение растворов, которые эффективно выводят токсины, восстанавливают электролитный баланс и устраняют обезвоживание. Дополнительно врач назначает медикаменты для защиты сердца, печени и нервной системы, а также, при необходимости, седативные препараты для стабилизации психического состояния.
Получить больше информации – http://kapelnica-ot-zapoya-moskva00.ru/kapelnicza-ot-zapoya-czena-msk/
JeremySIP
19 Jul 25 at 4:36 pm
Как подчёркивает заведующая отделением клинической психологии ФГБУН «НМИЦ психиатрии и наркологии» Минздрава России, наличие в команде специалистов с опытом работы в области зависимости — это основа качественной помощи.
Углубиться в тему – https://narkologicheskaya-klinika-nizhnij-tagil11.ru/narkologicheskaya-klinika-telefon-v-nizhnem-tagile
Keithgek
19 Jul 25 at 4:36 pm
cheapest online pharmacy india [url=http://indiamedshub.com/#]reputable indian online pharmacy[/url] world pharmacy india
DavidRhinc
19 Jul 25 at 4:38 pm
Проблема зависимости от алкоголя, наркотиков и азартных игр остается одной из наиболее острых в современном обществе. Эти состояния оказывают значительное воздействие не только на здоровье самого человека, но и на его семью, друзей и общественные связи. Наркологическая клиника “Восстановление души” предлагает широкий спектр услуг для тех, кто борется с различными формами зависимости, такими как алкоголизм, наркомания и игромания. Наша цель — предоставить комплексный подход к лечению, что обеспечивает высокие показатели успешности среди наших пациентов.
Исследовать вопрос подробнее – [url=https://kapelnica-ot-zapoya-irkutsk2.ru/]вызвать капельницу от запоя на дому иркутск[/url]
GarlandVop
19 Jul 25 at 4:40 pm
купить диплом с проводкой одно [url=https://arus-diplom35.ru]купить диплом с проводкой одно[/url] .
Diplomi_hsOn
19 Jul 25 at 4:44 pm
Awesome breakdown, Ryan! Scalping definitely requires the
fastest execution and tightest spreads, and it’s great
to see brokers like IG and IC Markets leading the pack in 2025.
I’ve tried a few platforms, but the smart
routing on Interactive Brokers sounds like a game-changer for quick trades.
Thanks for the detailed review — can’t wait to test
out some of these brokers on demo accounts!
best forex broker for scalping
19 Jul 25 at 4:45 pm
онлайн оценка часов по фото для скупки [url=https://ocenka-chasov-onlajn8.ru/]ocenka-chasov-onlajn8.ru[/url] .
ocenka chasov onlain_zbKt
19 Jul 25 at 4:46 pm
Острая алкогольная интоксикация — запой — может привести к серьёзным осложнениям: дегидратации, сбою сердечного ритма, ухудшению функций печени и почек. Клиника «ВоронежДоктор» предлагает инфузионную терапию на дому и в условиях стационара с полным соблюдением анонимности. Опытные специалисты проводят детоксикацию по индивидуальной программе, используя современные растворы и аппаратуру, что позволяет максимально быстро и безопасно вернуть пациента к нормальной жизни.
Ознакомиться с деталями – https://kapelnica-ot-zapoya-voronezh2.ru/
JerryRag
19 Jul 25 at 4:47 pm
дома под ключ москва области [url=https://stroitelstvo-doma-1.ru/]дома под ключ москва области[/url] .
stroitelstvo doma_lxsn
19 Jul 25 at 4:49 pm
построить дом с отделкой под ключ цена [url=stroitelstvo-doma-1.ru]построить дом с отделкой под ключ цена[/url] .
stroitelstvo doma_knsn
19 Jul 25 at 5:01 pm
Mega onion
RichardPep
19 Jul 25 at 5:02 pm
Во-первых, мы фокусируемся на медицинской детоксикации, которая является первоочередной задачей при лечении зависимостей. Этот процесс позволяет удалить токсические вещества из организма и улучшить общее состояние пациента. Мы применяем современные методики, которые помогают минимизировать симптомы абстиненции и обеспечить комфортное пребывание в клинике.
Выяснить больше – [url=https://kapelnica-ot-zapoya-irkutsk.ru/]вызвать капельницу от запоя[/url]
Josephshoow
19 Jul 25 at 5:04 pm
вывод из запоя цена
vivod-iz-zapoya-kaluga005.ru
вывод из запоя круглосуточно калуга
vivodzapojkalugaNeT
19 Jul 25 at 5:07 pm
«СочиМед» предлагает комплексный подход: диагностика, детоксикация, терапия сопутствующих состояний, психологическая и социальная поддержка. В стационаре доступны:
Подробнее можно узнать тут – [url=https://narkologicheskaya-klinika-sochi00.ru/]бесплатная наркологическая клиника сочи[/url]
MichaelCrumn
19 Jul 25 at 5:08 pm
Hi there I am so happy I found your website, I really found you by error, while I was looking on Google for
something else, Anyhow I am here now and would just like to say many thanks for a fantastic post and a
all round entertaining blog (I also love the theme/design), I don’t have time to go through it all at the minute
but I have saved it and also included your RSS feeds, so when I have time I will
be back to read a lot more, Please do keep up the superb jo.
Адвокатская консультация в Красногвардейском и Невском районе СПБ
19 Jul 25 at 5:15 pm
В клинике применяются разнообразные психотерапевтические техники, позволяющие адаптировать лечение под индивидуальные особенности пациента.
Получить больше информации – http://
WilliamToort
19 Jul 25 at 5:16 pm
Психолог оценили 6567 раз
Психолог
19 Jul 25 at 5:19 pm
строительство дома без ипотеки [url=https://www.stroitelstvo-doma-1.ru]строительство дома без ипотеки[/url] .
stroitelstvo doma_lksn
19 Jul 25 at 5:21 pm
Дополнительно выясняются аллергические реакции, приём других препаратов и предпочтения пациента по времени визита врача.
Детальнее – [url=https://kapelnica-ot-zapoya-voronezh3.ru/]капельница от запоя[/url]
RobertThons
19 Jul 25 at 5:26 pm
Whoa! This blog looks just like my old one! It’s on a completely different subject but it has pretty much the same layout and design. Superb choice of colors!
tahitian中文
19 Jul 25 at 5:27 pm
можно ли купить аттестат за 11 [url=https://arus-diplom25.ru]https://arus-diplom25.ru[/url] .
Diplomi_tpot
19 Jul 25 at 5:31 pm
I loved as much as you’ll receive carried out right here.
The sketch is attractive, your authored material stylish.
nonetheless, you command get got an edginess over that
you wish be delivering the following. unwell unquestionably
come more formerly again since exactly the same nearly very often inside case you shield this increase.
окна для дачи цены
19 Jul 25 at 5:32 pm
Основной этап, направленный на очищение организма от продуктов распада алкоголя и нормализацию функций внутренних органов. Применяются современные препараты с антиоксидантным и гепатопротекторным эффектом.
Подробнее можно узнать тут – http://lechenie-alkogolizma-krasnodar0.ru
DonaldWrava
19 Jul 25 at 5:33 pm
кракен android
DavidFoogs
19 Jul 25 at 5:38 pm
usa sms bomber
GerardobaR
19 Jul 25 at 5:45 pm
С психологом онлайн вы найдете выход из кризиса. Детский психолог онлайн поможет в адаптации к детсаду.
ваш психолог онлайн
Ernestpoive
19 Jul 25 at 5:48 pm
Наткнулся на полезную статью, думаю, вам тоже пригодится:
Зацепил материал про detoxa.ru.
Вот, делюсь ссылкой:
[url=https://detoxa.ru]https://detoxa.ru[/url]
Буду признателен за ваши отзывы.
rusPoito
19 Jul 25 at 5:50 pm
купить аттестат за 11 класс в казахстане [url=https://www.arus-diplom25.ru]купить аттестат за 11 класс в казахстане[/url] .
Diplomi_vdot
19 Jul 25 at 5:51 pm
mostbet indir android [url=http://island-hvar.info]mostbet indir android[/url] .
mostbet apk_gmPi
19 Jul 25 at 5:56 pm
ExpressCareRx [url=https://expresscarerx.org/#]ExpressCareRx[/url] non prescription cialis online pharmacy
DavidRhinc
19 Jul 25 at 5:57 pm
Системы автоматизированного дозирования обеспечивают точное введение медикаментов, что минимизирует риск побочных эффектов. Постоянный мониторинг жизненно важных показателей позволяет врачу корректировать терапию в режиме реального времени, гарантируя безопасность процедуры.
Подробнее тут – [url=https://vyvod-iz-zapoya-vladimir0.ru/]вывод из запоя цена владимир[/url]
TerryAcith
19 Jul 25 at 5:58 pm