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!
cheapest online pharmacy india: online pharmacy india – IndiaMedsHub
LewisSoump
19 Jul 25 at 7:48 pm
проведение валютных платежей Оплата криптой за invoice – это процесс перевода денежных средств поставщику в криптовалюте на основании выставленного им счета на оплату (инвойса). Он требует использования криптовалютных кошельков и соблюдения правил криптовалютных транзакций.
Jasondug
19 Jul 25 at 7:49 pm
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 маркетплейс зеркало
кракен ссылка
кракен даркнет кракен онион зеркало
RichardPep
19 Jul 25 at 7:56 pm
Психолог онлайн — это комфорт и конфиденциальность. Детский психолог онлайн работает с самыми маленькими клиентами.
кризисный психолог онлайн
Ernestpoive
19 Jul 25 at 8:07 pm
пансионат для пожилых с инсультом
pansionat-tula003.ru
пансионат после инсульта
izzapoyakrasnodarNeT
19 Jul 25 at 8:07 pm
low cost mexico pharmacy online: modafinil mexico online – sildenafil mexico online
BobbyAcany
19 Jul 25 at 8:09 pm
888starz sri lanka download [url=http://www.20bets.bet]888starz sri lanka download[/url] .
888starz_icOr
19 Jul 25 at 8:21 pm
кракен vk4
DavidFoogs
19 Jul 25 at 8:22 pm
вывод из запоя калуга
vivod-iz-zapoya-kaluga006.ru
вывод из запоя цена
izzapoyakalugaNeT
19 Jul 25 at 8:26 pm
Enjoy free spins and bonuses at Solpot Casino Solpot Casino is booming—join the fun at solpot.xl-gamers.com https://solpot.xl-gamers.com Play table games live at Solpot Casino: Experience the sophistication and strategic gameplay of classic table games like Blackjack, Roulette, and Baccarat in a live casino setting. Interact with professional dealers and other players, adding a social and engaging dimension to your gaming experience.
TerryFus
19 Jul 25 at 8:38 pm
платежи в международной торговле Услуга международных платежей – это сервис, предоставляемый банками и другими финансовыми организациями, который позволяет осуществлять переводы денежных средств между разными странами.
Jasondug
19 Jul 25 at 8:40 pm
Питание организовано по системе «шведский стол» с блюдами, соответствующими медицинским диетам: щадящие супы, нежирное мясо, свежие овощи и кисломолочные продукты. Рацион составляют диетолог и врач-нарколог с учётом индивидуальных потребностей.
Выяснить больше – [url=https://narkologicheskaya-klinika-sochi00.ru/]www.domen.ru[/url]
MichaelCrumn
19 Jul 25 at 8:53 pm
Hi there! I’m at work browsing your blog from my new apple iphone!
Just wanted to say I love reading your blog and look forward to all your posts!
Keep up the fantastic work!
взломать аккаунт
19 Jul 25 at 8:54 pm
После первичного осмотра начинается активная фаза детоксикации. Современные препараты вводятся капельничным методом для быстрого снижения уровня токсинов в крови и восстановления обменных процессов. Этот этап критически важен для нормализации работы печени, почек и сердечно-сосудистой системы.
Изучить вопрос глубже – [url=https://vyvod-iz-zapoya-vladimir000.ru/]вывод из запоя цены на дому владимир[/url]
MichaelBrees
19 Jul 25 at 9:02 pm
Клиника «НаркологикПлюс» предоставляет квалифицированную помощь нарколога на дому в Воронеже. Если вы или ваши близкие столкнулись с последствиями длительного употребления алкоголя или наркотиков, наши специалисты готовы оперативно выехать и оказать экстренную помощь. Мы проводим детоксикацию организма, снимаем симптомы абстинентного синдрома и стабилизируем состояние пациента, обеспечивая высокий уровень безопасности, строгую анонимность и индивидуальный подход.
Изучить вопрос глубже – [url=https://narcolog-na-dom-voronezh0.ru/]вызвать нарколога на дом воронеж[/url]
Lancenep
19 Jul 25 at 9:04 pm
IndiaMedsHub [url=http://indiamedshub.com/#]IndiaMedsHub[/url] Online medicine order
DavidRhinc
19 Jul 25 at 9:05 pm
sms bomber
GerardobaR
19 Jul 25 at 9:09 pm
Психолог онлайн решит ваши внутренние конфликты. Детский психолог онлайн разберется с детскими страхами.
детский психолог калуга
Ernestpoive
19 Jul 25 at 9:16 pm
кракен тор
DavidFoogs
19 Jul 25 at 9:17 pm
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
19 Jul 25 at 9:19 pm
агент по международным платежам Валютный агент платежный – это компания или физическое лицо, которое является валютным агентом и оказывает услуги по осуществлению платежей в иностранной валюте.
Jasondug
19 Jul 25 at 9:20 pm
Мы готовы предложить документы институтов, расположенных на территории всей РФ. Купить диплом университета:
[url=http://nujob.ch/companies/all-diplomy/]купить аттестат за 11 класс с занесением в[/url]
Diplomi_otPn
19 Jul 25 at 9:22 pm
пансионат для лежачих после инсульта
pansionat-tula003.ru
частный дом престарелых
narkologiyakrasnodarNeT
19 Jul 25 at 9:24 pm
Сразу после вызова нарколог приезжает для проведения детального осмотра. На этом этапе производится сбор анамнеза, измеряются жизненно важные показатели – пульс, артериальное давление, температура – и оценивается степень интоксикации.
Исследовать вопрос подробнее – [url=https://vyvod-iz-zapoya-vladimir0.ru/]анонимный вывод из запоя владимир[/url]
TerryAcith
19 Jul 25 at 9:31 pm
В клинике применяются разнообразные психотерапевтические техники, позволяющие адаптировать лечение под индивидуальные особенности пациента.
Детальнее – https://lechenie-alkogolizma-sochi0.ru/klinika-lecheniya-alkogolizma-v-sochi/
WilliamToort
19 Jul 25 at 9:33 pm
Наркологическая клиника «ЗдравЦентр» оказывает круглосуточную помощь пациентам, страдающим от алкогольной интоксикации. Наши специалисты выезжают в любой район Москвы и Московской области, чтобы оперативно поставить капельницу, снять симптомы абстиненции и восстановить здоровье пациента в комфортных домашних условиях.
Подробнее можно узнать тут – https://kapelnica-ot-zapoya-moskva00.ru/kapelnicza-ot-zapoya-czena-msk
JeremySIP
19 Jul 25 at 9:36 pm
лечение запоя калуга
vivod-iz-zapoya-kaluga006.ru
лечение запоя калуга
alkogolizmkalugaNeT
19 Jul 25 at 9:39 pm
Мы можем предложить документы любых учебных заведений, которые находятся на территории всей РФ. Купить диплом университета:
[url=http://aipair.io/read-blog/5290_kupit-attestat-10-11-klass.html/]купить аттестат за 11 класс в перми[/url]
Diplomi_gmPn
19 Jul 25 at 9:43 pm
https://indiamedshub.com/# online pharmacy india
Vernonhon
19 Jul 25 at 9:49 pm
Thanks very interesting blog!
Feel free to visit my blog; zborakul01
zborakul01
19 Jul 25 at 9:58 pm
Have yoou ever onsidered about adding a little biit ore tha ust your articles?
I mean, what yyou say is fundamentral aand everything. However think about iif yyou added some great imags orr vides too give yohr posxts more, “pop”!
Your content iss ecellent but with pics and video clips, his site could definitely bee oone off
thhe vedy best inn its field. Greast blog!
xnxx
19 Jul 25 at 9:59 pm
Drugs information. What side effects?
abilify medication injection
Actual trends of pills. Read here.
abilify medication injection
19 Jul 25 at 10:01 pm
bomber sms
GerardobaR
19 Jul 25 at 10:07 pm
kraken market
DavidFoogs
19 Jul 25 at 10:10 pm
Метод лечения
Ознакомиться с деталями – [url=https://narkologicheskaya-klinika-krasnodar00.ru/]наркологические клиники алкоголизм краснодарский край[/url]
Andreslah
19 Jul 25 at 10:12 pm
Мы готовы предложить документы любых учебных заведений, расположенных в любом регионе РФ. Купить диплом любого ВУЗа:
[url=http://reviews.wiki/index.php/User:TabathaJageurs/]купить аттестат за 11 класс в архангельске[/url]
Diplomi_bePn
19 Jul 25 at 10:13 pm
https://domsibiri.ru
Lesteretedy
19 Jul 25 at 10:19 pm
С психологом онлайн вы почувствуете себя лучше. Детский психолог онлайн поддержит в период изменений.
поговорить с психологом онлайн
Ernestpoive
19 Jul 25 at 10:26 pm
https://indiamedshub.shop/# reputable indian pharmacies
RobertEmard
19 Jul 25 at 10:28 pm
Во-вторых, реабилитация является неотъемлемой частью нашего подхода. Мы понимаем, что избавление от физической зависимости — это только первый шаг. Важной задачей является восстановление социального статуса, создание новых привычек и умение управлять своей жизнью без наркотиков или алкоголя. Наша клиника предлагает групповые и индивидуальные занятия, направленные на изменение поведения и мышления.
Ознакомиться с деталями – [url=https://kapelnica-ot-zapoya-irkutsk.ru/]капельница от запоя цена[/url]
Josephshoow
19 Jul 25 at 10:34 pm
Woah! I’m really digging the template/theme of this site.
It’s simple, yet effective. A lot of times it’s hard to get that “perfect balance” between user friendliness and
visual appeal. I must say you have done a great job
with this. In addition, the blog loads extremely fast
for me on Firefox. Excellent Blog!
Quora Ads
19 Jul 25 at 10:35 pm
как ставить экспресс в мелбет [url=www.melbet3004.com]www.melbet3004.com[/url]
melbet_nrMt
19 Jul 25 at 10:41 pm
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 onion
RichardPep
19 Jul 25 at 10:41 pm
It’s going to be ending of mine day, except before finish I am reading
this enormous post to improve my knowledge.
Real User Experience
19 Jul 25 at 10:48 pm
Каждый пациент уникален — именно поэтому мы не применяем «типовых» решений. После первичной консультации и диагностики специалисты «КубаньМед» разрабатывают персональную программу, учитывающую состояние здоровья, психологические особенности и социальные обстоятельства пациента.
Углубиться в тему – http://lechenie-alkogolizma-krasnodar0.ru
DonaldWrava
19 Jul 25 at 10:49 pm
Критерий
Ознакомиться с деталями – [url=https://narkologicheskaya-klinika-nizhnij-tagil11.ru/]частная наркологическая клиника в нижнем тагиле[/url]
Keithgek
19 Jul 25 at 10:50 pm
MediMexicoRx: tadalafil mexico pharmacy – п»їmexican pharmacy
LewisSoump
19 Jul 25 at 10:56 pm
Check the advanced settings of popcorn time and find the Cache Directory window, it will
show you the location of this folder on your computer and
you can open it.
download youtube video yt
19 Jul 25 at 10:56 pm
https://medimexicorx.com/# mexican rx online
RobertEmard
19 Jul 25 at 11:02 pm
kraken вход
DavidFoogs
19 Jul 25 at 11:04 pm