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!
you are in point of fact a excellent webmaster. The website loading velocity is amazing.
It seems that you’re doing any distinctive trick.
Furthermore, The contents are masterwork.
you’ve done a great task on this subject!
взломать аккаунт
10 Aug 25 at 4:07 pm
Performance-driven cleaning, results-driven approach works. Performance partnership. Results delivered.
Established Cleaning
10 Aug 25 at 4:07 pm
1вин бет зеркало [url=http://1win1161.ru/]http://1win1161.ru/[/url]
1win_buOr
10 Aug 25 at 4:10 pm
https://wanderlog.com/view/hywnvhtzxg/
GilbertDab
10 Aug 25 at 4:12 pm
промокод на хоккей 1хБет – уникальный код для получения бонуса размером до 32 500 ?. Эта акция активируется только при первой регистрации, и после регистрации они получают начисление в размере 130% с первого депозита.
GregorySig
10 Aug 25 at 4:14 pm
Наркозависимость — это не просто вредная привычка, а тяжёлое хроническое заболевание, требующее комплексного и последовательного лечения. В клинике «РеабКузбасс» в Новокузнецке разработаны персонализированные программы помощи, учитывающие медицинские, психологические и социальные аспекты проблемы. Каждому пациенту подбирается уникальный маршрут восстановления, начиная с первичной диагностики и заканчивая адаптацией к жизни без наркотиков. Поддержка оказывается круглосуточно, с полным соблюдением конфиденциальности. Психотерапевты и врачи работают в тесной связке, чтобы не только устранить физическую зависимость, но и восстановить личность пациента, вернуть ему мотивацию к жизни и уверенность в будущем.
Детальнее – https://lechenie-narkomanii-novokuzneczk0.ru/lechenie-na-narkomani-czeny-novokuzneczk/
Kevinlus
10 Aug 25 at 4:15 pm
Тем, кто нуждается в длительной терапии, «КузбассМед» предлагает комфортные условия стационара с круглосуточным наблюдением. Здесь пациенты размещаются в индивидуальных палатах, проходят курсы терапии, реабилитации и психокоррекции. Обстановка в клинике напоминает оздоровительный центр: мягкое освещение, тишина, доступ к библиотеке, возможность общения с психологом и ежедневное участие в восстановительных мероприятиях. Медицинские сестры и врачи находятся на дежурстве 24/7, что позволяет немедленно реагировать на любые изменения в состоянии пациента.
Узнать больше – [url=https://narkologicheskaya-klinika-novokuzneczk0.ru/]наркологическая клиника клиника помощь[/url]
Williamexpew
10 Aug 25 at 4:16 pm
https://odysee.com/@Akayamaf0urg
Leslielen
10 Aug 25 at 4:18 pm
how to buy cheap amoxil without dr prescription
where to get amoxil without prescription
10 Aug 25 at 4:18 pm
Greate pieces. Keep posting such kind of info on your blog.
Im really impressed by it.
Hi there, You’ve done an excellent job. I’ll certainly digg
it and in my view suggest to my friends. I’m sure they will be benefited from this
web site.
نمونه کارنامه آیلتس
10 Aug 25 at 4:19 pm
I am really happy to glance at this webpage posts
which carries plenty of valuable facts, thanks for providing these data.
سایت های شرط بندی فوتبال
10 Aug 25 at 4:22 pm
Awesome post.
jepang 88
10 Aug 25 at 4:23 pm
авиатор игра на деньги 1win [url=http://1win1163.ru]http://1win1163.ru[/url]
1win_cuEn
10 Aug 25 at 4:24 pm
Нужен срочный вывод из запоя в Королёве? Обратитесь в Narcology Clinic. Опытные врачи приедут на дом, проведут детоксикацию и поддержат пациента на этапе восстановления. Помощь доступна круглосуточно и анонимно.
Разобраться лучше – [url=https://vyvod-iz-zapoya-korolev11.ru/]vyvod-iz-zapoya-korolev11.ru[/url]
MatthewHar
10 Aug 25 at 4:24 pm
1win kasino app [url=http://1win40012.ru/]http://1win40012.ru/[/url]
1win_mwMl
10 Aug 25 at 4:26 pm
Процедура капельницы назначается врачом-наркологом в ситуациях, когда состояние пациента становится критическим и организм нуждается в немедленном очищении от токсинов. Рекомендуется обратиться за срочной медицинской помощью, если отмечаются следующие признаки:
Получить больше информации – [url=https://kapelnica-ot-zapoya-krasnodar77.ru/]капельница от запоя клиника в краснодаре[/url]
Kiethurift
10 Aug 25 at 4:27 pm
Хотите вывести ваш сайт на первые позиции поисковых
систем Яндекс и Google?
Мы предлагаем качественный
линкбилдинг — эффективное решение для увеличения органического трафика и роста конверсий!
Почему именно мы?
– Опытная команда специалистов,
работающая исключительно белыми методами SEO-продвижения.
– Только качественные и тематические доноры ссылок,
гарантирующие стабильный рост позиций.
– Подробный отчет о проделанной работе и прозрачные условия сотрудничества.
Чем полезен линкбилдинг?
– Улучшение видимости сайта в поисковых системах.
– Рост количества целевых посетителей.
– Увеличение продаж и прибыли вашей компании.
Заинтересовались? Пишите нам в личные сообщения —
подробно обсудим ваши цели и предложим индивидуальное решение для успешного продвижения вашего бизнеса онлайн!
Цена договорная, начнем сотрудничество прямо сейчас вот
на адрес ===>>> ЗДЕСЬ Пишите обгаварим все ньансы!!!
webpage
10 Aug 25 at 4:29 pm
https://rant.li/maj6efb40v
GilbertDab
10 Aug 25 at 4:30 pm
Первичный приём в «УралРеаб» не требует оплаты — это возможность получить профессиональную оценку состояния и составить план лечения без финансовых рисков. Консультация включает:
Подробнее тут – http://lechenie-alkogolizma-ekaterinburg00.ru/
Normanniz
10 Aug 25 at 4:35 pm
вавада играть
вавада
10 Aug 25 at 4:36 pm
Thanks very nice blog!
ثبت نام وام 100 میلیونی بازنشستگان کشوری
10 Aug 25 at 4:38 pm
Сделайте первый шаг к трезвости с профессиональной помощью. В Narcology Clinic (г. Королёв) осуществляют вывод из запоя на дому и в клинике. Индивидуальный подход, анонимность, сопровождение пациента и семьи на всех этапах.
Получить дополнительную информацию – [url=https://vyvod-iz-zapoya-korolev13.ru/]вывод из запоя недорого в королеве[/url]
Craigcroky
10 Aug 25 at 4:47 pm
https://bio.site/ofudhuhaya
GilbertDab
10 Aug 25 at 4:49 pm
Woah! I’m really enjoying the template/theme of this website.
It’s simple, yet effective. A lot of times it’s tough to get that “perfect balance” between usability and
visual appearance. I must say you’ve done a superb job with this.
Additionally, the blog loads very quick for me on Chrome.
Exceptional Blog!
نمونه کارنامه قبولی مرکز وکلای قوه قضاییه
10 Aug 25 at 4:52 pm
перепланировка квартиры согласование [url=https://soglasovanie-pereplanirovki-kvartiry1.ru]перепланировка квартиры согласование[/url] .
soglasovanie pereplanirovki kvartiri _feOi
10 Aug 25 at 4:55 pm
Оперативное вмешательство позволяет быстро начать детоксикацию и предотвратить развитие опасных осложнений.
Получить дополнительную информацию – http://vyvod-iz-zapoya-sochi777.ru
KevinGot
10 Aug 25 at 4:55 pm
https://say.la/read-blog/124143
Leslielen
10 Aug 25 at 4:59 pm
в якутске купить аттестат за 11 класс [url=arus-diplom25.ru]в якутске купить аттестат за 11 класс[/url] .
Diplomi_yeot
10 Aug 25 at 5:00 pm
1win md [url=https://www.1win40009.ru]https://www.1win40009.ru[/url]
1win_wgoi
10 Aug 25 at 5:02 pm
Do you mind if I quote a few of your articles as
long as I provide credit and sources back to your site?
My website is in the exact same area of interest as yours and my visitors would genuinely benefit from some
of the information you present here. Please let me know if this alright with
you. Cheers!
Montgomery roof inspection
10 Aug 25 at 5:05 pm
Your means of telling all in this post is truly good, all
be capable of without difficulty know it, Thanks a lot.
jepang88
10 Aug 25 at 5:06 pm
https://jessieme1998.bandcamp.com/album/admit
GilbertDab
10 Aug 25 at 5:08 pm
1хставка скачать на андроид [url=1win1163.ru]1win1163.ru[/url]
1win_rdEn
10 Aug 25 at 5:10 pm
Для пациентов, требующих круглосуточного наблюдения, клиника «Полярис» предлагает стационар VIP-класса. Здесь созданы все условия для быстрого восстановления: удобные палаты, индивидуальное меню, зоны отдыха и консультации профильных специалистов.
Узнать больше – [url=https://narkologicheskaya-klinika-arkhangelsk0.ru/]наркологические клиники алкоголизм архангельск[/url]
Frankclusa
10 Aug 25 at 5:11 pm
В клинике используются современные методы лечения, которые включают:
Ознакомиться с деталями – [url=https://narkologicheskaya-klinika-tver0.ru/]наркологическая клиника стационар тверь[/url]
RaymondFounk
10 Aug 25 at 5:12 pm
Хотите вывести ваш сайт на первые позиции поисковых систем Яндекс и Google?
Мы предлагаем качественный линкбилдинг — эффективное решение для увеличения
органического трафика и роста конверсий!
Почему именно мы?
– Опытная команда специалистов, работающая исключительно белыми методами SEO-продвижения.
– Только качественные и тематические доноры ссылок, гарантирующие стабильный
рост позиций.
– Подробный отчет о проделанной работе и прозрачные условия сотрудничества.
Чем полезен линкбилдинг?
– Улучшение видимости сайта в поисковых
системах.
– Рост количества целевых посетителей.
– Увеличение продаж и прибыли вашей компании.
Заинтересовались? Пишите нам в личные сообщения — подробно
обсудим ваши цели и предложим индивидуальное
решение для успешного продвижения вашего бизнеса онлайн!
Цена договорная, начнем сотрудничество прямо сейчас вот на адрес
===>>> ЗДЕСЬ Пишите обгаварим все ньансы!!!
website
10 Aug 25 at 5:12 pm
1win официальный промокод [url=http://1win1163.ru/]http://1win1163.ru/[/url]
1win_swEn
10 Aug 25 at 5:16 pm
Pinco r?smi sayt [url=https://pinwinaz.pro/#]Yeni az?rbaycan kazino sayt?[/url] Kazino bonuslar? 2025 Az?rbaycan
LarryBah
10 Aug 25 at 5:16 pm
С какими заболеваниями не берут в армию? Хронический холецистит – повод для освобождения.
http://whatsupskydiving.com/w/User:JacklynKnisley4
https://menwiki.men/wiki/Bolezni_58x
10 Aug 25 at 5:18 pm
На сайте https://pet4home.ru/ представлена содержательная, интересная информация на тему животных. Здесь вы найдете материалы о кошках, собаках и правилах ухода за ними. Имеются данные и об экзотических животных, птицах, аквариуме. А если ищете что-то определенное, то воспользуйтесь специальным поиском. Регулярно на портале выкладываются любопытные публикации, которые будут интересны всем, кто держит дома животных. На портале есть и видеоматериалы для наглядности. Так вы узнаете про содержание, питание, лечение животных и многое другое.
Kozicueenusy
10 Aug 25 at 5:19 pm
Hi Dear, are you really visiting this website on a regular
basis, if so afterward you will without doubt take good knowledge.
akun demo slot
10 Aug 25 at 5:19 pm
Hello there! This is my 1st comment here so I just wanted to give a quick shout out
and tell you I truly enjoy reading through your articles.
Can you recommend any other blogs/websites/forums that deal
with the same topics? Thanks a ton!
có gì từ từ nói chuyện
10 Aug 25 at 5:26 pm
https://www.rwaq.org/users/mrtnzalkin-20250809173308
GilbertDab
10 Aug 25 at 5:27 pm
Hello, i think that i saw you visited my weblog thus i came to
“return the favor”.I’m attempting to find things to
enhance my website!I suppose its ok to use some
of your ideas!!
akun demo slot nolimit city
10 Aug 25 at 5:27 pm
Wonderful work! That is the type of information that are
meant to be shared across the internet. Disgrace on Google for now not positioning this post higher!
Come on over and seek advice from my website .
Thanks =)
P.C. Queens best Custody lawyer service
10 Aug 25 at 5:34 pm
электрические рулонные шторы купить москва [url=http://zhalyuzi-s-elektroprivodom7.ru]http://zhalyuzi-s-elektroprivodom7.ru[/url] .
jaluzi s elektroprivodom_mdMr
10 Aug 25 at 5:34 pm
С какими заболеваниями не берут в армию? Хронический дерматит – повод для освобождения.
https://wiki.lafabriquedelalogistique.fr/Discussion_utilisateur:RoseJay0519257
https://shaderwiki.studiojaw.com/index.php?title=User:BurtonWomack02
10 Aug 25 at 5:38 pm
https://www.passes.com/osbeckhappyosbeckgreat07
Douglassmesk
10 Aug 25 at 5:41 pm
Возможно, это будет полезно участникам обсуждения:
Кстати, если вас интересует buytime.ru, загляните сюда.
Вот, можете почитать:
[url=https://buytime.ru]https://buytime.ru[/url]
Дайте знать, если найдете что-то еще.
rusPoito
10 Aug 25 at 5:42 pm
ماه چت
بهمن فیاضی نژاد
10 Aug 25 at 5:42 pm