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!
При поступлении вызова нарколог незамедлительно прибывает на дом для проведения детального первичного осмотра. Врач измеряет жизненно важные показатели, такие как пульс, артериальное давление и температура, а также собирает краткий анамнез, чтобы определить степень алкогольной интоксикации и сформировать индивидуальный план терапии.
Выяснить больше – http://vyvod-iz-zapoya-donetsk-dnr0.ru
JamesEcosy
16 Oct 25 at 3:46 pm
https://t.me/Official_1xbet_1xbet/s/464
AlbertEnark
16 Oct 25 at 3:46 pm
https://t.me/Official_1xbet_1xbet/s/723
AlbertEnark
16 Oct 25 at 3:46 pm
сайт натяжной потолок [url=www.natyazhnye-potolki-nizhniy-novgorod-1.ru/]www.natyazhnye-potolki-nizhniy-novgorod-1.ru/[/url] .
natyajnie potolki nijnii novgorod_esma
16 Oct 25 at 3:46 pm
ZenCare Meds: trusted online pharmacy USA – ZenCare Meds com
AndrewPal
16 Oct 25 at 3:46 pm
купить диплом в сыктывкаре [url=rudik-diplom1.ru]купить диплом в сыктывкаре[/url] .
Diplomi_bber
16 Oct 25 at 3:47 pm
купить диплом в нальчике [url=http://rudik-diplom4.ru]купить диплом в нальчике[/url] .
Diplomi_dyOr
16 Oct 25 at 3:47 pm
mostbet uz.com [url=http://mostbet4185.ru]http://mostbet4185.ru[/url]
mostbet_uz_tber
16 Oct 25 at 3:48 pm
купить проведенный диплом высокие [url=http://www.frei-diplom5.ru]купить проведенный диплом высокие[/url] .
Diplomi_gePa
16 Oct 25 at 3:49 pm
Прошу прощения, что я Вас прерываю.
The fxpro team works around the clock to enlighten fantasies and guarantee qualified assistance. These markets offer significant opportunities due to the global dynamics of popularity and distribution, geopolitical events, the [url=https://fxpro-trading.co.za/demo-account/]fxpro[/url] and seasonal consumption patterns.
AnastasiaSeila
16 Oct 25 at 3:50 pm
Основная цель капельничного лечения от запоя – оперативное выведение токсинов, восстановление нормального обмена веществ и предотвращение дальнейших осложнений. Методика, используемая специалистами, включает не только медикаментозное вмешательство, но и комплексный мониторинг состояния пациента, что обеспечивает безопасность и результативность терапии даже в условиях экстренной необходимости.
Подробнее – http://
JarredToulp
16 Oct 25 at 3:50 pm
Процесс лечения строится из нескольких ключевых этапов, каждый из которых направлен на оперативное восстановление состояния пациента:
Подробнее тут – https://vyvod-iz-zapoya-donetsk-dnr00.ru/vyvod-iz-zapoya-kruglosutochno-doneczk-dnr/
Kennethfut
16 Oct 25 at 3:51 pm
mosbet kz
mostbet casino
16 Oct 25 at 3:51 pm
В лобби представлены онлайн аппараты от более чем 60 провайдеров.
риобет онлайн
16 Oct 25 at 3:52 pm
купить диплом учителя физической культуры [url=rudik-diplom3.ru]купить диплом учителя физической культуры[/url] .
Diplomi_suei
16 Oct 25 at 3:53 pm
Minotaurus token’s multi-chain support key. Presale raise impressive. Unlocks thrilling.
mtaur coin
WilliamPargy
16 Oct 25 at 3:53 pm
日立エンジニアリングは家電メンテナンス、電気通信・空調設備、施工管理から多岐にわたる人材派遣サービスまで展開する企業です。優れたシステムを支える「人」の力を大切にし、社員一人ひとりを「人財」として育成。生活インフラの保守や多様なサービスを通じて社会に貢献し、社員が誇りを持てる企業を目指しています。
設備 工事
16 Oct 25 at 3:57 pm
TadaLife Pharmacy: TadaLife Pharmacy – cialis
Andresstold
16 Oct 25 at 3:57 pm
натяжные потолки от производителя в нижнем новгороде [url=www.stretch-ceilings-nizhniy-novgorod-1.ru]www.stretch-ceilings-nizhniy-novgorod-1.ru[/url] .
natyajnie potolki nijnii novgorod_abOn
16 Oct 25 at 3:57 pm
диплом купить реестр [url=https://frei-diplom4.ru]диплом купить реестр[/url] .
Diplomi_rbOl
16 Oct 25 at 3:58 pm
Exploratory modules аt OMT motivate imaginative analytical, assisting trainees uncover math’ѕ
creativity and feel inspired f᧐r exam accomplishments.
Chɑnge math obsyacles іnto accomplishments ᴡith OMT Math Tuition’ѕ blend of online
ɑnd on-site alternatives, backed ƅy a performance history
օf trainee quality.
Ԍiven tһat mathematics plays а critical function in Singapore’ѕ financial advancement аnd progress, purchasing specialized math tuition gears ᥙp students ѡith the analytical skills neeⅾed to grow in a competitive landscape.
Eventually, primary school math tuition іѕ vital fߋr PSLE quality, аs it gears uр trainees ᴡith the tools to attain t᧐p bands
and protect preferred secondary school positionings.
Customized math tuition іn senior hіgh school addresses individual
finding ᧐ut spaces in subjects likｅ calculus and statistics, stopping tһem
from preventing Ⲟ Level success.
Tuition incorporates pure аnd սsed mathematics effortlessly, preparing
pupils fоr the interdisciplinary nature οf A Level troubles.
Distinctively tailored tߋ enhance the MOE syllabus, OMT’ѕ
customized mathematics proogram incorporates technology-driven tools ffor interactive knowing experiences.
Bite-sized lessons mаke it verｙ easy to fit in leh, rеsulting in consistent
practice аnd ƅetter generɑl qualities.
Eventually, math tuition іn Singapore cһanges prospective іnto achievement, guaranteeing students not јust pass yet master thｅir math examinations.
Also visit mｙ page … A levels math tuition
A levels math tuition
16 Oct 25 at 3:59 pm
потолочников [url=https://stretch-ceilings-nizhniy-novgorod-1.ru/]потолочников[/url] .
natyajnie potolki nijnii novgorod_zmOn
16 Oct 25 at 4:00 pm
купить проведенный диплом красноярск [url=frei-diplom5.ru]купить проведенный диплом красноярск[/url] .
Diplomi_ejPa
16 Oct 25 at 4:00 pm
Trying to find a trusted, protected, and fully compliant approach to validate identities?
Our Dependable Vendor ID Verification assistance features fast,
precise, and lawful methods intended to meet up with the requires of businesses, occasions, and on the net platforms.
With automated document checks, serious-time biometric matching, and State-of-the-art fraud
detection, we make onboarding safer plus much more productive.
All data is encrypted, saved In accordance with privateness regulations,
and managed with the best standard of stability. Our System supports
scalable integrations through API or SDK, in-depth
audit logs, and comprehensive reporting applications, guaranteeing
transparency and accountability at each individual step.
Whether or not you’re a startup or an organization,
our dedicated aid staff guides you thru setup and operation, providing
responsible guidance when you want it. Deal with growing your
company though we take care of identity verification with pace, precision, and compliance, giving you reassurance plus your prospects a protected working experience they could belief.
Best Fake ID Websites
16 Oct 25 at 4:01 pm
потолочник натяжные потолки нижний новгород [url=http://natyazhnye-potolki-nizhniy-novgorod-1.ru]http://natyazhnye-potolki-nizhniy-novgorod-1.ru[/url] .
natyajnie potolki nijnii novgorod_rtma
16 Oct 25 at 4:03 pm
I always used to study post in news papers but now
as I am a user of web therefore from now I am using net for articles or reviews, thanks to web.
boobs
16 Oct 25 at 4:03 pm
Северное сияние, длинные сумерки, влажный ветер с Кольского залива — у Мурманска свой ритм, который влияет на сон, частоту сердечных сокращений и восприятие звука. Мы учитываем этот фон в клинике и при выездной помощи: используем тёплую подсветку вместо холодного верхнего света, организуем «режим тишины» на телефонах, ограничиваем количество касаний ночью, вводим «окна связи» с родственниками в заранее оговорённое время. Такой сенсорный профиль помогает снизить вечернюю реактивность и уменьшает потребность в избыточной фармакологии, сохраняя ясность утром.
Выяснить больше – http://narkologicheskaya-klinika-murmansk15.ru/narkologi-murmansk/
Michaelanype
16 Oct 25 at 4:03 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 presale
WilliamPargy
16 Oct 25 at 4:04 pm
webrevive.click – Already bookmarked this, it seems like a resource I’ll revisit often.
Loren Niswender
16 Oct 25 at 4:04 pm
Клиника работает 24/7, принимая пациентов как в стационаре, так и в формате выездных бригад на дом. Мы соединяем медицинскую, психотерапевтическую и поведенческую опоры в единую траекторию: от быстрой стабилизации витальных показателей до настройки вечерних ритуалов (свет, дыхание 4–6, «цифровая тишина»). Внутри команды выстроена координация: нарколог курирует острые окна, терапевт отслеживает соматический фон и лекарственные взаимодействия, психиатр и клинический психолог уменьшают тревожную реактивность и формируют устойчивые навыки «перехвата» импульсов, медсёстры обеспечивают безошибочную технику процедур, куратор синхронизирует всех участников и ведёт «дорожную карту» лечения понятным языком фактов.
Углубиться в тему – [url=https://narkologicheskaya-klinika-v-petrozavodske15.ru/]наркологическая клиника стационар петрозаводск[/url]
JamesHog
16 Oct 25 at 4:05 pm
вывод из запоя круглосуточно
narkolog-krasnodar019.ru
лечение запоя
narkologiyakrasnodarNeT
16 Oct 25 at 4:05 pm
https://t.me/Official_1xbet_1xbet/s/1175
AlbertEnark
16 Oct 25 at 4:05 pm
https://t.me/Official_1xbet_1xbet/s/754
AlbertEnark
16 Oct 25 at 4:06 pm
Мы не составляем «супер-смеси» «на всякий случай». Капельница — это набор модулей, каждый из которых отвечает за конкретную задачу: гидратация, электролиты, гастропротекция, антиоксидантная поддержка; при показаниях — мягкая анксиолитика. Порядок модулей зависит от ведущего симптом-кластера и времени суток.
Получить дополнительную информацию – http://kapelnicza-ot-zapoya-murmansk15.ru/kapelnicza-ot-pokhmelya-murmansk/
WilliamEmecy
16 Oct 25 at 4:09 pm
купить диплом в астрахани [url=https://rudik-diplom3.ru]купить диплом в астрахани[/url] .
Diplomi_mnei
16 Oct 25 at 4:10 pm
Чтобы убрать неопределённость, мы делим первые часы на короткие окна. У каждого окна есть цель, действия и критерии перехода. Если ответ «плоский», корректируется один элемент, а следующая проверка назначается сразу — без хаотичного «усиления всего сразу».
Узнать больше – https://vyvod-iz-zapoya-murmansk15.ru/vyvod-iz-zapoya-murmansk-narkolog-na-dom-kapelnicza
JeremyTep
16 Oct 25 at 4:10 pm
Hi, just wanted to mention, I liked this blog post.
It was helpful. Keep on posting!
fastest mba programs online
16 Oct 25 at 4:11 pm
https://t.me/Official_1xbet_1xbet/s/87
AlbertEnark
16 Oct 25 at 4:11 pm
https://t.me/Official_1xbet_1xbet/s/527
AlbertEnark
16 Oct 25 at 4:11 pm
boostengine.click – Already telling friends about this, deserves more visibility in my view.
Arron Uhas
16 Oct 25 at 4:12 pm
натяжной потолок дешево [url=http://www.stretch-ceilings-nizhniy-novgorod-1.ru]натяжной потолок дешево[/url] .
natyajnie potolki nijnii novgorod_bbOn
16 Oct 25 at 4:13 pm
TG @‌LINKS_DEALER | EFFECTIVE SEO LINKS FOR Spinbetterbet.com
Jamesrab
16 Oct 25 at 4:14 pm
купить диплом техникума с реестром [url=www.frei-diplom4.ru]купить диплом техникума с реестром[/url] .
Diplomi_waOl
16 Oct 25 at 4:15 pm
Excellent web site you have got here.. It’s difficult to find good quality
writing like yours nowadays. I seriously appreciate individuals like you!
Take care!!
23WIN
16 Oct 25 at 4:16 pm
купить диплом в москве [url=https://www.rudik-diplom11.ru]купить диплом в москве[/url] .
Diplomi_nqMi
16 Oct 25 at 4:17 pm
потолочкин потолки натяжные отзывы [url=http://www.natyazhnye-potolki-nizhniy-novgorod-1.ru]http://www.natyazhnye-potolki-nizhniy-novgorod-1.ru[/url] .
natyajnie potolki nijnii novgorod_vlma
16 Oct 25 at 4:17 pm
купить диплом в старом осколе [url=http://rudik-diplom3.ru/]купить диплом в старом осколе[/url] .
Diplomi_okei
16 Oct 25 at 4:17 pm
https://www.opelbook.ru/read
Nathanhip
16 Oct 25 at 4:18 pm
mostbetin [url=http://mostbet4185.ru/]http://mostbet4185.ru/[/url]
mostbet_uz_vker
16 Oct 25 at 4:20 pm
новости футбольных клубов [url=novosti-sporta-17.ru]novosti-sporta-17.ru[/url] .
novosti sporta_jrOi
16 Oct 25 at 4:21 pm