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!
Bonus exclusif 1xBet pour 2026 : recevez une offre de 100% jusqu’a 130€ lors de votre inscription. Une promotion reservee aux nouveaux joueurs de paris sportifs, permettant d’effectuer des paris sans risque. N’attendez pas la fin de l’annee 2026 pour profiter de cette offre. Vous pouvez retrouver le code promo 1xBet sur ce lien — Code Promo Gratuit. Le code promo 1xBet vous permet d’activer un bonus d’inscription 1xBet exclusif et de commencer a parier avec un avantage. Le code promotionnel 1xBet 2026 est valable pour les paris sportifs, le casino en ligne et les tours gratuits. Decouvrez des aujourd’hui le meilleur code promo 1xBet et profitez du bonus de bienvenue 1xBet sans depot initial.
Marvinspaft
20 Oct 25 at 9:24 am
купить диплом техникум [url=http://educ-ua7.ru]http://educ-ua7.ru[/url] .
Diplomi_bqea
20 Oct 25 at 9:25 am
Ukrainian President Volodymyr Zelensky condemned Russian attacks on the Ukrainian regions of Kharkiv, Zaporizhzhia and Sumy on Monday, saying that the Kremlin intends to “humiliate diplomatic efforts” just hours before European leaders visit the White House.
[url=https://kra–42.cc]kra37 сс[/url]
“The Russian war machine continues to destroy lives despite everything,” Zelensky said in a statement, hours before he’s due to meet US President Donald Trump in the Oval Office. “That is precisely why we are seeking assistance to put an end to the killings. That is why reliable security guarantees are required. That is why Russia should not be rewarded for its participation in this war.”
[url=https://kra42—cc.ru]kra36[/url]
“Everyone seeks dignified peace and true security,” the Ukrainian president said. “And at this very moment, the Russians are attacking Kharkiv, Zaporizhzhia, the Sumy region, and Odesa, destroying residential buildings and our civilian infrastructure.”
At least seven people were killed in Russia’s attack? on Kharkiv and a further three killed in the ballistic missile strike on the city of Zaporizhzhia, with scores more injured, according to Ukrainian authorities.
“This was a demonstrative and cynical Russian strike,” Zelensky added.
kra39 cc
https://kra-41–at.ru
Danieljeove
20 Oct 25 at 9:25 am
купить диплом технолога [url=http://www.rudik-diplom3.ru]купить диплом технолога[/url] .
Diplomi_hsei
20 Oct 25 at 9:29 am
диплом техникума торгового купить [url=http://frei-diplom11.ru/]диплом техникума торгового купить[/url] .
Diplomi_aysa
20 Oct 25 at 9:30 am
купить диплом железнодорожника [url=http://www.rudik-diplom7.ru]купить диплом железнодорожника[/url] .
Diplomi_nvPl
20 Oct 25 at 9:30 am
купить диплом с проведением [url=frei-diplom3.ru]купить диплом с проведением[/url] .
Diplomi_baKt
20 Oct 25 at 9:31 am
диплом автотранспортного техникума купить [url=https://frei-diplom8.ru]диплом автотранспортного техникума купить[/url] .
Diplomi_bosr
20 Oct 25 at 9:31 am
1вин криптовалюта [url=1win5510.ru]1вин криптовалюта[/url]
1win_uz_tosi
20 Oct 25 at 9:34 am
What i don’t understood is in reality how you are no longer actually much more neatly-liked than you might be right now.
You’re so intelligent. You already know thus considerably on the subject of this matter, produced
me personally consider it from so many various angles.
Its like women and men are not involved except it is something to do with Woman gaga!
Your own stuffs nice. At all times care for it up!
13win
20 Oct 25 at 9:34 am
globalalliancenetwork.bond – Will bookmark this network and revisit for upcoming partnership ideas.
Allan Stotsky
20 Oct 25 at 9:37 am
купить диплом колледжа [url=http://educ-ua7.ru/]http://educ-ua7.ru/[/url] .
Diplomi_qnea
20 Oct 25 at 9:38 am
проект перепланировки квартиры цена московская область [url=www.proekt-pereplanirovki-kvartiry11.ru]www.proekt-pereplanirovki-kvartiry11.ru[/url] .
proekt pereplanirovki kvartiri_ofot
20 Oct 25 at 9:39 am
возможно ли купить диплом колледжа [url=www.frei-diplom8.ru]www.frei-diplom8.ru[/url] .
Diplomi_kxsr
20 Oct 25 at 9:39 am
Начнем путешествие по магическим уголкам российских заповедников.
Для тех, кто ищет информацию по теме “Изучение ООПТ России: парки, заповедники, водоемы”, есть отличная статья.
Ссылка ниже:
[url=https://alloopt.ru]https://alloopt.ru[/url]
Спасибо за внимание! Надеюсь, вам было интересно.
fixRow
20 Oct 25 at 9:40 am
купить диплом в петрозаводске [url=rudik-diplom8.ru]купить диплом в петрозаводске[/url] .
Diplomi_fiMt
20 Oct 25 at 9:40 am
купить диплом техника [url=rudik-diplom7.ru]купить диплом техника[/url] .
Diplomi_svPl
20 Oct 25 at 9:41 am
диплом реестр купить [url=www.frei-diplom4.ru]диплом реестр купить[/url] .
Diplomi_seOl
20 Oct 25 at 9:41 am
https://pilloleverdi.shop/# cialis generico
MickeySum
20 Oct 25 at 9:41 am
купить диплом реестр [url=https://frei-diplom6.ru/]купить диплом реестр[/url] .
Diplomi_dzOl
20 Oct 25 at 9:43 am
согласование перепланировки квартиры москва [url=proekt-pereplanirovki-kvartiry11.ru]согласование перепланировки квартиры москва[/url] .
proekt pereplanirovki kvartiri_xbot
20 Oct 25 at 9:45 am
В установочном центре APVShop модернизация авто начинается с диагностики и плана работ: мультимедиа, автозвук, тюнинг и дооснащение с гарантией. Ищете установка carplay? apvshop.ru/category/uslugi-ustanovochnogo-tsentra — здесь вы найдете состав услуг, сроки и запись в установочный центр в СПб. Команда работает чисто и точно: проводка, кодирование, калибровки камер и тонкая настройка звука. Приемлемые сроки и прозрачная смета помогают держать проект под контролем.
pehibHoore
20 Oct 25 at 9:46 am
There’s certainly a great deal to know about this subject.
I like all of the points you made.
adult mancave decor
20 Oct 25 at 9:47 am
https://t.me/s/reiting_top10_casino/3
EdwardAdete
20 Oct 25 at 9:48 am
купить диплом монтажника [url=https://rudik-diplom15.ru/]купить диплом монтажника[/url] .
Diplomi_hrPi
20 Oct 25 at 9:48 am
https://t.me/s/reiting_top10_casino/10
EdwardAdete
20 Oct 25 at 9:49 am
https://linkin.bio/qetikodzukou
Anthonycam
20 Oct 25 at 9:50 am
Купить диплом техникума в Днепр [url=www.educ-ua7.ru]www.educ-ua7.ru[/url] .
Diplomi_svea
20 Oct 25 at 9:50 am
купить диплом техникума оригинальный [url=https://www.frei-diplom8.ru]купить диплом техникума оригинальный[/url] .
Diplomi_orsr
20 Oct 25 at 9:51 am
Currently it sounds liкe Expression Engine is tһe preferred blogging platform aνailable
ｒight noԝ. (from what I’ve read) Is that what you arе սsing on yⲟur blog?
my homepage – college math tutor online free
college math tutor online free
20 Oct 25 at 9:51 am
легальный диплом купить [url=http://www.frei-diplom6.ru]легальный диплом купить[/url] .
Diplomi_hkOl
20 Oct 25 at 9:53 am
купить диплом в мытищах [url=http://www.rudik-diplom3.ru]купить диплом в мытищах[/url] .
Diplomi_svei
20 Oct 25 at 9:54 am
https://t.me/reiting_top10_casino
EdwardAdete
20 Oct 25 at 9:54 am
купить диплом в химках [url=http://rudik-diplom8.ru]купить диплом в химках[/url] .
Diplomi_hxMt
20 Oct 25 at 9:54 am
https://t.me/reiting_top10_casino/5
EdwardAdete
20 Oct 25 at 9:54 am
купить диплом о высшем образовании с занесением в реестр в кемерово [url=http://frei-diplom4.ru/]купить диплом о высшем образовании с занесением в реестр в кемерово[/url] .
Diplomi_mgOl
20 Oct 25 at 9:55 am
СПб преображается ночью, предлагая мужчинам незабываемые впечатления. Любителей ночных тусовок ждут клубы с живой музыкой, такие как «Stackenschneider» или «Хорошо».
Ценители караоке могут отправиться в «Рюмочную». Для любящих риск открыты покер-румы в пригороде.
Бары на Рубинштейна предлагают насыщенную тусовку. Хотите необычного? Прогулки по крышам или катание на яхте по Неве.
Для ценителей эротики работают стриптиз-клубы. Для желающих провести ночь с девушкой можем посоветовать сайт: [url=https://sosamba-spb2.com/prospekt_prosvescheniya]проститутки проспект просвещения[/url]
Санкт-Петербург ночью — это драйв и море вариантов для отдыха! ??
SPBzef
20 Oct 25 at 9:57 am
Very nice article. I definitely love this site. Continue the good work!
Hotel Near Mumbai Airport
20 Oct 25 at 9:58 am
купить диплом историка [url=https://rudik-diplom2.ru/]купить диплом историка[/url] .
Diplomi_gxpi
20 Oct 25 at 9:58 am
1вин бонус за регистрацию уз [url=https://www.1win5510.ru]1вин бонус за регистрацию уз[/url]
1win_uz_sqsi
20 Oct 25 at 10:00 am
Этот информационный материал собраны данные, которые помогут лучше понять текущие тенденции и процессы в различных сферах жизни. Мы предоставляем четкий анализ, графики и примеры, чтобы информация была не только понятной, но и практичной для принятия решений.
Что скрывают от вас? – https://newerahtx.com/harnessing-the-power-of-the-sun
Charlesbopay
20 Oct 25 at 10:01 am
купить диплом с занесением в реестр [url=https://rudik-diplom3.ru]купить диплом с занесением в реестр[/url] .
Diplomi_ezei
20 Oct 25 at 10:02 am
купить диплом техникума ржд [url=www.frei-diplom11.ru]купить диплом техникума ржд[/url] .
Diplomi_fvsa
20 Oct 25 at 10:03 am
куплю диплом о высшем образовании [url=https://rudik-diplom7.ru/]куплю диплом о высшем образовании[/url] .
Diplomi_bhPl
20 Oct 25 at 10:04 am
купить диплом в анжеро-судженске [url=https://rudik-diplom2.ru/]https://rudik-diplom2.ru/[/url] .
Diplomi_xmpi
20 Oct 25 at 10:06 am
https://potenzvital.shop/# Cialis Preisvergleich Deutschland
MickeySum
20 Oct 25 at 10:06 am
1вин слоты [url=http://1win5510.ru]http://1win5510.ru[/url]
1win_uz_pnsi
20 Oct 25 at 10:07 am
купить диплом сантехника [url=www.rudik-diplom8.ru]купить диплом сантехника[/url] .
Diplomi_ghMt
20 Oct 25 at 10:07 am
Useful info. Lucky me I discovered your site by accident, and
I am surprised why this accident did not happened earlier!
I bookmarked it.
Обратные ссылки для Гугл
20 Oct 25 at 10:07 am
В обзорной статье вы найдете собрание важных фактов и аналитики по самым разнообразным темам. Мы рассматриваем как современные исследования, так и исторические контексты, чтобы вы могли получить полное представление о предмете. Погрузитесь в мир знаний и сделайте шаг к пониманию!
Не упусти шанс – http://interiordesignerwebzwnb.cf/post/34
Williamdok
20 Oct 25 at 10:07 am