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!
В этой информационной статье вы найдете интересное содержание, которое поможет вам расширить свои знания. Мы предлагаем увлекательный подход и уникальные взгляды на обсуждаемые темы, побуждая пользователей к активному мышлению и критическому анализу.
Осуществить глубокий анализ – https://andrey-mishanin.ru
Nicolashow
17 Jul 25 at 12:39 pm
Лечение выводом из запоя на дому в «ВоронежМед» организовано по отработанному протоколу, включающему несколько ключевых этапов.
Выяснить больше – [url=https://kapelnica-ot-zapoya-voronezh.ru/]капельница от запоя клиника[/url]
Michaeltek
17 Jul 25 at 12:43 pm
melbet withdrawal problem [url=https://melbet3003.com]https://melbet3003.com[/url]
melbet_wbKn
17 Jul 25 at 12:51 pm
Awesome things here. I am very glad to look your article.
Thanks so much and I am taking a look ahead to contact you.
Will you please drop me a e-mail?
omegle
17 Jul 25 at 12:52 pm
gebiss lim apotek: glykolsyre apotek – korona selvtest apotek
Kennethrip
17 Jul 25 at 12:54 pm
Этот информационный материал собраны данные, которые помогут лучше понять текущие тенденции и процессы в различных сферах жизни. Мы предоставляем четкий анализ, графики и примеры, чтобы информация была не только понятной, но и практичной для принятия решений.
Все материалы собраны здесь – https://vitamagazine.com/2024/10/02/stardust-roller-rink-is-back-in-b-c-win
LanceWet
17 Jul 25 at 12:58 pm
https://tryggmed.com/# apoteket norge
MichaelDeeli
17 Jul 25 at 1:01 pm
пансионат для людей с деменцией в туле
pansionat-tula003.ru
пансионат для престарелых
alkogolizmkrasnodarNeT
17 Jul 25 at 1:04 pm
melbet фрибет [url=http://melbet3001.com]melbet фрибет[/url]
melbet_cxkn
17 Jul 25 at 1:05 pm
В этой статье представлен занимательный и актуальный контент, который заставит вас задуматься. Мы обсуждаем насущные вопросы и проблемы, а также освещаем истории, которые вдохновляют на действия и изменения. Узнайте, что стоит за событиями нашего времени!
Подробная информация доступна по запросу – http://rolfspb.ru
EdwardZet
17 Jul 25 at 1:08 pm
Поддержка — ключевой элемент на пути к выздоровлению. Мы предлагаем программы, которые продолжаются даже после завершения основного курса лечения. Пациенты имеют возможность участвовать в регулярных встречах с психологами и наркологами, где они могут делиться своими успехами и получать необходимую помощь.
Ознакомиться с деталями – http://kapelnica-ot-zapoya-irkutsk2.ru
Richardincog
17 Jul 25 at 1:09 pm
flood sms
GerardobaR
17 Jul 25 at 1:10 pm
Hi, I believe your website may be having web browser
compatibility issues. Whenever I take a look at your site in Safari, it looks fine however
when opening in IE, it has some overlapping issues.
I merely wanted to provide you with a quick heads up!
Aside from that, fantastic blog!
정품 비아그라 구매
17 Jul 25 at 1:14 pm
кракен ios
DavidFoogs
17 Jul 25 at 1:14 pm
Казино Vodka Casino — официальный сайт с бонусами и демо-игрой
Vodka Casino — русскоязычная платформа с сотнями игр от NetEnt, Pragmatic Play, Evolution Gaming. Лицензия Кюрасао обеспечивает базовую защиту. Темный дизайн с красными акцентами, удобная навигация и мобильное приложение.
Бонусы: 100% на первый депозит + 50 фриспинов, кэшбэк 10%, еженедельные reload-бонусы, VIP-программа. Демо-режим без регистрации для изучения слотов.
Платежи: депозит от 500?, вывод до 600000?/сутки за 24 часа. Поддерживаются карты МИР/Visa, электронные кошельки, криптовалюты. Верификация обязательна для выплат.
Техническая помощь доступна через:
Онлайн-чат (среднее время ответа — 3 минуты)
Телеграм-бот @VodkaCasinoSupport
Email support@vodkacasino.ru
Турниры с призовым фондом до 50000€, live-казино с профессиональными дилерами.
EarnestAbent
17 Jul 25 at 1:14 pm
С психологом онлайн вы обретете гармонию. Детский психолог онлайн поддержит в переходных этапах.
женщина психолог онлайн
Ernestpoive
17 Jul 25 at 1:15 pm
When you’re in need of quiet company, 토닥이 offers soothing
comfort without saying a word.
여성전용마사지
17 Jul 25 at 1:25 pm
enema apotek: Trygg Med – ansiktskrem apotek
Altonjah
17 Jul 25 at 1:26 pm
부산토닥이 시간만큼은 세상이 멈춘 느낌이었어요.
부산여성전용마사지
17 Jul 25 at 1:27 pm
rosa munnbind apotek: Trygg Med – sprГёytespiss apotek
Kennethrip
17 Jul 25 at 1:32 pm
сколько стоит аттестат 11 классов купить в [url=arus-diplom21.ru]arus-diplom21.ru[/url] .
Diplomi_xdPr
17 Jul 25 at 1:34 pm
http://zorgpakket.com/# bestellen medicijnen
MichaelDeeli
17 Jul 25 at 1:34 pm
купить диплом с занесением в реестр в красноярске [url=http://arus-diplom33.ru/]http://arus-diplom33.ru/[/url] .
Diplomi_vmSa
17 Jul 25 at 1:35 pm
http://tryggmed.com/# ormekur katt apotek
WilliamNog
17 Jul 25 at 1:38 pm
Алкогольная и наркотическая зависимости требуют незамедлительного медицинского вмешательства. Длительные запои или острое отравление могут привести к тяжелым осложнениям и серьезным проблемам со здоровьем. Клиника «МедТрезвость» в Санкт-Петербурге предлагает квалифицированную наркологическую помощь прямо на дому, обеспечивая полную конфиденциальность и безопасность пациента. Наши специалисты оперативно выезжают по адресу, проводят все необходимые процедуры и помогают максимально быстро стабилизировать состояние пациента в комфортных домашних условиях.
Получить больше информации – [url=https://narcolog-na-dom-sankt-peterburg0.ru/]нарколог на дом недорого санкт-петербург[/url]
CalvinSib
17 Jul 25 at 1:41 pm
Проблема алкогольной зависимости: важность внимательного подхода. Многие ищут помощь анонимно, чтобы избежать осуждения. Нарколог на дом предлагает услуги по лечению запоя, обеспечивая комфорт и приватность. Вызов нарколога помогает получить медицинскую помощь при запое без лишних вопросов. Анонимное лечение подразумевает detox-программы, которые включают в себя психологическую поддержку и медикаментозное сопровождение. Данный подход помогает предотвратить рецидив алкоголизма и способствует восстановлению после запойного состояния. Кризисная помощь помогает преодолеть острые состояния, предоставляя необходимые ресурсы. Таким образом, анонимный вывод из запоя – это реальность, доступная каждому, кто нуждается в помощи.
vivodtulaNeT
17 Jul 25 at 1:44 pm
Затяжной запой опасен для жизни. Врачи наркологической клиники в Химках проводят срочный вывод из запоя — на дому или в стационаре. Анонимно, безопасно, круглосуточно.
Исследовать вопрос подробнее – [url=https://vyvod-iz-zapoya-himki12.ru/]вывод из запоя недорого[/url]
MariaGer
17 Jul 25 at 1:45 pm
После процедуры пациент и его близкие получают развернутые рекомендации по дальнейшему восстановлению, советы по профилактике рецидивов и возможности прохождения кодирования при желании пациента.
Получить больше информации – [url=https://narcolog-na-dom-sankt-peterburg000.ru/]нарколог на дом круглосуточно санкт-петербург[/url]
NormanIncib
17 Jul 25 at 1:46 pm
Когда организм уже не может обходиться без алкоголя, возникает запой. Вызов нарколога на дом в Волгограде – это безопасно и эффективно. Нарколог приедет на дом, проведет детоксикацию и поможет стабилизировать состояние, не нарушая привычный ритм жизни. Своевременная помощь нарколога поможет избежать осложнений, вызванных запоем. Дома нарколог поможет очистить организм и восстановить его нормальную работу. Избавление от запоя на дому – это сочетание лекарств и психологической помощи. Сначала нужно очистить организм от токсинов, и в этом помогут специальные препараты.
Выяснить больше – [url=https://vyvod-iz-zapoya-volgograd0.ru/]вывод из запоя[/url]
Michaelacism
17 Jul 25 at 1:50 pm
При запое важна каждая минута! Круглосуточный вызов нарколога в Волгоградской области – решение проблемы! Обращайтесь к нам в любое время суток, и мы вам поможем! Мы обеспечиваем оперативное вмешательство, индивидуальный подход и высокий уровень безопасности. Мы – это оперативная и надежная помощь в трудную минуту. Мы обеспечим детоксикацию и стабилизацию вашего состояния, где вам будет удобно. Первый шаг – диагностика, чтобы определить план лечения.
Получить больше информации – [url=https://vyvod-iz-zapoya-volgograd000.ru/]клиника вывод из запоя волгоград[/url]
DavidVeget
17 Jul 25 at 1:54 pm
купить аттестат 11 классов в барнауле [url=www.arus-diplom22.ru/]купить аттестат 11 классов в барнауле[/url] .
Diplomi_kcKt
17 Jul 25 at 1:55 pm
vaksine pГҐ apotek [url=http://tryggmed.com/#]sorte munnbind apotek[/url] apotek pГҐske ГҐpningstider
ScottFup
17 Jul 25 at 1:56 pm
We absolutely love your blog and find almost all of your post’s to be
exactly I’m looking for. Would you offer guest writers to write
content available for you? I wouldn’t mind publishing a post or elaborating on many of the subjects
you write in relation to here. Again, awesome web site!
login gacorslot138
17 Jul 25 at 1:58 pm
Согласно данным Федерального наркологического центра, своевременный выезд врача снижает риск осложнений и повторных госпитализаций.
Исследовать вопрос подробнее – [url=https://narkolog-na-dom-kamensk-uralskij11.ru/]vrach-narkolog-na-dom kamensk-ural’skij[/url]
WillieDek
17 Jul 25 at 1:59 pm
Самостоятельно выйти из запоя — почти невозможно. В Химках врачи клиники проводят медикаментозный вывод из запоя с круглосуточным выездом. Доверяйте профессионалам.
Узнать больше – [url=https://vyvod-iz-zapoya-himki11.ru/]вывод из запоя капельница в химках[/url]
Nicoleemoft
17 Jul 25 at 2:02 pm
I visited various sites but the audio quality for audio songs present at this web
page is truly wonderful.
zlibrary
17 Jul 25 at 2:03 pm
купить диплом врача с занесением в реестр [url=https://www.arus-diplom34.ru]купить диплом врача с занесением в реестр[/url] .
Diplomi_qker
17 Jul 25 at 2:12 pm
Экстренное вмешательство необходимо, когда самостоятельное прекращение употребления алкоголя или наркотиков становится невозможным, а состояние пациента ухудшается. Основные показания включают:
Разобраться лучше – https://narcolog-na-dom-ufa000.ru/narkolog-na-dom-kruglosutochno-ufa
Vincentdow
17 Jul 25 at 2:16 pm
את המקצוענים. זה באמת יהיה טיפשי. הוא נחלץ לעזרתו ב – 8 במרץ, יום האישה הבינלאומי. מה שנדרש כדי שלה, גררתי אותה עם התחתונים שלה. התחת הוא רק יצירת מופת: עגול, קופצני, עם מתיחות קלות שרק הפכו נערות ליווי בחולון
HenryEscop
17 Jul 25 at 2:17 pm
купить биткоин за наличные rexex.io rexex.io – это портал в бескрайний океан криптовозможностей. Здесь вы найдете не только удобный и безопасный обменник, но и аналитические инструменты, образовательные материалы и комьюнити единомышленников. Rexex.io – это ваш личный крипто-ассистент, готовый помочь вам на каждом шагу.
Timothylak
17 Jul 25 at 2:18 pm
pseudoephedrine kopen in nederland: apotheek on line – internet apotheek nederland
Kennethrip
17 Jul 25 at 2:19 pm
Thanks for a marvelous posting! I truly enjoyed
reading it, you will be a great author.I will be sure
to bookmark your blog and definitely will come back down the
road. I want to encourage that you continue your great job,
have a nice evening!
KravonPeakpro
17 Jul 25 at 2:21 pm
Мы понимаем, что лечение от алкогольной зависимости — это только первый шаг на пути к восстановлению. Профилактика рецидивов — важная часть нашего подхода. Мы проводим тренинги и курсы, направленные на развитие навыков борьбы с соблазнами и стрессом. Психотерапевтическая поддержка помогает пациентам справиться с эмоциональными трудностями, а также укрепляет мотивацию для сохранения трезвости.
Получить больше информации – [url=https://kapelnica-ot-zapoya-irkutsk3.ru/]капельница от запоя иркутская область[/url]
Alfredlialt
17 Jul 25 at 2:22 pm
Онлайн-психолог — решение для занятых людей. Детский психолог онлайн проведет сеанс в игровой форме.
онлайн консультация психолога по отношениям
Ernestpoive
17 Jul 25 at 2:23 pm
Современные методы лечения при выводе из запоя включают как медикаментозную детоксикацию, так и психологическую реабилитацию. В Уфе наркологи используют капельничное введение лекарственных средств, которые помогают быстро вывести токсины, нормализовать обмен веществ и стабилизировать работу внутренних органов. Одновременно с этим проводится психологическая поддержка для снижения эмоционального стресса, связанного с запоем.
Подробнее – [url=https://narcolog-na-dom-ufa0.ru/]вызов нарколога на дом уфа[/url]
KennethRem
17 Jul 25 at 2:24 pm
ставкипрогнозы [url=http://stavki-na-sport-prognozy.ru/]http://stavki-na-sport-prognozy.ru/[/url] .
stavki na sport prognozi _xlOn
17 Jul 25 at 2:29 pm
После звонка специалист клиники «ВитаЛайн» оперативно отправляется по указанному адресу и обычно прибывает в течение 30–60 минут. На месте врач сразу проводит детальную диагностику, оценивая состояние пациента: проверяет пульс, давление, сатурацию, степень интоксикации и наличие хронических болезней. На основании результатов осмотра нарколог разрабатывает индивидуальную схему терапии.
Ознакомиться с деталями – http://narcolog-na-dom-novosibirsk0.ru
JerryJodia
17 Jul 25 at 2:38 pm
kraken зеркало рабочее
RichardPep
17 Jul 25 at 2:51 pm
Инфузионная терапия от запоя – проверенное решение для помощи людей‚ страдающих алкоголизмом. Она способствует быстрое вливание жидкости‚ что приводит к детоксикации тела и улучшению состояния здоровья. В учреждениях лечения зависимостей‚ таких как narkolog-tula003.ru‚ квалифицированные специалисты оказывают медицинскую помощь‚ включая уколы от запоя. Лечение включает не только капельницы‚ но и реабилитацию‚ психологическую поддержку при алкоголизме‚ что помогает пациентам вернуться к обычной жизни.
alkogolizmtulaNeT
17 Jul 25 at 3:05 pm
купить обложку аттестата 11 класс [url=http://arus-diplom24.ru/]купить обложку аттестата 11 класс[/url] .
Diplomi_fcKn
17 Jul 25 at 3:09 pm