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!
AsthmaFree Pharmacy [url=https://asthmafreepharmacy.com/#]AsthmaFree Pharmacy[/url] buy ventolin tablets uk
Harryinapy
7 Aug 25 at 5:19 pm
Более 400 тысяч предложений со всей России представлено на интернет-площадке auto.ru.
https://evolutionmanix.forum24.ru/?1-7-0-00000001-000-0-0-1747156121
7 Aug 25 at 5:27 pm
Женский журнал [url=https://www.ksusha.online]https://www.ksusha.online[/url] .
ksusha.online_ddpr
7 Aug 25 at 5:30 pm
Наша цель заключается в том, чтобы воплотить это вдохновение в
ощутимые результаты для наших клиентов.
https://yulajournal.forum24.ru/
7 Aug 25 at 5:36 pm
cheapest online semaglutide: rybelsus name – AsthmaFree Pharmacy
Jessieopins
7 Aug 25 at 5:41 pm
С момента начала лечения пациент получает доступ к круглосуточной линии поддержки. Врачи, психологи и координаторы готовы ответить на вопросы, помочь с корректировкой схемы лечения, поддержать в ситуации риска срыва. Эта функция особенно востребована в первые недели после выписки, когда человек сталкивается с триггерами в привычной среде и нуждается в дополнительной защите. Связь может осуществляться по телефону, через защищённый мессенджер или с помощью мобильного приложения клиники.
Детальнее – [url=https://lechenie-narkomanii-samara0.ru/]лечение наркомании наркология[/url]
Vincentdop
7 Aug 25 at 5:42 pm
My family members every time say that I am wasting my time here
at net, but I know I am getting familiarity daily by reading thes nice posts.
sugar baby
7 Aug 25 at 5:43 pm
Женский журнал [url=http://ksusha.online/]http://ksusha.online/[/url] .
ksusha.online_iopr
7 Aug 25 at 5:55 pm
Heya i’m for the first time here. I found this board and I find It really
useful & it helped me out a lot. I hope to present one thing again and help others like you aided me.
https://lightningroulettegame.com/play-lightning-roulette-fairspin
7 Aug 25 at 5:56 pm
Сразу после вызова нарколог прибывает на дом для проведения тщательного первичного осмотра. На этом этапе специалист собирает краткий анамнез, измеряет жизненно важные показатели – пульс, артериальное давление, температуру – и оценивает степень алкогольной интоксикации. Полученные данные служат основой для составления индивидуального плана лечения, позволяющего подобрать оптимальные методы детоксикации.
Подробнее тут – http://vyvod-iz-zapoya-yaroslavl00.ru/vyvod-iz-zapoya-kruglosutochno-yaroslavl/
Keithmut
7 Aug 25 at 5:57 pm
mostbet uz depozit [url=http://mostbet4072.ru/]http://mostbet4072.ru/[/url]
mostbet_nvPl
7 Aug 25 at 5:58 pm
Когда запой становится критическим, оперативное вмешательство имеет решающее значение для спасения здоровья и предотвращения необратимых последствий. Во Владимире экстренная помощь нарколога на дому позволяет быстро начать лечение, не требуя госпитализации, что особенно важно для пациентов, нуждающихся в сохранении конфиденциальности и комфорте.
Подробнее – https://vyvod-iz-zapoya-vladimir000.ru/srochnyj-vyvod-iz-zapoya-vladimir/
JosephRhimi
7 Aug 25 at 6:00 pm
We absolutely love your blog and find most of your post’s to be just what I’m looking for.
Does one offer guest writers to write content for you? I wouldn’t mind
composing a post or elaborating on a few of the subjects you write concerning here.
Again, awesome web site!
اعتراض به یارانه دهک خانوار
7 Aug 25 at 6:03 pm
https://www.band.us/band/99519709/
JustinPhole
7 Aug 25 at 6:04 pm
Он чем-то напоминает Pinterest, так как предлагает просто массу информации,
созданную большим сообществом.
Смотреть подробнее
7 Aug 25 at 6:05 pm
Женский журнал [url=https://www.ksusha.online]https://www.ksusha.online[/url] .
ksusha.online_iypr
7 Aug 25 at 6:13 pm
Tizanidine tablets shipped to USA: trusted pharmacy Zanaflex USA – order Tizanidine without prescription
Jessieopins
7 Aug 25 at 6:15 pm
After I initially left a comment I seem to have clicked
the -Notify me when new comments are added- checkbox and from now on whenever a comment
is added I get four emails with the exact same comment.
Perhaps there is an easy method you can remove me from that service?
Thanks!
Auto Profit Hub
7 Aug 25 at 6:16 pm
Remarkable! Its actually amazing article, I have
got much clear idea concerning from this paragraph.
BosterCorexa
7 Aug 25 at 6:16 pm
Женский журнал [url=https://www.ksusha.online]https://www.ksusha.online[/url] .
ksusha.online_rnpr
7 Aug 25 at 6:16 pm
Очень рекомендую к прочтению:
Для тех, кто ищет информацию по теме “fjhg.ru”, нашел много полезного.
Вот, можете почитать:
[url=https://fjhg.ru]https://fjhg.ru[/url]
Успехов в решении вашего вопроса!
rusPoito
7 Aug 25 at 6:18 pm
mostbet uz yangi bonus 2025 [url=http://mostbet4079.ru/]http://mostbet4079.ru/[/url]
mostbet_bbMi
7 Aug 25 at 6:22 pm
prescription-free muscle relaxants [url=http://relaxmedsusa.com/#]RelaxMedsUSA[/url] muscle relaxants online no Rx
Harryinapy
7 Aug 25 at 6:22 pm
mostbet uz bonus kodi [url=mostbet4072.ru]mostbet uz bonus kodi[/url]
mostbet_fhPl
7 Aug 25 at 6:23 pm
mostbet uz yuklab olish skachat [url=www.mostbet4079.ru]www.mostbet4079.ru[/url]
mostbet_iqMi
7 Aug 25 at 6:29 pm
ksusha.online [url=ksusha.online]ksusha.online[/url] .
ksusha.online_kppr
7 Aug 25 at 6:33 pm
ksusha.online [url=www.ksusha.online/]www.ksusha.online/[/url] .
ksusha.online_hwpr
7 Aug 25 at 6:43 pm
узнать провайдера по адресу нижний новгород
nizhnij-novgorod-domashnij-internet004.ru
подключение интернета нижний новгород
internetelini
7 Aug 25 at 6:44 pm
Системы автоматизированного дозирования обеспечивают точное введение медикаментов, что минимизирует риск побочных эффектов. Постоянный мониторинг жизненно важных показателей позволяет врачу корректировать терапию в режиме реального времени, гарантируя безопасность процедуры.
Разобраться лучше – http://vyvod-iz-zapoya-vladimir0.ru/srochnyj-vyvod-iz-zapoya-vladimir/
Craigrag
7 Aug 25 at 6:44 pm
Когда запой становится угрозой для здоровья, оперативное вмешательство имеет решающее значение. В Тюмени, Тюменская область, услуга «капельница от запоя на дому» помогает быстро начать детоксикацию организма, восстановить нормальный обмен веществ и стабилизировать работу внутренних органов. Такой метод лечения позволяет пациенту получить профессиональную медицинскую помощь в комфортной домашней обстановке, при этом сохраняя конфиденциальность и снижая эмоциональный стресс.
Выяснить больше – [url=https://vyvod-iz-zapoya-vladimir00.ru/]вывод из запоя цены владимир[/url]
JamesKar
7 Aug 25 at 6:47 pm
https://ivercarepharmacy.shop/# IverCare Pharmacy
Jefferyled
7 Aug 25 at 6:49 pm
Great blog here! Additionally your site quite a bit up fast!
What web host are you using? Can I get your associate hyperlink for your host?
I wish my web site loaded up as quickly as yours lol
ثبت نام رشته حقوق بدون کنکور دانشگاه آزاد
7 Aug 25 at 6:50 pm
https://say.la/read-blog/122090
JustinPhole
7 Aug 25 at 6:50 pm
Клиника придерживается принципа прозрачного ценообразования. Пациенту или родственникам сразу озвучивается стоимость всех процедур и услуг. Возможна оплата поэтапно или в рамках пакета. В отличие от многих клиник, «ОмскПрофи» предоставляет фиксированные цены на распространённые виды помощи, без скрытых доплат.
Подробнее можно узнать тут – [url=https://narkologicheskaya-pomoshh-omsk0.ru/]анонимная наркологическая помощь в омске[/url]
Davidcicky
7 Aug 25 at 6:51 pm
Самостоятельно выйти из запоя — почти невозможно. В Екатеринбурге врачи клиники проводят медикаментозный вывод из запоя с круглосуточным выездом. Доверяйте профессионалам.
Изучить вопрос глубже – [url=https://vyvod-iz-zapoya-ekaterinburg.ru/]вывод из запоя город екатеринбург[/url]
TyroneReunc
7 Aug 25 at 6:52 pm
Edukasa System merekomendasikan situs TESLATOTO sebagai situs togel terpercaya.
Pelajari lima cara edukatif memilih bandar togel aman, responsif, dan anti tipu-tipu!
teslatoto
7 Aug 25 at 6:56 pm
Клиника «Феникс-Мед» предлагает два базовых формата лечения, позволяющих адаптировать помощь под состояние пациента и его предпочтения.
Исследовать вопрос подробнее – [url=https://vyvod-iz-zapoya-reutov4.ru/]vyvod iz zapoya na domu[/url]
CurtisJoype
7 Aug 25 at 6:57 pm
Хотите вывести ваш сайт на первые позиции поисковых
систем Яндекс и Google?
Мы предлагаем качественный линкбилдинг — эффективное решение для
увеличения органического трафика
и роста конверсий!
Почему именно мы?
– Опытная команда специалистов, работающая исключительно
белыми методами SEO-продвижения.
– Только качественные и тематические доноры ссылок, гарантирующие стабильный рост позиций.
– Подробный отчет о проделанной работе и прозрачные
условия сотрудничества.
Чем полезен линкбилдинг?
– Улучшение видимости сайта в
поисковых системах.
– Рост количества целевых посетителей.
– Увеличение продаж и прибыли вашей
компании.
Заинтересовались? Пишите нам
в личные сообщения — подробно обсудим ваши цели и предложим
индивидуальное решение для успешного продвижения вашего бизнеса онлайн!
Цена договорная, начнем сотрудничество прямо сейчас вот на адрес ===>>> ЗДЕСЬ Пишите обгаварим все ньансы!!!
webpage
7 Aug 25 at 6:57 pm
Наркомания — это хроническое заболевание, затрагивающее не только физическое и психическое здоровье человека, но и его окружение, работу, образ жизни. Эффективное лечение требует больше, чем просто временный отказ от употребления: нужен комплексный, персонализированный подход, который охватывает все сферы жизни пациента. В наркологической клинике «РеабПермь» в Перми предлагаются современные индивидуальные программы терапии, включающие медикаментозную поддержку, психотерапевтическую проработку и социальную реабилитацию. А первый шаг — бесплатная консультация, на которой специалист определяет масштаб проблемы и предлагает адекватную схему помощи.
Получить дополнительные сведения – [url=https://lechenie-narkomanii-perm0.ru/]лечение наркомании и алкоголизма[/url]
Robertsog
7 Aug 25 at 6:58 pm
https://bs2beast.cc
JulianBut
7 Aug 25 at 6:58 pm
После завершения основной инфузионной терапии врач наблюдает за состоянием пациента ещё в течение 30–60 минут. Если отсутствуют осложнения и параметры стабилизированы, врач даёт рекомендации по дальнейшему восстановлению, включая приём анксиолитиков, соблюдение питьевого режима, лёгкой диеты и исключение стрессов. Также составляется индивидуальный план наблюдения: возможны повторные визиты врача через сутки, двое или трое суток. При необходимости пациенту или его близким предоставляется контакт психотерапевта или проводится предварительное консультирование по дальнейшему лечению зависимости.
Изучить вопрос глубже – [url=https://narkologicheskaya-pomoshh-novosibirsk0.ru/]наркологическая помощь на дому в новосибирске[/url]
Jefferykax
7 Aug 25 at 7:01 pm
В клинике «СамарМед» доступно несколько форм лечения: стационарная программа, дневной стационар, амбулаторное наблюдение и гибридные схемы. Пациенты могут выбрать комфортный вариант в зависимости от степени зависимости, текущего состояния и занятости. Внутри стационара предусмотрены как стандартные палаты, так и индивидуальные блоки повышенной комфортности с возможностью проживания совместно с сопровождающим лицом.
Подробнее можно узнать тут – [url=https://narkologicheskaya-klinika-samara0.ru/]частная наркологическая клиника в самаре[/url]
Jimmylyday
7 Aug 25 at 7:05 pm
Оформиление дипломов ВУЗов по всей Украине — с печатями, подписями, приложением и возможностью архивной записи (по запросу).
Документ максимально приближен к оригиналу и проходит визуальную проверку.
Мы даем гарантию, что в случае проверки документа, подозрений не возникнет.
– Конфиденциально
– Доставка 3–7 дней
– Любая специальность
Уже более 3876 клиентов воспользовались услугой — теперь ваша очередь.
[url=http://inforepetitor37.ru/]Где купить диплом о среднем образовании[/url] — ответим быстро, без лишних формальностей.
JeffreyTus
7 Aug 25 at 7:10 pm
Для многих пациентов страх быть поставленным на учёт или потерять работу становится серьёзным барьером на пути к выздоровлению. В «ПермьМедСервис» данные пациента остаются строго внутри клиники: ни в какие внешние базы информация не передаётся. При оформлении документов не указывается диагноз, а возможна подача под псевдонимом. Консультации, процедуры и ведение истории болезни проходят в полностью закрытом режиме. Это позволяет пациенту сосредоточиться на выздоровлении, не опасаясь последствий для своей личной или профессиональной жизни.
Узнать больше – [url=https://narkologicheskaya-klinika-perm0.ru/]платная наркологическая клиника пермь[/url]
Kellyhus
7 Aug 25 at 7:14 pm
It’s amazing to pay a quick visit this website and reading
the views of all mates concerning this paragraph, while I am also zealous of getting
familiarity.
Also visit my website :: image optimizer
image optimizer
7 Aug 25 at 7:16 pm
оригинальные горшки для цветов купить [url=https://dizaynerskie-kashpo-rnd.ru]оригинальные горшки для цветов купить[/url] .
dizainerskie kashpo_pxSt
7 Aug 25 at 7:18 pm
Наркологическая помощь в Самаре представляет собой комплекс медицинских мероприятий, направленных на лечение алкогольной и наркотической зависимости, а также восстановление физического и психического здоровья пациентов. В наркологической клинике «Согласие» применяются современные методики диагностики, детоксикации и комплексной терапии, учитывающие индивидуальные особенности каждого пациента, тяжесть зависимости и наличие сопутствующих заболеваний. Основная цель — восстановление здоровья, предупреждение осложнений и снижение риска рецидивов.
Получить дополнительную информацию – [url=https://narkologicheskaya-pomoshh-samara0.ru/]круглосуточная наркологическая помощь в самаре[/url]
Anthonykisse
7 Aug 25 at 7:18 pm
Heya i am for the first time here. I came across this board and
I find It truly useful & it helped me out a lot. I hope
to give something back and help others like you helped me.
My web page: hot shotting
hot shotting
7 Aug 25 at 7:22 pm
safe online source for Tizanidine [url=https://relaxmedsusa.com/#]relief from muscle spasms online[/url] Tizanidine 2mg 4mg tablets for sale
Harryinapy
7 Aug 25 at 7:25 pm
Оформиление дипломов ВУЗов по всей Украине — с печатями, подписями, приложением и возможностью архивной записи (по запросу).
Документ максимально приближен к оригиналу и проходит визуальную проверку.
Мы гарантируем, что в случае проверки документа, подозрений не возникнет.
– Конфиденциально
– Доставка 3–7 дней
– Любая специальность
Уже более 1824 клиентов воспользовались услугой — теперь ваша очередь.
[url=http://inforepetitor37.ru/]Диплом высшего образования купить[/url] — ответим быстро, без лишних формальностей.
JeffreyTus
7 Aug 25 at 7:26 pm