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!
buy antibiotics over the counter in mexico: legit mexican pharmacy for hair loss pills – trusted mexican pharmacy
LewisSoump
19 Jul 25 at 11:04 pm
расчеты через платежного агента Отправка платежей в Китай – это процесс перевода денежных средств китайскому поставщику за товары или услуги. Он требует соблюдения валютного законодательства и использования надежных систем международных платежей.
Jasondug
19 Jul 25 at 11:11 pm
Everything is very open with a precise description of the challenges.
It was truly informative. Your website is very useful.
Many thanks for sharing!
アダルト動画
19 Jul 25 at 11:12 pm
Выездной формат позволяет избежать контактов с другими пациентами в клинике и очистить организм в привычной обстановке. Специалисты самостоятельно привозят весь необходимый набор медикаментов и расходных материалов.
Исследовать вопрос подробнее – [url=https://narkologicheskaya-klinika-ekaterinburg0.ru/]наркологическая клиника нарколог в екатеринбурге[/url]
RaymondHal
19 Jul 25 at 11:13 pm
I’ll right away seize your rss feed as I can not find
your email subscription hyperlink or e-newsletter service.
Do you have any? Kindly let me know so that I may
just subscribe. Thanks.
Awesome online store
19 Jul 25 at 11:18 pm
It’s wonderful that you are getting ideas from this piece of writing as well
as from our dialogue made here.
بهترین و معتبرترین سایت شرط بندی فوتبال ایرانی
19 Jul 25 at 11:21 pm
Согласно статье, опубликованной в Журнале клинической медицины, комплексный подход снижает вероятность рецидива и способствует длительной ремиссии.
Подробнее – [url=https://lechenie-alkogolizma-sochi00.ru/]центр лечения алкоголизма краснодарский край[/url]
MichaelTum
19 Jul 25 at 11:24 pm
Для начала комплексного лечения в наркологической клинике в Краснодаре проводится тщательная диагностика состояния пациента. Врач-нарколог назначает необходимые лабораторные и инструментальные исследования, среди которых общий анализ крови, биохимический анализ, ЭКГ, УЗИ внутренних органов, а также психодиагностические тесты. Такой комплексный подход позволяет выявить сопутствующие заболевания и оценить степень зависимости, что важно для выбора оптимальной терапии.
Подробнее – https://narkologicheskaya-klinika-krasnodar0.ru/anonimnaya-narkologicheskaya-klinika-v-krasnodare/
ThomasIdeaf
19 Jul 25 at 11:26 pm
I was suggested this website by way of my cousin. I’m not certain whether this
publish is written through him as no one else know such specific
about my trouble. You’re wonderful! Thanks!
what does a digital assistant do
19 Jul 25 at 11:28 pm
онлайн оценка часов по фото [url=www.ocenka-chasov-onlajn9.ru]онлайн оценка часов по фото[/url] .
ocenka chasov onlain_lbMn
19 Jul 25 at 11:31 pm
мостбет ру [url=mostbet4074.ru]мостбет ру[/url]
mostbet_dqKn
19 Jul 25 at 11:33 pm
https://aylita.ru
Lesteretedy
19 Jul 25 at 11:33 pm
buy antibiotics from mexico: buy kamagra oral jelly mexico – buy propecia mexico
LewisSoump
19 Jul 25 at 11:35 pm
Онлайн-консультация с психологом — это легко. Детский психолог онлайн проведет онлайн-игры для детей.
яндекс психолог онлайн
Ernestpoive
19 Jul 25 at 11:36 pm
mostbet uz kirish скачать [url=www.mostbet4073.ru]mostbet uz kirish скачать[/url]
mostbet_soot
19 Jul 25 at 11:37 pm
usa sms bomber
GerardobaR
19 Jul 25 at 11:42 pm
После первичного осмотра начинается активная фаза детоксикации. Современные препараты вводятся капельничным методом для быстрого снижения уровня токсинов в крови и восстановления обменных процессов. Этот этап критически важен для нормализации работы печени, почек и сердечно-сосудистой системы.
Выяснить больше – https://vyvod-iz-zapoya-vladimir000.ru/vyvod-iz-zapoya-na-domu-vladimir
MichaelBrees
19 Jul 25 at 11:45 pm
Лечение алкоголизма в Краснодаре представляет собой комплекс мероприятий, направленных на полное восстановление физического и психологического состояния пациента. Этот процесс требует профессионального подхода, включающего диагностику, детоксикацию, терапию зависимости и реабилитацию. Информация о современных методах терапии доступна на официальном портале Минздрава РФ.
Подробнее – https://lechenie-alkogolizma-krasnodar00.ru/lechenie-khronicheskogo-alkogolizma-krasnodar/
Virgilcic
19 Jul 25 at 11:48 pm
I am really pleased to read this blog posts which
carries lots of helpful facts, thanks for providing such statistics.
koitoto
19 Jul 25 at 11:51 pm
сервис платежи за границу Платежный агент онлайн – это компания, которая предоставляет услуги платежного агента через интернет.
Jasondug
19 Jul 25 at 11:53 pm
Whoa! This blog looks just like my old one!
It’s on a completely different subject but it has pretty much the same page layout and design. Great choice of colors!
网络药店
19 Jul 25 at 11:58 pm
поставщики подшипников в россии Купить подшипники от производителя Покупка подшипников напрямую у производителя — это уверенность в качестве и надежности. Это также возможность получить консультацию от специалистов, разбирающихся в тонкостях продукции и готовых предложить оптимальное решение для конкретных задач.
BrendonMaync
19 Jul 25 at 11:58 pm
кракен vk2
DavidFoogs
19 Jul 25 at 11:59 pm
Цена капельницы от запоя в Иркутске зависит от ряда факторов, таких как выбор метода лечения (на дому или в стационаре), продолжительность лечения и степень тяжести состояния пациента. Для уточнения стоимости и записи на консультацию вы можете обратиться к нашим менеджерам, которые подробно расскажут о стоимости услуг и ответят на все ваши вопросы.
Подробнее тут – [url=https://kapelnica-ot-zapoya-irkutsk3.ru/]капельница от запоя выезд иркутск[/url]
PatrickCrymn
20 Jul 25 at 12:02 am
Услуга выезда направлена на первичное стабилизирующее лечение при запое или наркотической интоксикации без необходимости госпитализации. Вызов выполняется в пределах города и пригорода максимум за 60 минут.
Получить больше информации – https://narkologicheskaya-klinika-sochi00.ru/narkologicheskaya-klinika-vyvod-iz-zapoya-sochi
MichaelCrumn
20 Jul 25 at 12:03 am
kraken onion
kraken onion ссылка
kraken onion зеркала
kraken рабочая ссылка onion
сайт kraken onion
kraken darknet
kraken darknet market
kraken darknet ссылка
сайт kraken darknet
kraken актуальные ссылки
кракен ссылка kraken
kraken официальные ссылки
kraken ссылка тор
kraken ссылка зеркало
kraken ссылка на сайт
kraken онион
kraken онион тор
кракен онион
кракен онион тор
кракен онион зеркало
кракен даркнет маркет
кракен darknet
кракен onion
кракен ссылка onion
кракен onion сайт
kra ссылка
kraken сайт
kraken актуальные ссылки
kraken зеркало
kraken ссылка зеркало
kraken зеркало рабочее
актуальные зеркала kraken
kraken сайт зеркала
kraken маркетплейс зеркало
кракен ссылка
кракен даркнет kraken ссылка зеркало
RichardPep
20 Jul 25 at 12:04 am
На этом этапе нарколог выясняет, какие лекарства принимались ранее, есть ли аллергии, хронические заболевания, а также уточняет объём и длительность употребления алкоголя. Это позволяет скорректировать состав инфузионных растворов.
Подробнее можно узнать тут – [url=https://kapelnica-ot-zapoya-voronezh.ru/]капельница от запоя наркология в воронеже[/url]
Patricktip
20 Jul 25 at 12:07 am
https://woodhouse72.ru
Lesteretedy
20 Jul 25 at 12:11 am
оплата в китай hfbroker Платежные агенты для юридических лиц – это компании, оказывающие услуги по приему и перечислению платежей от юридических лиц. Они помогают компаниям оптимизировать процесс оплаты, снижая транзакционные издержки и обеспечивая прозрачность расчетов.
Jasondug
20 Jul 25 at 12:12 am
Анализ рынка услуг экстренной помощи в Тюмени позволяет выделить следующие ориентировочные цены:
Получить дополнительную информацию – [url=https://vyvod-iz-zapoya-vladimir00.ru/]вывод из запоя цены владимир[/url]
TimothyEvema
20 Jul 25 at 12:22 am
Реабилитация включает как амбулаторные, так и стационарные программы, адаптированные под индивидуальные потребности пациента. Применяется когнитивно-поведенческая терапия и групповые занятия, что способствует формированию устойчивой мотивации и предотвращению рецидивов. Подробнее о методах реабилитации доступно на портале Всемирной организации здравоохранения.
Изучить вопрос глубже – https://narkologicheskaya-klinika-sochi0.ru
DarwinGeada
20 Jul 25 at 12:23 am
Hi, its fastidious article concerning media print, we all
understand media is a wonderful source of facts.
토닥이
20 Jul 25 at 12:25 am
mail order pharmacy india [url=https://indiamedshub.com/#]india online pharmacy[/url] IndiaMedsHub
DavidRhinc
20 Jul 25 at 12:32 am
sms bomber usa
GerardobaR
20 Jul 25 at 12:33 am
mostbet mobil promo kod [url=https://mostbet4071.ru]https://mostbet4071.ru[/url]
mostbet_soEr
20 Jul 25 at 12:35 am
После поступления звонка нарколог оперативно выезжает по указанному адресу и прибывает в течение 30–60 минут. Врач незамедлительно приступает к оказанию помощи по четко отработанному алгоритму, состоящему из следующих этапов:
Подробнее тут – [url=https://narcolog-na-dom-voronezh00.ru/]vrach-narkolog-na-dom voronezh[/url]
StevenDag
20 Jul 25 at 12:38 am
металлические лестницы под заказ [url=www.lestnicy-na-metallokarkase-1.ru]www.lestnicy-na-metallokarkase-1.ru[/url] .
lestnici na metallokarkase_reKi
20 Jul 25 at 12:43 am
Самостоятельно выйти из запоя — почти невозможно. В Люберцах врачи клиники проводят медикаментозный вывод из запоя с круглосуточным выездом. Доверяйте профессионалам.
Исследовать вопрос подробнее – [url=https://kapelnica-ot-zapoya-lyubercy11.ru/]нарколог на дом недорого[/url]
Davidaerop
20 Jul 25 at 12:44 am
Этот метод направлен на выявление и замену негативных мыслей и стереотипов поведения, связанных с потреблением алкоголя. Пациент учится отслеживать свои эмоциональные реакции и заменять деструктивные установки конструктивными стратегиями противостояния стрессу.
Изучить вопрос глубже – [url=https://lechenie-alkogolizma-sochi0.ru/]центр лечения алкоголизма в сочи[/url]
WilliamToort
20 Jul 25 at 12:44 am
Discover the best barbershop experience in the CBD: MenSpire blends contemporary flair with traditional craftsmanship. Friendly pros, clean ambiance—your style, redefined.
GeorgeNeago
20 Jul 25 at 12:45 am
Наши специалисты выезжают в любой район Москвы и ближайшего Подмосковья, чтобы помочь пациентам избежать осложнений и быстро прийти в норму после длительного запоя.
Получить дополнительную информацию – [url=https://kapelnica-ot-zapoya-moskva0.ru/]вызвать капельницу от запоя на дому в москве[/url]
Michaelvoigo
20 Jul 25 at 12:45 am
Онлайн-консультация с психологом — это комфорт. Детский психолог онлайн поможет ребенку адаптироваться.
психолог калуга цены отзывы
Ernestpoive
20 Jul 25 at 12:46 am
I wanted to thank you for this great read!! I certainly enjoyed every little bit of
it. I’ve got you bookmarked to look at new things you post…
비닉스100mg
20 Jul 25 at 12:46 am
купить техническую воду [url=https://dostavka-tehnicheskoi-vodi.ru]https://dostavka-tehnicheskoi-vodi.ru[/url] .
dostavka tehnicheskoi vodi_yjoa
20 Jul 25 at 12:46 am
оценка швейцарских часов [url=http://ocenka-chasov-onlajn10.ru/]оценка швейцарских часов[/url] .
ocenka chasov onlain_tspr
20 Jul 25 at 12:47 am
Запой характеризуется накоплением токсинов и ухудшением работы внутренних органов. Чем дольше продолжается состояние интоксикации, тем выше риск серьезных осложнений. Помощь нарколога на дому позволяет начать детоксикацию в первые часы кризиса, что существенно повышает шансы на успешное восстановление и предотвращает развитие хронических заболеваний.
Получить дополнительную информацию – https://vyvod-iz-zapoya-vladimir0.ru
TerryAcith
20 Jul 25 at 12:51 am
Кракен – ты знаешь что это,
уже годами проверенный
сервис.
Недавно мы запустили p2p обмены и теперь вы можете обменивать любую сумму для пополнения.
Всегда есть свежая ссылка кракен через ВПН:
ссылка на kraken торговая площадка
homepage
20 Jul 25 at 12:52 am
kraken ios
DavidFoogs
20 Jul 25 at 12:54 am
вывод из запоя круглосуточно
vivod-iz-zapoya-krasnodar001.ru
вывод из запоя краснодар
vivodkrasnodarNeT
20 Jul 25 at 12:54 am
Проблема зависимости от алкоголя, наркотиков и азартных игр остается одной из наиболее острых в современном обществе. Эти состояния оказывают значительное воздействие не только на здоровье самого человека, но и на его семью, друзей и общественные связи. Наркологическая клиника “Восстановление души” предлагает широкий спектр услуг для тех, кто борется с различными формами зависимости, такими как алкоголизм, наркомания и игромания. Наша цель — предоставить комплексный подход к лечению, что обеспечивает высокие показатели успешности среди наших пациентов.
Получить больше информации – https://kapelnica-ot-zapoya-irkutsk2.ru/kapelnica-ot-zapoya-anonimno-v-irkutske/
GarlandVop
20 Jul 25 at 1:01 am