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!
888starz crash eg [url=https://888starz.red/]888starz crash eg[/url] .
888starz_xpKn
21 Jul 25 at 5:22 pm
USA-safe Accutane sourcing: USA-safe Accutane sourcing – USA-safe Accutane sourcing
KelvinHoosy
21 Jul 25 at 5:25 pm
1win armenia [url=http://1win3071.ru]http://1win3071.ru[/url]
1win_wjKl
21 Jul 25 at 5:28 pm
задачи карьерной стратегии
JamesSyday
21 Jul 25 at 5:30 pm
mostbet ro‘yxatdan o‘tmasdan kirish [url=mostbet4075.ru]mostbet4075.ru[/url]
mostbet_nmOr
21 Jul 25 at 5:30 pm
ai therapist app [url=www.ai-therapist22.com]www.ai-therapist22.com[/url] .
AI Therapist_ytsr
21 Jul 25 at 5:32 pm
аттестат ссср купить [url=http://arus-diplom7.ru]аттестат ссср купить[/url] .
Kypit diplom instityta!_fiOt
21 Jul 25 at 5:48 pm
https://lexapro.pro/# Lexapro for depression online
TheronSnipt
21 Jul 25 at 5:51 pm
888starz bet app egypt [url=https://www.egypt888starz.net]888starz bet app egypt[/url] .
888starz_jzKn
21 Jul 25 at 5:55 pm
cost of cheap propecia online [url=http://finasteridefromcanada.com/#]cheap Propecia Canada[/url] Propecia for hair loss online
BurtonCix
21 Jul 25 at 6:02 pm
buy angular contact ball bearing tapered roller bearing: Conquer both radial and axial loads with tapered roller bearings, designed to handle combined forces with exceptional efficiency. Featuring tapered rollers and raceways, these bearings provide optimal load distribution and smooth operation under demanding conditions. Ideal for automotive axles, gearboxes, and other applications requiring robust load-carrying capacity.
RobertPhasp
21 Jul 25 at 6:03 pm
Заключительная фаза реабилитации фокусируется на обучении пациента жизни без алкоголизма и развитии навыков преодоления жизненных трудностей естественным путем. В рамках этого этапа пациенты активно участвуют в специализированных программах, нацеленных на восстановление утраченных социальных связей и профессиональных компетенций. Программа включает трудотерапию, образовательные курсы и тематические семинары. Особое внимание уделяется работе с семьей: родственники проходят специальное обучение, помогающее им лучше понимать особенности зависимости быстро и эффективно оказывать поддержку близкому человеку.
Получить дополнительные сведения – [url=https://vyvod-iz-zapoya-krasnoyarsk55.ru/]вывод из запоя капельница в красноярске[/url]
Williamsok
21 Jul 25 at 6:03 pm
Клиника «ВолгаМед» в Волгограде обеспечивает круглосуточную анонимную помощь людям, столкнувшимся с алкогольной или наркотической зависимостью. Мы предлагаем как стационарное лечение в комфортных условиях, так и выезд врача на дом в любое время суток. Конфиденциальность, профессионализм и индивидуальный подход — ключевые принципы нашей работы. В этой статье подробно рассмотрим преимущества клиники, спектр услуг, порядок организации домашнего выезда специалистов и дополнительные возможности поддержки в период реабилитации.
Получить больше информации – https://narkologicheskaya-klinika-volgograd13.ru/anonimnaya-narkologicheskaya-klinika-volgograd
DustinTon
21 Jul 25 at 6:05 pm
мостбет служба поддержки [url=https://www.mostbet4075.ru]https://www.mostbet4075.ru[/url]
mostbet_gvOr
21 Jul 25 at 6:07 pm
Теряете контроль над алкоголем? Экстренная помощь нарколога на дому в Волгограде – это выход! Лечитесь дома! Это быстро, удобно, анонимно и эффективно. Быстрая детоксикация – первый шаг к выздоровлению! Мы работаем 24/7, чтобы вы могли получить помощь в любой ситуации. Наше лечение эффективно, потому что оно учитывает все аспекты проблемы. Сначала нужно очистить организм от алкоголя, и мы вам в этом поможем.
Подробнее тут – [url=https://vyvod-iz-zapoya-volgograd00.ru/]вывод из запоя круглосуточно волгоград[/url]
Charlesmew
21 Jul 25 at 6:09 pm
купить диплом техникума [url=www.arus-diplom7.ru]купить диплом техникума[/url] .
Zakazat diplom ob obrazovanii!_ahOt
21 Jul 25 at 6:09 pm
В «ЧелябДокторе» применяются комбинированные схемы, основанные на доказательной медицине и новейших разработках:
Подробнее можно узнать тут – http://kapelnica-ot-zapoya-chelyabinsk13.ru/postavit-kapelniczu-ot-zapoya-chelyabinsk/
ArthurTaupt
21 Jul 25 at 6:16 pm
стратегия карьерного роста
JamesSyday
21 Jul 25 at 6:20 pm
В состав капельницы обычно входят растворы для гидратации, витаминно-минеральные комплексы, гепатопротекторы для защиты печени, а также седативные препараты для стабилизации нервной системы. Такой подход позволяет быстро справиться с признаками похмелья и предотвратить развитие более серьезных осложнений.
Детальнее – [url=https://kapelnica-ot-zapoya-ekb55.ru/]вызвать капельницу от запоя в екатеринбурге[/url]
DavidNog
21 Jul 25 at 6:25 pm
can you get clomid without prescription
buy clomid online
21 Jul 25 at 6:30 pm
Вызов врача-нарколога на дом в Санкт-Петербурге начинается с детального осмотра и оценки состояния пациента. Врач измеряет давление, пульс, уровень кислорода в крови и определяет степень интоксикации.
Исследовать вопрос подробнее – https://narcolog-na-dom-sankt-peterburg00.ru/psikhiatr-narkolog-na-dom-spb/
Tomaswak
21 Jul 25 at 6:31 pm
вывод из запоя минск
vivod-iz-zapoya-minsk002.ru
лечение запоя
lechenieminskNeT
21 Jul 25 at 6:33 pm
id=”firstHeading” class=”firstHeading mw-first-heading”>Search гesults
Ηelp
English
Tools
Tools
mօvе tо sidebar hide
Actions
Ԍeneral
Feel free to surf to my web-site oscar555 ทางเข้า
oscar555 ทางเข้า
21 Jul 25 at 6:35 pm
купить аттестат в кемерово [url=www.arus-diplom7.ru]купить аттестат в кемерово[/url] .
Zakazat diplom VYZa!_grOt
21 Jul 25 at 6:40 pm
buy belt tensioner rollers bearing manufacturer in Europe: Access a network of leading bearing manufacturers across Europe, renowned for their innovation, quality, and reliability. Explore a diverse range of bearing types, materials, and sizes to meet your specific application requirements. Partner with a trusted European manufacturer for superior bearing performance and long-lasting value.
RobertPhasp
21 Jul 25 at 6:43 pm
1win am [url=1win3071.ru]1win3071.ru[/url]
1win_stKl
21 Jul 25 at 6:46 pm
mostbet uz aviator [url=https://mostbet4074.ru]https://mostbet4074.ru[/url]
mostbet_piKn
21 Jul 25 at 6:51 pm
1win зеркало скачать ios [url=http://1win3067.ru]http://1win3067.ru[/url]
1win_pioa
21 Jul 25 at 6:52 pm
регистрация в 1вин [url=https://www.1win3066.ru]регистрация в 1вин[/url]
1win_waEi
21 Jul 25 at 6:52 pm
Миссия нашего медицинского учреждения заключается в предоставлении всесторонней помощи людям, страдающим от зависимостей. Основные цели нашего центра включают:
Подробнее можно узнать тут – [url=https://alko-specialist.ru/]вывод из запоя на дому симферополь[/url]
IsmaelLox
21 Jul 25 at 6:59 pm
blacksprut
блэкспрут
black sprut
блэк спрут
blacksprut вход
блэкспрут ссылка
blacksprut ссылка
blacksprut onion
блэкспрут сайт
блэкспрут вход
блэкспрут онион
блэкспрут дакрнет
blacksprut darknet
blacksprut сайт
блэкспрут зеркало
blacksprut зеркало
black sprout
blacksprut com зеркало
блэкспрут не работает
blacksprut зеркала
как зайти на blacksprut
blacksprut ссылка
RichardPep
21 Jul 25 at 7:01 pm
браслеты из натуральных камней Браслет оберег: браслет оберег – это мощный талисман, защищающий от негативной энергии и привлекающий удачу.
Richardnox
21 Jul 25 at 7:06 pm
Medicines information leaflet. Effects of Drug Abuse.
diclofenac gabapentin lidocaine prilocaine cream a comprehensive guide
Some news about medicament. Read here.
diclofenac gabapentin lidocaine prilocaine cream a comprehensive guide
21 Jul 25 at 7:07 pm
aviator игра 1win официальный сайт [url=https://1win3066.ru]https://1win3066.ru[/url]
1win_mxEi
21 Jul 25 at 7:14 pm
Кодирование — это не просто медицинская манипуляция, а серьёзный шаг к восстановлению контроля над собственной жизнью и формированию устойчивой ремиссии.
Изучить вопрос глубже – http://kodirovanie-ot-alkogolizma-mytishchi5.ru/
Kennethblirl
21 Jul 25 at 7:17 pm
После обращения по телефону или через сайт оператор уточняет детали: симптомы, продолжительность зависимости, адрес и удобное время приезда врача. К выезду всегда готова дежурная бригада — специалисты приезжают к пациенту в Люберцах в течение 1–2 часов, при экстренных состояниях — как можно быстрее.
Подробнее можно узнать тут – https://narkologicheskaya-pomoshch-lyubercy5.ru/
Ronaldtrova
21 Jul 25 at 7:19 pm
Клиника создана для оказания квалифицированной помощи всем, кто страдает от различных форм зависимости. Мы стремимся не только к лечению, но также к формированию здорового образа жизни, возвращая пациентов к полноценной жизни.
Получить дополнительную информацию – http://нарко-специалист.рф/vivod-iz-zapoya-v-kruglosutochno-v-Ekaterinburge/
FrancisJalge
21 Jul 25 at 7:19 pm
Если у пациента выраженная интоксикация, судороги, хронические заболевания, лучше выбрать стационарный формат. Здесь гарантированы круглосуточное медицинское наблюдение, возможность быстрого реагирования на любые изменения состояния, консультации узких специалистов. Для пациентов созданы комфортные условия проживания, организовано индивидуальное питание, действует поддержка психолога.
Получить больше информации – https://vyvod-iz-zapoya-noginsk5.ru/vyvod-iz-zapoya-stacionar-v-noginske/
BrandonBus
21 Jul 25 at 7:19 pm
Вызов нарколога на дом позволяет быстро получить квалифицированную помощь в условиях, где пациент чувствует себя максимально комфортно. Специалист прибывает в течение 1–2 часов после обращения, осуществляя диагностику, стабилизацию состояния и при необходимости — детоксикацию.
Исследовать вопрос подробнее – [url=https://narcolog-na-dom-ekaterinburg55.ru/]нарколог на дом клиника в екатеринбурге[/url]
WesleyNelia
21 Jul 25 at 7:23 pm
Ценообразование в клинике формируется на основе выбранной программы и объема необходимых медицинских мероприятий. В таблице приведены ориентировочные расходы на основные виды услуг:
Получить дополнительную информацию – [url=https://narkologicheskaya-klinika-chelyabinsk13.ru/]narkologicheskaya-klinika-chelyabinsk13.ru/[/url]
DonovanDog
21 Jul 25 at 7:25 pm
Does your website have a contact page? I’m having problems locating
it but, I’d like to shoot you an email. I’ve got some suggestions for your blog you might
be interested in hearing. Either way, great
blog and I look forward to seeing it improve over time.
биткойн инвестиции
21 Jul 25 at 7:30 pm
После процедуры пациент и его близкие получают развернутые рекомендации по дальнейшему восстановлению, советы по профилактике рецидивов и возможности прохождения кодирования при желании пациента.
Разобраться лучше – https://narcolog-na-dom-sankt-peterburg000.ru/
Charlesnob
21 Jul 25 at 7:33 pm
Каждый врач клиники обладает глубокими знаниями фармакологии, психофармакологии и психотерапии. Они регулярно посещают профессиональные конференции, семинары и мастер-классы, чтобы быть в курсе новейших достижений в области лечения зависимостей. Такой подход позволяет нашим специалистам применять наиболее эффективные и современные методы терапии.
Изучить вопрос глубже – [url=https://narco-vivod.ru/]vyvod-iz-zapoya-kruglosutochno krasnodar[/url]
Michaeltob
21 Jul 25 at 7:46 pm
вывод из запоя минск
vivod-iz-zapoya-minsk002.ru
лечение запоя минск
vivodzapojminskNeT
21 Jul 25 at 7:47 pm
подключить интернет тарифы ростов
domashij-internet-rostov005.ru
домашний интернет тарифы ростов
internetrostovelini
21 Jul 25 at 7:58 pm
экстренный вывод из запоя
vivod-iz-zapoya-kaluga004.ru
вывод из запоя круглосуточно
alkogolizmkalugaNeT
21 Jul 25 at 8:01 pm
Запой – критическое состояние, грозящее жизни! Не ждите, вызывайте нарколога в Волгоградской области круглосуточно! Не важно, день или ночь – нарколог приедет к вам в любое время! Мы гарантируем быструю, безопасную и индивидуальную помощь. Мы гарантируем быструю и надежную помощь при запое. Мы готовы помочь вам, где бы вы ни находились – дома или в клинике! Сначала мы проводим диагностику, чтобы составить индивидуальный план лечения.
Узнать больше – [url=https://vyvod-iz-zapoya-volgograd000.ru/]вывод из запоя цены волгоград[/url]
Dennisetelt
21 Jul 25 at 8:10 pm
mental health chatbot [url=www.mental-health21.com]www.mental-health21.com[/url] .
Mental Health_ajPa
21 Jul 25 at 8:11 pm
металлические лестницы на заказ [url=https://lestnicy-na-metallokarkase-3.ru/]металлические лестницы на заказ[/url] .
lestnici na metallokarkase_dooi
21 Jul 25 at 8:12 pm
Своевременное вмешательство позволяет снизить концентрацию токсинов, нормализовать обмен веществ и предотвратить необратимые повреждения, что делает срочный вызов нарколога на дому жизненно необходимым.
Детальнее – [url=https://narcolog-na-dom-ryazan00.ru/]нарколог на дом вывод из запоя[/url]
RobertAbant
21 Jul 25 at 8:12 pm