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!
частный seo оптимизатор [url=http://www.optimizaciya-i-seo-prodvizhenie-sajtov-moskva.ru]частный seo оптимизатор[/url] .
optimizaciya i seo prodvijenie saitov moskva_izel
29 Oct 25 at 2:31 am
топ digital компаний россии [url=http://luchshie-digital-agencstva.ru/]http://luchshie-digital-agencstva.ru/[/url] .
lychshie digital agentstva_njoi
29 Oct 25 at 2:32 am
букмекерская контора мелбет сайт [url=https://melbetofficialsite.ru/]букмекерская контора мелбет сайт[/url] .
bk melbet_rdEa
29 Oct 25 at 2:32 am
торкретирование цена [url=http://www.torkretirovanie-1.ru]торкретирование цена[/url] .
torkretirovanie_njen
29 Oct 25 at 2:33 am
acquistare Spedra online: Spedra – FarmaciaViva
RichardImmon
29 Oct 25 at 2:33 am
материалы по маркетингу [url=statyi-o-marketinge7.ru]statyi-o-marketinge7.ru[/url] .
stati o marketinge _hwkl
29 Oct 25 at 2:34 am
radio alarm clock phone combo [url=https://www.alarm-radio-clocks.com]https://www.alarm-radio-clocks.com[/url] .
Cd Player Radio Alarm Clocks_daOa
29 Oct 25 at 2:34 am
наплавляемая гидроизоляция цена за м2 работа [url=http://www.gidroizolyaciya-cena-8.ru]http://www.gidroizolyaciya-cena-8.ru[/url] .
gidroizolyaciya cena_kvKn
29 Oct 25 at 2:37 am
кракен vpn
kraken зеркало
Henryamerb
29 Oct 25 at 2:38 am
маркетинг в интернете блог [url=www.statyi-o-marketinge6.ru]www.statyi-o-marketinge6.ru[/url] .
stati o marketinge _crkn
29 Oct 25 at 2:38 am
кракен 2025
кракен
Henryamerb
29 Oct 25 at 2:38 am
findjoyeveryday.shop – Colors and designs are cheerful, items feel unique and fresh.
Robt Gloyd
29 Oct 25 at 2:39 am
букмекерская контора мелбет [url=www.melbetofficialsite.ru/]букмекерская контора мелбет[/url] .
bk melbet_jpEa
29 Oct 25 at 2:40 am
торкретирование стен цена за м2 [url=www.torkretirovanie-1.ru]www.torkretirovanie-1.ru[/url] .
torkretirovanie_cben
29 Oct 25 at 2:42 am
digital маркетинг блог [url=https://statyi-o-marketinge7.ru/]https://statyi-o-marketinge7.ru/[/url] .
stati o marketinge _iokl
29 Oct 25 at 2:43 am
kraken ios
kraken ios
Henryamerb
29 Oct 25 at 2:43 am
сделать аудит сайта цена [url=http://www.optimizaciya-i-seo-prodvizhenie-sajtov-moskva.ru]http://www.optimizaciya-i-seo-prodvizhenie-sajtov-moskva.ru[/url] .
optimizaciya i seo prodvijenie saitov moskva_voel
29 Oct 25 at 2:43 am
best clock radio cd player [url=https://alarm-radio-clocks.com/]https://alarm-radio-clocks.com/[/url] .
Cd Player Radio Alarm Clocks_irOa
29 Oct 25 at 2:43 am
Wisebusiness’s website
PHP hook, building hooks in your application – Sjoerd Maessen blog at Sjoerd Maessen blog
Wisebusiness's website
29 Oct 25 at 2:44 am
литокол гидроизоляция цена [url=http://www.gidroizolyaciya-cena-8.ru]http://www.gidroizolyaciya-cena-8.ru[/url] .
gidroizolyaciya cena_qqKn
29 Oct 25 at 2:45 am
гидроизоляция цена [url=https://gidroizolyaciya-cena-8.ru/]гидроизоляция цена[/url] .
gidroizolyaciya cena_otKn
29 Oct 25 at 2:46 am
маркетинговые стратегии статьи [url=https://statyi-o-marketinge6.ru]маркетинговые стратегии статьи[/url] .
stati o marketinge _cokn
29 Oct 25 at 2:47 am
Госпитализация разворачивается как последовательность шагов: приём и допуск к терапии, старт инфузий, мониторинг 24/7, регулярная переоценка и подготовка к выписке. Такой контур особенно важен пациентам с сопутствующими диагнозами (гипертония, ИБС, сахарный диабет, заболевания ЖКТ), где требуется деликатная настройка дозировок и темпа инфузий.
Узнать больше – http://narkologicheskaya-klinika-sergiev-posad8.ru
RonnyCaure
29 Oct 25 at 2:47 am
сайт бк мелбет [url=https://melbetofficialsite.ru/]сайт бк мелбет[/url] .
bk melbet_vjEa
29 Oct 25 at 2:47 am
блог про seo [url=http://statyi-o-marketinge6.ru/]блог про seo[/url] .
stati o marketinge _cgkn
29 Oct 25 at 2:48 am
Преимущество стационара — предсказуемость и скорость. Рядом врач и медсестра, можно оперативно сдать анализы, сделать ЭКГ или дополнительные обследования, а главное — не «тянуть» с корректировкой схемы. В контролируемой среде быстрее нормализуются сон и аппетит, уходит тремор, снижается тревога. Для пациентов с сопутствующими диагнозами это особенно важно: диабет, гипертония, аритмии, хронические заболевания ЖКТ требуют аккуратной, согласованной тактики.
Исследовать вопрос подробнее – http://narkologicheskaya-klinika-moskva8.ru/chastnaya-narkologicheskaya-klinika-v-moskve/https://narkologicheskaya-klinika-moskva8.ru
Thomasnup
29 Oct 25 at 2:49 am
Расташоп
Расташоп
29 Oct 25 at 2:49 am
kraken client
кракен актуальная ссылка
Henryamerb
29 Oct 25 at 2:49 am
Детокс — это не один раз «поставить капельницу», а последовательность: допуск к терапии, коррекция жидкости и электролитов, поддержка органов-мишеней, симптом-контроль, профилактика осложнений, переоценка и настройка схемы. Мы заранее закладываем точку повторной оценки, потому что абстинентные проявления изменчивы: тремор и тревога могут уходить волнообразно, давление — «гулять» на фоне усталости и недосыпа. Врач видит динамику и либо переводит на пероральные схемы, либо усиливает наблюдение, рекомендуя стационар. Параллельно настраиваем «бытовой контур» — сон по расписанию, вода малыми порциями, лёгкое дробное питание, ограничение эмоциональных перегрузок и перенос встреч, где сложно отказать.
Получить больше информации – http://narkologicheskaya-klinika-voskresensk8.ru/telefon-narkologicheskoj-klinikia-v-voskresenske/https://narkologicheskaya-klinika-voskresensk8.ru
Richardgeava
29 Oct 25 at 2:51 am
best cd radio alarm clock [url=http://alarm-radio-clocks.com]http://alarm-radio-clocks.com[/url] .
Cd Player Radio Alarm Clocks_qiOa
29 Oct 25 at 2:52 am
seo network [url=https://optimizaciya-i-seo-prodvizhenie-sajtov-moskva.ru]seo network[/url] .
optimizaciya i seo prodvijenie saitov moskva_igel
29 Oct 25 at 2:52 am
торкретирование цена за м2 [url=http://www.torkretirovanie-1.ru]http://www.torkretirovanie-1.ru[/url] .
torkretirovanie_fben
29 Oct 25 at 2:52 am
boulder-problem.com – Appreciate the typography choices; comfortable spacing improved my reading experience.
Joni Stogden
29 Oct 25 at 2:53 am
внутренняя гидроизоляция подвала [url=https://www.gidroizolyaciya-cena-8.ru]внутренняя гидроизоляция подвала[/url] .
gidroizolyaciya cena_sbKn
29 Oct 25 at 2:53 am
GHRP stimulates the release of growth hormonal agents, which promotes muscle mass growth, fat loss,
and bone density.
Dana
29 Oct 25 at 2:53 am
маркетинговые стратегии статьи [url=https://statyi-o-marketinge7.ru/]маркетинговые стратегии статьи[/url] .
stati o marketinge _gfkl
29 Oct 25 at 2:53 am
hello kitty alarm clock cd player [url=www.alarm-radio-clocks.com]www.alarm-radio-clocks.com[/url] .
Cd Player Radio Alarm Clocks_jfOa
29 Oct 25 at 2:54 am
маркетинговые стратегии статьи [url=www.statyi-o-marketinge6.ru]маркетинговые стратегии статьи[/url] .
stati o marketinge _utkn
29 Oct 25 at 2:55 am
Listen up, avoid boh chap conceгning mathematics lah, іt remains thе foundation іn primary curriculum,assuring your youngster avoids fɑll
duгing challenging Singapore.
Ꭺpart from establishment prestige, ɑ strong maths foundation develops resilience аgainst A Levels stress pⅼus prospective
hіgher ed trials.
Mums аnd Dads, competitive а Ьit hor, mathematics proficiency аt Junior College proves essential іn building rational thinking ᴡһat recruiters seek fоr tech fields.
St. Joseph’ѕ Institution Junior College embodies Lasallian traditions,
highlighting faith, service, аnd intellectual pursuit.
Integrated programs usе smooth progression ԝith focus on bilingualism ɑnd
innovation. Facilities lіke performing arts centers enhance creative expression. Worldwide immersions ɑnd research study chances wijden viewpoints.
Graduates аre thoughtful achievers, mastering universities ɑnd careers.
Eunoia Junior College embodies tһe pinnacle օf contemporary instructional innovation, housed іn a striking high-rise school thɑt seamlessly integrates common learning аreas, green ɑreas,
and advanced technological hubs tо create an inspiring environment fоr collaborative and experiential education. Ꭲhe college’s distinct philosophy
᧐f ” gorgeous thinking” motivates trainees to mix intellectual
іnterest ᴡith compassion аnd ethical reasoning, supported Ƅy vibrant academic programs іn thｅ arts,
sciences, аnd interdisciplinary research studies that promote creative ρroblem-solving and forward-thinking.
Geared ᥙp witһ tօp-tier centers ѕuch as professional-grade performing arts theaters, multimedia studios, аnd interactive science laboratories,
students аｒе empowered to pursue thеir passions and establish extraordinary skills іn a holistic manner.
Throսgh tactical collaborations ᴡith leading universities and market leaders, tһe college
provіdes enhancing chances fоr undergraduate-level reѕearch
study, internships, ɑnd mentorship thаt bridge class learning wіth real-wοrld applications.
As а outcome, Eunoia Junior College’ѕ students develop іnto thoughtful, durable
leaders ԝho аre not just academically achieved һowever likeԝise deeply devoted
tο contributing positively tο a varied and eѵer-evolving
international society.
Listen սp, composed pom ρi pi, maths proves one of tһе top disciplines
ɗuring Junior College, building groundwork іn A-Level advanced math.
Aiyo, lacking strong mathematics іn Junior College, eѵen top school youngsters mіght stumble in secondary equations, ѕo develop
tһіs promptly leh.
Hey hey,Singapore moms ɑnd dads, math remɑins perhaⲣѕ tһe moѕt essential primary subject, fostering innovation fоr challenge-tackling
to innovative careers.
Ꭰⲟ not mess aгound lah, combine a excellent Junior College рlus
mathematics superiority tо ensure superior А Levels reѕults and seamless transitions.
Folks, fear tһe disparity hor, mathematics foundation proves critical ԁuring Junior College іn grasping figures, crucial fοr modern tech-driven economy.
Kiasu study buddies mаke Math revision fun ɑnd effective.
Listen ᥙp, Singapore parents, mathematics ｒemains ⲣrobably the extremely impolrtant primary topic, fostering imagination tһrough challenge-tackling
tο creative careers.
Aᴠoid take lightly lah, combine а goоd Junior College alongside math superiority f᧐r guarantee high A Levels scores and seamless ⅽhanges.
my web ⲣage :: math tuition singapore
math tuition singapore
29 Oct 25 at 2:56 am
продвижение французского сайта цена [url=www.optimizaciya-i-seo-prodvizhenie-sajtov-moskva-1.ru/]www.optimizaciya-i-seo-prodvizhenie-sajtov-moskva-1.ru/[/url] .
optimizaciya i seo prodvijenie saitov moskva_lkPi
29 Oct 25 at 2:56 am
интернет маркетинг статьи [url=statyi-o-marketinge7.ru]интернет маркетинг статьи[/url] .
stati o marketinge _tskl
29 Oct 25 at 2:57 am
кракен актуальная ссылка
кракен зеркало
Henryamerb
29 Oct 25 at 2:57 am
кракен маркет
кракен актуальная ссылка
Henryamerb
29 Oct 25 at 2:58 am
Купить диплом любого университета можем помочь. Купить диплом специалиста в Архангельске – [url=http://diplomybox.com/kupit-diplom-spetsialista-v-arkhangelske/]diplomybox.com/kupit-diplom-spetsialista-v-arkhangelske[/url]
Cazrbiw
29 Oct 25 at 2:59 am
французское seo цена [url=https://optimizaciya-i-seo-prodvizhenie-sajtov-moskva-1.ru/]optimizaciya-i-seo-prodvizhenie-sajtov-moskva-1.ru[/url] .
optimizaciya i seo prodvijenie saitov moskva_pfPi
29 Oct 25 at 3:00 am
раскрутка сайта франция цена [url=https://optimizaciya-i-seo-prodvizhenie-sajtov-moskva.ru/]https://optimizaciya-i-seo-prodvizhenie-sajtov-moskva.ru/[/url] .
optimizaciya i seo prodvijenie saitov moskva_jjel
29 Oct 25 at 3:00 am
clock radio and cd player [url=https://www.alarm-radio-clocks.com]https://www.alarm-radio-clocks.com[/url] .
Cd Player Radio Alarm Clocks_edOa
29 Oct 25 at 3:00 am
мел бет букмекерская [url=http://www.melbetofficialsite.ru]мел бет букмекерская[/url] .
bk melbet_fnEa
29 Oct 25 at 3:01 am
Kamagra 100mg bestellen: Kamagra online kaufen – vital pharma 24
Georgenor
29 Oct 25 at 3:02 am
Онлайн-кинотеатр для тех, кто ценит время и качество: на https://kino-w.online/ вы найдете свежие премьеры, сериалы, аниме и культовую классику в стабильном HD без лишних кликов и регистрации. Интуитивная навигация, моментальный запуск, авторские рекомендации и частые обновления экономят время и избавляют от сомнительных сайтов. Каталог четко разложен по жанрам и годам, есть рейтинги и автопереход к следующим сериям без пауз. Удобно смотреть с любого устройства, а оптимизированные серверы обеспечивают плавный просмотр даже в часы пик.
fenasotrumb
29 Oct 25 at 3:02 am