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!
купить диплом о высшем с занесением в реестр [url=https://www.frei-diplom4.ru]купить диплом о высшем с занесением в реестр[/url] .
Diplomi_dgOl
16 Oct 25 at 4:22 pm
my sources
PHP hook, building hooks in your application – Sjoerd Maessen blog at Sjoerd Maessen blog
my sources
16 Oct 25 at 4:23 pm
sportwetten anbieter schweiz
Here is my site; online wettbüro eröffnen
online wettbüro eröffnen
16 Oct 25 at 4:25 pm
download linebet
????? ????? ??????? linebet
16 Oct 25 at 4:26 pm
купить технический диплом [url=www.rudik-diplom11.ru/]купить технический диплом[/url] .
Diplomi_nmMi
16 Oct 25 at 4:28 pm
купить диплом в люберцах [url=https://rudik-diplom3.ru/]купить диплом в люберцах[/url] .
Diplomi_grei
16 Oct 25 at 4:29 pm
Посетите сайт Crystal-Decor https://crystal-decor.ru/ который предлагает огромный ассортимент хрустальной продукции и продукции из стекла с доставкой по всей России. Зайдите в каталог – вы обязательно найдете то что вам понравится по демократичным ценам, а раздел акции поможет сэкономить еще больше! Принимаем заказы на изготовление люстр по вашим размерам. Подробнее на сайте.
dezitshils
16 Oct 25 at 4:29 pm
https://t.me/Official_1xbet_1xbet/s/597
AlbertEnark
16 Oct 25 at 4:31 pm
купить проведенный диплом [url=www.frei-diplom4.ru]купить проведенный диплом[/url] .
Diplomi_mrOl
16 Oct 25 at 4:32 pm
Доброго!
Не каждая фирма способна корректно смонтировать VRV/VRF-систему — это требует глубоких знаний и опыта. В Топ 10 компаний по установке VRV и VRF входят только те, кто прошёл обучение у производителей и имеет официальный статус партнёра. Рейтинг компаний по установке VRV и VRF учитывает количество успешно сданных проектов, отзывы заказчиков и скорость реагирования на аварии. Надёжные компании по продаже и установке VRV и VRF работают с юрлицами по безналичному расчёту и предоставляют полный пакет документов.
Полная информация по ссылке – https://vrf-montazh.ru/top-10-kompaniy-po-ustanovke-vrf-2025/
монтаж кондиционера в красноярске, компании по установке VRV и VRF, монтаж канализации вентиляции
компании по продаже и установки VRV и VRF, [url=https://vrf-montazh.ru/montazh-konditsionerov/]инструмент для монтажа кондиционеров[/url], инструкция монтаж кондиционеров
Удачи и хорошего климата!
AlbertBex
16 Oct 25 at 4:33 pm
потолочников натяжные потолки [url=http://natyazhnye-potolki-nizhniy-novgorod-1.ru]потолочников натяжные потолки[/url] .
natyajnie potolki nijnii novgorod_yqma
16 Oct 25 at 4:34 pm
«Светодар» — сеть офтальмологических клиник, где видят главное: безопасность, технологии и тактичный подход. Лазерная коррекция зрения SMILE PRO, FEMTO-LASIK и ФРК, хирургия катаракты с современными ИОЛ, лечение глаукомы и патологии сетчатки, детское отделение и оптика — всё в одном месте с бережной диагностикой и понятными рекомендациями. Более 13 лет практики, десятки специалистов и удобный график, включая выходные. Акции и онлайн-запись доступны на https://svetodar.pro/ — откройте мир заново, когда «чётко» становится нормой.
liwukKnics
16 Oct 25 at 4:35 pm
sicher wetten
My blog post – Amerikanische Buchmacher
Amerikanische Buchmacher
16 Oct 25 at 4:36 pm
Minotaurus coin’s ecosystem fun-focused. ICO’s legal green light. DAO votes exciting.
minotaurus ico
WilliamPargy
16 Oct 25 at 4:36 pm
https://t.me/Official_1xbet_1xbet/s/1352
AlbertEnark
16 Oct 25 at 4:36 pm
https://t.me/Official_1xbet_1xbet/s/813
AlbertEnark
16 Oct 25 at 4:37 pm
linebet maroc
telecharger linebet apk
16 Oct 25 at 4:39 pm
Hello to all, because I am actually eager of reading this web site’s post to be updated daily.
It carries good information.
SravionPro TEST
16 Oct 25 at 4:41 pm
натяжные потолки нижний новгород цена [url=https://www.stretch-ceilings-nizhniy-novgorod-1.ru]натяжные потолки нижний новгород цена[/url] .
natyajnie potolki nijnii novgorod_lbOn
16 Oct 25 at 4:42 pm
мостбет ставки уз [url=mostbet4185.ru]мостбет ставки уз[/url]
mostbet_uz_bier
16 Oct 25 at 4:42 pm
Что именно вам непонятно? всегда есть личные сообщения куда можно написать.
https://telegra.ph/Kupit-usilitel-sotovoj-svyazi-v-dnr-10-12-3
наблюдая за Вашей темой пришел к важному выводу:
Jamessmori
16 Oct 25 at 4:42 pm
потолочки [url=http://www.natyazhnye-potolki-nizhniy-novgorod-1.ru]http://www.natyazhnye-potolki-nizhniy-novgorod-1.ru[/url] .
natyajnie potolki nijnii novgorod_tvma
16 Oct 25 at 4:44 pm
потолочкин ру нижний новгород [url=stretch-ceilings-nizhniy-novgorod-1.ru]stretch-ceilings-nizhniy-novgorod-1.ru[/url] .
natyajnie potolki nijnii novgorod_jxOn
16 Oct 25 at 4:45 pm
brandlift.click – Typography choices are excellent, very readable and comfortable overall.
Garret Simonsen
16 Oct 25 at 4:46 pm
Приобрести диплом любого ВУЗа можем помочь. Купить диплом повара – [url=http://diplomybox.com/diplom-povara/]diplomybox.com/diplom-povara[/url]
Cazrdyq
16 Oct 25 at 4:47 pm
Администрация проекта Kraken настоятельно рекомендует клиентам системы применять только проверенные источники для получения рабочих адресов для входа. Это служит основной гарантией безопасности вашего аккаунта и совершаемых операций на просторах платформы Кракен. [url=https://mg.otohungyen.com/]кракен ссылка зеркало[/url] Именно данный ресурс представляет собой проверенный администрацией способ входа, который не только обеспечивает бесперебойное соединение с серверами маркетплейса, но и полностью оберегает конфиденциальность вашей информации от многочисленных фишинговых атак. Рекомендуется добавить эту страницу в закладки, чтобы в будущем избежать длительных и рискованных поисков.
Othex
16 Oct 25 at 4:51 pm
mostbet ro’yxatdan o’tish [url=http://mostbet4185.ru]mostbet ro’yxatdan o’tish[/url]
mostbet_uz_zeer
16 Oct 25 at 4:51 pm
купить диплом с внесением в реестр [url=www.rudik-diplom11.ru/]купить диплом с внесением в реестр[/url] .
Diplomi_khMi
16 Oct 25 at 4:51 pm
mostbet uz [url=www.mostbet4182.ru]www.mostbet4182.ru[/url]
mostbet_uz_zakt
16 Oct 25 at 4:51 pm
orgy
Brentsek
16 Oct 25 at 4:51 pm
Вас интересуют природные богатства России? Давайте исследуем их вместе!
По теме “Изучение ООПТ России: парки, заповедники, водоемы”, там просто кладезь информации.
Смотрите сами:
[url=https://alloopt.ru]https://alloopt.ru[/url]
Природа – наш главный учитель и защитник. Берегите её!
fixRow
16 Oct 25 at 4:53 pm
потолочкин ру натяжные потолки [url=stretch-ceilings-nizhniy-novgorod-1.ru]потолочкин ру натяжные потолки[/url] .
natyajnie potolki nijnii novgorod_azOn
16 Oct 25 at 4:55 pm
oral
Brentsek
16 Oct 25 at 4:55 pm
https://t.me/Official_1xbet_1xbet/s/633
AlbertEnark
16 Oct 25 at 4:57 pm
Медицинское кодирование действует не на симптомы, а на глубинные механизмы зависимости. Оно позволяет не просто временно отказаться от алкоголя, а формирует устойчивое отвращение и помогает преодолеть психологическую тягу. Такой подход снижает риск рецидива, улучшает мотивацию, способствует восстановлению здоровья и психологического баланса. В «Новом Пути» для каждого пациента подбирается индивидуальный метод с учётом анамнеза, возраста, сопутствующих болезней и личных особенностей.
Детальнее – https://kodirovanie-ot-alkogolizma-ehlektrostal6.ru/kodirovanie-ot-alkogolizma-na-domu-v-ehlektrostali/
Rafaelred
16 Oct 25 at 4:57 pm
новости легкой атлетики [url=http://novosti-sporta-15.ru]http://novosti-sporta-15.ru[/url] .
novosti sporta_oyma
16 Oct 25 at 4:57 pm
https://t.me/Official_1xbet_1xbet/s/892
AlbertEnark
16 Oct 25 at 4:58 pm
pferderennen krefeld quote wetten bedeutung, animogeo.com,
animogeo.com
16 Oct 25 at 4:58 pm
Sprounix is usually a following-generation AI-pushed platform meant to bridge
the hole between pupils, universities, and businesses across Europe.
It combines intelligent automation, structured evaluation, and authentic-time analytics for making selecting speedier, fairer, and more effective.
With Sprounix, students can right away analyse their CVs, discover parts for enhancement, and prepare
for interviews making use of realistic AI simulations.
The platform also delivers personalized work and internship suggestions, encouraging
young specialists obtain options that actually match their competencies
and aspirations.
For companies and university career groups, Sprounix features Innovative candidate
screening, structured interview scoring, and automated campus recruiting resources — all in just one particular seamless program.
Irrespective of whether you’re running a significant-quantity recruitment marketing campaign or organising a campus profession reasonable, Sprounix makes certain every
single choice is backed by information and objectivity. By cutting down time-to-seek the services of and increasing prospect high quality, Sprounix empowers organisations to create
more powerful, far more diverse teams when supplying college students the
confidence and readiness they need to reach the trendy task
industry.
ai recruiting software
16 Oct 25 at 4:58 pm
My partner and I stumbled over here different page
and thought I might as well check things out. I like what I see so now i am following you.
Look forward to checking out your web page again.
onewave Malaysia
16 Oct 25 at 4:58 pm
clickoptim.click – Typography and spacing are great; very reader-friendly and clean.
Pat Groff
16 Oct 25 at 4:58 pm
Exceptional post however I was wanting to know if you could write a litte more on this subject? I’d be very grateful if you could elaborate a little bit more. Bless you!
Rio Bet
OLaneDrync
16 Oct 25 at 4:59 pm
https://t.me/Official_1xbet_1xbet/s/720
AlbertEnark
16 Oct 25 at 5:02 pm
https://t.me/Official_1xbet_1xbet/s/257
AlbertEnark
16 Oct 25 at 5:03 pm
I am really thankful to the owner of this website who has shared this fantastic piece of writing at here.
egjobb szakember
16 Oct 25 at 5:05 pm
mostbet uz sport tikish [url=https://www.mostbet4182.ru]https://www.mostbet4182.ru[/url]
mostbet_uz_rokt
16 Oct 25 at 5:06 pm
натяжные потолки нижний новгород дешево [url=https://www.stretch-ceilings-nizhniy-novgorod-1.ru]натяжные потолки нижний новгород дешево[/url] .
natyajnie potolki nijnii novgorod_fvOn
16 Oct 25 at 5:07 pm
Hi, its pleasant article on the topic of media print, we all be familiar with
media is a great source of information.
dewa scatter
16 Oct 25 at 5:07 pm
купить диплом в находке [url=https://rudik-diplom11.ru/]купить диплом в находке[/url] .
Diplomi_zmMi
16 Oct 25 at 5:09 pm
mostbet online uz [url=www.mostbet4185.ru]www.mostbet4185.ru[/url]
mostbet_uz_iqer
16 Oct 25 at 5:11 pm