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!
букмекерская контора melbet [url=http://melbetbonusy.ru]букмекерская контора melbet[/url] .
melbet_bxOi
19 Oct 25 at 10:36 pm
Промо-код 1xBet — укажите его в специальное поле при создании аккаунта, депозитируйте свой игровой баланс на сумму от 100 рублей и воспользуйтесь предложением в размере 100 процентов (до 32 500?). В меню игрока перейдите в раздел «Акции» и выберите вариант «Ввести код». Вставьте полученный бонусный код в нужное поле. Подтвердите ввод и прочитайте правила бонуса.Актуальный промокод 1xBet 2026 можно узнать по ссылке — http://www.vlaje.ru/obuv/pages/1xbet_promokod_pri_registracii_na_segodnya_besplatno.html.
Jamesslurn
19 Oct 25 at 10:36 pm
To conclude, recognizing the details of market characteristics, utilizing durable trading strategies, and taking into consideration emotional and emotional aspects are vital for
anyone wanting to be successful in the trading globe.
The convergence of conventional market evaluation with contemporary innovation gives an unmatched possibility for growth and
productivity. By leveraging tools like the CFD Global app,
making use of online academic sources, and remaining
educated about vital financial indications such as non-farm payroll records, traders
can boost their decision-making procedures and take advantage of market opportunities.
The monetary landscape will certainly continue to advance, and remaining abreast of these
adjustments while growing sound trading methods might well be the course to success
in both the forex and wider markets. The trip may be challenging, however with the right tools, knowledge,
and frame of mind, investors can navigate the complexities of the
economic world and grow in the middle of its ever-shifting trends.
ماركت
19 Oct 25 at 10:37 pm
Fortunica’s Lightning
Roulette is my go-to game. The multipliers make it so exciting!
fortunica
19 Oct 25 at 10:40 pm
https://pilloleverdi.com/# tadalafil senza ricetta
MickeySum
19 Oct 25 at 10:41 pm
медицинские аппараты [url=http://www.xn—-7sbcejdfbbzea0axlidbbn0a0b5a8f.xn--p1ai]http://www.xn—-7sbcejdfbbzea0axlidbbn0a0b5a8f.xn--p1ai[/url] .
oborydovanie medicinskoe_wysi
19 Oct 25 at 10:42 pm
где купить диплом техникума дипломы тумен кипятком [url=https://www.frei-diplom8.ru]где купить диплом техникума дипломы тумен кипятком[/url] .
Diplomi_bxsr
19 Oct 25 at 10:43 pm
1win uz [url=https://1win5509.ru]1win uz[/url]
1win_uz_ahKt
19 Oct 25 at 10:44 pm
наркологическая клиника трезвый выбор [url=narkologicheskaya-klinika-19.ru]narkologicheskaya-klinika-19.ru[/url] .
narkologicheskaya klinika _hami
19 Oct 25 at 10:45 pm
bestdealcorner.cfd – I appreciate the variety, something for everyone in this store.
Francisca Norviel
19 Oct 25 at 10:46 pm
купить диплом с занесением в реестр казань [url=www.frei-diplom2.ru/]www.frei-diplom2.ru/[/url] .
Diplomi_nxEa
19 Oct 25 at 10:47 pm
мелбет бонусы [url=www.melbetbonusy.ru/]мелбет бонусы[/url] .
melbet_fhOi
19 Oct 25 at 10:48 pm
1win tennis tikish [url=1win5509.ru]1win5509.ru[/url]
1win_uz_lqKt
19 Oct 25 at 10:48 pm
TG @‌LINKS_DEALER | EFFECTIVE SEO LINKS FOR spinbetter.bet
CharlesTHOTH
19 Oct 25 at 10:48 pm
В Краснодаре клиника «Детокс» предоставляет услугу вызова нарколога на дом. Специалисты приедут к вам в течение 1–2 часов, проведут осмотр и назначат необходимое лечение. Все процедуры проводятся анонимно и с соблюдением конфиденциальности.
Ознакомиться с деталями – [url=https://narkolog-na-dom-krasnodar26.ru/]платный нарколог на дом краснодар[/url]
DanielCaupe
19 Oct 25 at 10:49 pm
1вин вывести деньги [url=1win5509.ru]1win5509.ru[/url]
1win_uz_saKt
19 Oct 25 at 10:49 pm
купить диплом в бердске [url=www.rudik-diplom7.ru]www.rudik-diplom7.ru[/url] .
Diplomi_fbPl
19 Oct 25 at 10:51 pm
купить диплом в верхней пышме [url=https://www.rudik-diplom9.ru]купить диплом в верхней пышме[/url] .
Diplomi_pvei
19 Oct 25 at 10:52 pm
Turn your cleaning into a game with Roomsy. A cozy way to clean your home with Roomsy. https://getroomsy.com/ Roomsy offers a simple, guided checklist that organizes chores and makes keeping a tidy home feel effortless. Adorable virtual pet companion. Your pet lives in a tiny version of your home and joins you during cleaning sessions to make tidying more fun and engaging. Turn everyday cleaning into a rewarding experience by leveling up rooms and watching your virtual pet get happier as your space gets cleaner.
gekuhulep
19 Oct 25 at 10:52 pm
мелбет депозит [url=www.melbetbonusy.ru/]мелбет депозит[/url] .
melbet_kpOi
19 Oct 25 at 10:56 pm
buy generic tetracycline no prescription
tetracycline buy online uk
19 Oct 25 at 10:57 pm
В Воронеже клиника помогает стабилизировать состояние и восстановить здоровье после запоя.
Получить больше информации – [url=https://vyvod-iz-zapoya-v-stacionare-voronezh22.ru/]быстрый вывод из запоя в стационаре в воронеже[/url]
RichardJuids
19 Oct 25 at 10:57 pm
В стационаре «Частного Медика?24» пациент получает комплексное лечение, включая капельницы и медикаменты.
Детальнее – [url=https://vyvod-iz-zapoya-v-stacionare-voronezh24.ru/]наркология вывод из запоя в стационаре воронеж[/url]
Stuartbooms
19 Oct 25 at 10:59 pm
Капельница от запоя в Нижнем Новгороде — процедура, включающая физраствор, глюкозу, витамины и седативные препараты. Она помогает восстановить водно-электролитный баланс и улучшить самочувствие.
Узнать больше – [url=https://vyvod-iz-zapoya-nizhnij-novgorod11.ru/]врач вывод из запоя[/url]
TerrellOwelf
19 Oct 25 at 11:01 pm
Начнем путешествие по магическим уголкам российских заповедников.
Хочу выделить материал про Изучение ООПТ России: парки, заповедники, водоемы.
Ссылка ниже:
[url=https://alloopt.ru]https://alloopt.ru[/url]
Жду ваших отзывов и вопросов по теме.
fixRow
19 Oct 25 at 11:03 pm
http://intimisante.com/# cialis prix
MickeySum
19 Oct 25 at 11:03 pm
поставка медоборудования [url=https://www.xn—-7sbcejdfbbzea0axlidbbn0a0b5a8f.xn--p1ai]https://www.xn—-7sbcejdfbbzea0axlidbbn0a0b5a8f.xn--p1ai[/url] .
oborydovanie medicinskoe_qosi
19 Oct 25 at 11:05 pm
купить диплом о среднем специальном [url=www.rudik-diplom7.ru/]купить диплом о среднем специальном[/url] .
Diplomi_glPl
19 Oct 25 at 11:05 pm
melbet букмекерская [url=https://www.melbetbonusy.ru]melbet букмекерская[/url] .
melbet_gjOi
19 Oct 25 at 11:06 pm
Potenz Vital [url=https://potenzvital.shop/#]Cialis generika günstig kaufen[/url] Cialis Preisvergleich Deutschland
GeorgeHot
19 Oct 25 at 11:06 pm
наркологическая клиника trezviy vibor [url=narkologicheskaya-klinika-19.ru]narkologicheskaya-klinika-19.ru[/url] .
narkologicheskaya klinika _pzmi
19 Oct 25 at 11:07 pm
поставщик медоборудования [url=www.medtehnika-msk.ru]www.medtehnika-msk.ru[/url] .
oborydovanie medicinskoe_tppa
19 Oct 25 at 11:08 pm
1win karta orqali depozit [url=www.1win5510.ru]www.1win5510.ru[/url]
1win_uz_nzsi
19 Oct 25 at 11:09 pm
unityandprogress.bond – The content feels authentic and supports our goals of together-progress.
Bao Villines
19 Oct 25 at 11:09 pm
оборудование медицинское [url=xn—-7sbcejdfbbzea0axlidbbn0a0b5a8f.xn--p1ai]оборудование медицинское[/url] .
oborydovanie medicinskoe_nosi
19 Oct 25 at 11:10 pm
купить диплом в когалыме [url=https://www.rudik-diplom6.ru]https://www.rudik-diplom6.ru[/url] .
Diplomi_upKr
19 Oct 25 at 11:10 pm
cd alarm [url=www.alarm-radio-clocks.com/]www.alarm-radio-clocks.com/[/url] .
Cd Player Radio Alarm Clocks_suOa
19 Oct 25 at 11:11 pm
трезвая жизнь [url=https://narkologicheskaya-klinika-19.ru/]https://narkologicheskaya-klinika-19.ru/[/url] .
narkologicheskaya klinika _vlmi
19 Oct 25 at 11:12 pm
где заказать проект перепланировки квартиры [url=www.proekt-pereplanirovki-kvartiry11.ru]где заказать проект перепланировки квартиры[/url] .
proekt pereplanirovki kvartiri_ekot
19 Oct 25 at 11:16 pm
wettbüro berlin reinickendorf
my web page sportwetten anbieter schweiz
sportwetten anbieter schweiz
19 Oct 25 at 11:16 pm
1win mobil versiyasi uz [url=www.1win5509.ru]www.1win5509.ru[/url]
1win_uz_sfKt
19 Oct 25 at 11:17 pm
Diving into Minotaurus token details, the 60% presale allocation ensures fair launch. Vesting up to 14 months with 10% bonuses? That’s holder-friendly. Game’s endless runner vibe is pure fun.
minotaurus token
WilliamPargy
19 Oct 25 at 11:19 pm
Если вы ищете надежную клинику для вывода из запоя, обратитесь в «Детокс» в Краснодаре. Услуга вызова нарколога на дом доступна круглосуточно. Врачи приедут к вам в течение 1–2 часов и окажут необходимую помощь.
Выяснить больше – [url=https://narkolog-na-dom-krasnodar25.ru/]запой нарколог на дом в краснодаре[/url]
JamieOvedy
19 Oct 25 at 11:21 pm
купить свидетельство о браке [url=rudik-diplom15.ru]купить свидетельство о браке[/url] .
Diplomi_uuPi
19 Oct 25 at 11:22 pm
мелбет фрибеты [url=melbetbonusy.ru]мелбет фрибеты[/url] .
melbet_nmOi
19 Oct 25 at 11:22 pm
1вин обман или нет [url=www.1win5509.ru]1вин обман или нет[/url]
1win_uz_wzKt
19 Oct 25 at 11:24 pm
купить диплом в кропоткине [url=https://rudik-diplom6.ru/]https://rudik-diplom6.ru/[/url] .
Diplomi_dzKr
19 Oct 25 at 11:25 pm
1win app promo bilan [url=http://1win5510.ru]1win app promo bilan[/url]
1win_uz_txsi
19 Oct 25 at 11:25 pm
foot africain pronostics du foot
parifoot-afrique-28
19 Oct 25 at 11:26 pm
What’s up to all, it’s really a good for me to pay a quick visit this
web page, it consists of valuable Information.
kids clothing manufacturer
19 Oct 25 at 11:27 pm