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!
Sweet Bonanza giris adresi en guncel baglant?yla burada
sweet_bonanza-645
17 Jul 25 at 5:24 pm
кракен ссылка
DavidFoogs
17 Jul 25 at 5:29 pm
Sweet Bonanza Turkiye’nin en cok tercih edilen slot oyunudur
sweet_bonanza-112
17 Jul 25 at 5:31 pm
лучшие прогнозы на футбол [url=www.prognozy-na-futbol-1.ru/]www.prognozy-na-futbol-1.ru/[/url] .
prognozi na fytbol_hvsi
17 Jul 25 at 5:35 pm
https://aylita.ru
Lesteretedy
17 Jul 25 at 5:36 pm
вывод из запоя челябинск
[url=https://vivod-iz-zapoya-chelyabinsk001.ru]https://vivod-iz-zapoya-chelyabinsk001.ru[/url]
вывод из запоя цена
lecheniechelyabinskNeT
17 Jul 25 at 5:40 pm
Алкогольная и наркотическая зависимости требуют незамедлительного медицинского вмешательства. Длительные запои или острое отравление могут привести к тяжелым осложнениям и серьезным проблемам со здоровьем. Клиника «МедТрезвость» в Санкт-Петербурге предлагает квалифицированную наркологическую помощь прямо на дому, обеспечивая полную конфиденциальность и безопасность пациента. Наши специалисты оперативно выезжают по адресу, проводят все необходимые процедуры и помогают максимально быстро стабилизировать состояние пациента в комфортных домашних условиях.
Выяснить больше – [url=https://narcolog-na-dom-sankt-peterburg0.ru/]вызов нарколога на дом ленинградская область[/url]
CalvinSib
17 Jul 25 at 5:40 pm
Обращение за помощью на дому имеет ряд неоспоримых преимуществ, особенно для тех, кто ценит конфиденциальность и стремится избежать дополнительных стрессовых факторов, связанных с посещением клиники:
Изучить вопрос глубже – [url=https://narcolog-na-dom-ufa00.ru/]нарколог на дом уфа[/url]
Peterappog
17 Jul 25 at 5:44 pm
Комплексная терапия при выводе из запоя на дому включает в себя два основных направления: медикаментозную детоксикацию и психологическую поддержку. Такой подход позволяет добиться быстрого и устойчивого эффекта, минимизируя риск осложнений и обеспечивая долгосрочную ремиссию.
Подробнее можно узнать тут – [url=https://narcolog-na-dom-ufa000.ru/]нарколог на дом стоимость в уфе[/url]
Vincentdow
17 Jul 25 at 5:45 pm
Когда организм на пределе, важна срочная помощь в Люберцах — это команда опытных наркологов, которые помогут быстро и мягко выйти из запоя без вреда для здоровья.
[url=https://kapelnica-ot-zapoya-lyubercy12.ru/]капельница от запоя в люберцах[/url] – [url=https://kapelnica-ot-zapoya-lyubercy12.ru/]капельница от запоя на дому цена[/url]
Lymanbot
17 Jul 25 at 5:46 pm
Pills information sheet. Brand names.
can you get azelastine without prescription
Some information about medicament. Get now.
can you get azelastine without prescription
17 Jul 25 at 5:49 pm
Домашний вывод из запоя подходит тем, кто сохраняет относительно стабильные жизненные показатели и нуждается в минимальном мониторинге. Врач приезжает в удобное для вас время, проводит все необходимые манипуляции в привычной обстановке и остаётся на связи после процедуры для оперативной консультации.
Изучить вопрос глубже – [url=https://vyvod-iz-zapoya-reutov4.ru/]anonimnyj vyvod iz zapoya[/url]
Jeromeincub
17 Jul 25 at 5:49 pm
Клиника «МедАльянс» оказывает профессиональную медицинскую помощь на дому в Москве и Московской области круглосуточно. Опытные врачи-наркологи приедут в течение часа после вызова, проведут полную диагностику, поставят капельницу и быстро вернут пациента в стабильное состояние.
Углубиться в тему – [url=https://kapelnica-ot-zapoya-moskva000.ru/]вызвать капельницу от запоя[/url]
Jamesblins
17 Jul 25 at 5:51 pm
купить аттестат 11 классов ставрополь [url=www.arus-diplom24.ru/]купить аттестат 11 классов ставрополь[/url] .
Diplomi_pnKn
17 Jul 25 at 5:51 pm
Заказать диплом можно используя сайт компании. [url=http://bs.listbb.ru/viewtopic.php?f=3&t=2006/]bs.listbb.ru/viewtopic.php?f=3&t=2006[/url]
Sazrhyx
17 Jul 25 at 5:51 pm
Kazand?ran oyun Sweet Bonanza simdi yay?nda
sweet_bonanza-680
17 Jul 25 at 5:56 pm
купить аттестат в украине об окончании 11 класса [url=https://www.arus-diplom22.ru]https://www.arus-diplom22.ru[/url] .
Diplomi_ifsl
17 Jul 25 at 5:56 pm
Обращение к врачу требуется в тех случаях, когда человек не может самостоятельно справиться с последствиями запоя, а отказ от медицинской помощи может привести к серьезным осложнениям.
Исследовать вопрос подробнее – http://kapelnica-ot-zapoya-moskva0.ru/
Shawnsnala
17 Jul 25 at 5:58 pm
Онлайн-психолог — это забота о душе. Детский психолог онлайн поддержит в период изменений.
детский психолог калуга хороший отзывы
Ernestpoive
17 Jul 25 at 6:01 pm
После поступления вызова нарколог клиники «АльфаНаркология» оперативно выезжает по указанному адресу. На месте врач проводит первичную диагностику, оценивая степень интоксикации, физическое и психологическое состояние пациента. По результатам осмотра врач подбирает индивидуальный комплекс лечебных процедур, в который входит постановка капельницы с растворами для детоксикации, препараты для стабилизации работы органов и нормализации психического состояния.
Подробнее – [url=https://narcolog-na-dom-sankt-peterburg000.ru/]вызов нарколога на дом ленинградская область[/url]
NormanIncib
17 Jul 25 at 6:03 pm
купить диплом с занесением в реестр москва [url=www.arus-diplom32.ru]купить диплом с занесением в реестр москва[/url] .
Zakazat diplom lubogo yniversiteta!_ubEn
17 Jul 25 at 6:07 pm
https://zorgpakket.shop/# apothekers
WilliamNog
17 Jul 25 at 6:11 pm
Dragon money В Драгон мани существует множество фракций, каждая из которых стремится контролировать уникальные ресурсы и артефакты. Эти фракции могут быть как союзниками, так и врагами. Умение налаживать связи и выбирать правильные стратегии становится залогом успеха. Каждое взаимодействие с другими игроками обогащает опыт и открывает новые горизонты, заказывая не только материальные ценности, но и внутриигровую репутацию.
WoodrowNuare
17 Jul 25 at 6:11 pm
стеклянные ограждения Душевые кабины из стекла — это не только практичное, но и стильное решение для ванных комнат. Они легко вписываются в любой интерьер, от классики до хайтека, создавая современный и чистый вид. Дешевая перегородка
Dannyfaign
17 Jul 25 at 6:13 pm
где можно купить аттестат за 11 класс в иркутске [url=https://arus-diplom22.ru/]где можно купить аттестат за 11 класс в иркутске[/url] .
Diplomi_bnsl
17 Jul 25 at 6:14 pm
Yeni giris adresiyle Sweet Bonanza her zaman ulas?labilir
sweet_bonanza-404
17 Jul 25 at 6:15 pm
профессиональные прогнозы на спорт [url=www.prognozy-na-sport-3.ru]www.prognozy-na-sport-3.ru[/url] .
prognozi na sport_aaen
17 Jul 25 at 6:16 pm
S?n?rs?z bonuslar icin Sweet Bonanza giris yap
sweet_bonanza-425
17 Jul 25 at 6:17 pm
mijn medicijnkosten [url=https://zorgpakket.shop/#]Medicijn Punt[/url] medicijnen online bestellen
ScottFup
17 Jul 25 at 6:18 pm
Nice post. I used to be checking continuously this blog and I am
impressed! Extremely useful information specially the remaining
section 🙂 I care for such info much. I was seeking this certain info for a long time.
Thanks and best of luck.
casino promo
17 Jul 25 at 6:22 pm
blacksprut зеркало
RichardPep
17 Jul 25 at 6:25 pm
стеклянные перегородки Для тех, кто ищет доступные решения, дешевая перегородка — отличный выбор. Она может быть выполнена из различных бюджетных материалов, сохраняя при этом все функции и эстетические качества. Душевая перегородка из стекла
Dannyfaign
17 Jul 25 at 6:30 pm
Tremendous things here. I am very satisfied to look
your post. Thanks a lot and I’m taking a look ahead to touch you.
Will you kindly drop me a mail?
Guadagno Relmar
17 Jul 25 at 6:33 pm
Игроки часто ищут вавада казино, и не зря — именно такие платформы обеспечивают честную игру и качественный сервис. Если вас интересует вавада казино, рекомендуем заглянуть сюда: вавада казино. Вы узнаете о бонусах, мобильной версии, рабочих зеркалах и многом другом. Проверяйте сами — вавада казино может приятно удивить!
Matthewrhica
17 Jul 25 at 6:37 pm
Запой – критическое состояние, грозящее жизни! Не ждите, вызывайте нарколога в Волгоградской области круглосуточно! Не важно, день или ночь – нарколог приедет к вам в любое время! Мы гарантируем быструю, безопасную и индивидуальную помощь. Мы гарантируем быструю и надежную помощь при запое. Мы готовы помочь вам, где бы вы ни находились – дома или в клинике! Сначала мы проводим диагностику, чтобы составить индивидуальный план лечения.
Выяснить больше – [url=https://vyvod-iz-zapoya-volgograd000.ru/]вывод из запоя цены волгоград[/url]
DavidVeget
17 Jul 25 at 6:38 pm
где купить аттестат за 11 класс екатеринбург [url=arus-diplom22.ru]где купить аттестат за 11 класс екатеринбург[/url] .
Diplomi_hcsl
17 Jul 25 at 6:39 pm
Запой – это крайняя степень алкоголизма, требующая профессионального вмешательства. Нарколог на дом в Волгограде – ваш выбор. Лечение на дому помогает избежать стресса и сохранить анонимность, получив необходимую помощь. Важно как можно быстрее начать лечение, чтобы избежать токсического воздействия алкоголя на организм. Лечение на дому направлено на очищение организма, восстановление баланса и нормальную работу органов. Для достижения долгосрочного результата важно сочетать медикаментозную терапию и психологическую поддержку. Начинаем с детоксикации, используя капельницы и современные препараты.
Выяснить больше – http://vyvod-iz-zapoya-volgograd0.ru/vyvod-iz-zapoya-kruglosutochno-volgograd/
Michaelacism
17 Jul 25 at 6:43 pm
бесплатные прогнозы на спорт с высокой проходимостью [url=https://prognozy-na-sport-3.ru/]бесплатные прогнозы на спорт с высокой проходимостью[/url] .
prognozi na sport_mmen
17 Jul 25 at 6:45 pm
Клиника “Обновление” также активно занимается просветительской деятельностью. Мы организуем семинары и лекции, которые помогают обществу лучше понять проблемы зависимостей, их последствия и пути решения. Повышение осведомленности является важным шагом на пути к улучшению ситуации в этой области.
Получить больше информации – https://kapelnica-ot-zapoya-irkutsk.ru/kapelnica-ot-zapoya-v-stacionare-v-irkutske/
JamieanceP
17 Jul 25 at 6:45 pm
Согласно данным Федерального наркологического центра, своевременный выезд врача снижает риск осложнений и повторных госпитализаций.
Ознакомиться с деталями – https://narkolog-na-dom-kamensk-uralskij11.ru/narkolog-na-dom-kruglosutochno-v-kamensk-uralskom/
WillieDek
17 Jul 25 at 6:46 pm
купить аттестат 11 класс вечерней школы [url=https://www.arus-diplom21.ru]https://www.arus-diplom21.ru[/url] .
Diplomi_jbPr
17 Jul 25 at 6:56 pm
For other fans out there who are searching for hard-to-find COD prints, be sure to monitor places like Redbubble for unique custom designs,
and always keep an eye on online auctions for vintage Call of Duty printings.
Sometimes stumble upon a hidden treasure if you are patient.
game poster art
17 Jul 25 at 6:57 pm
Затяжной запой опасен для жизни. Врачи наркологической клиники в Люберцах проводят срочный вывод из запоя — на дому или в стационаре. Анонимно, безопасно, круглосуточно.
[url=https://kapelnica-ot-zapoya-lyubercy13.ru/]капельница от запоя на дому в люберцах[/url] – [url=https://kapelnica-ot-zapoya-lyubercy13.ru/]kapelnicza-ot-zapoya lyubercy[/url]
BenitoPet
17 Jul 25 at 6:57 pm
Thanks designed for sharing such a fastidious opinion, paragraph is good, thats why i have read it entirely
koitoto togel
17 Jul 25 at 7:01 pm
apotek jourГ¶ppet: Snabb Apoteket – nГ¤tapoteket
Kennethrip
17 Jul 25 at 7:05 pm
Психолог онлайн решит ваши проблемы. Детский психолог онлайн научит ребенка самоконтролю.
онлайн сессия с психологом
Ernestpoive
17 Jul 25 at 7:07 pm
Самостоятельно выйти из запоя — почти невозможно. В Химках врачи клиники проводят медикаментозный вывод из запоя с круглосуточным выездом. Доверяйте профессионалам.
Получить дополнительные сведения – [url=https://vyvod-iz-zapoya-himki11.ru/]вывод из запоя на дому круглосуточно город химки[/url]
Nicoleemoft
17 Jul 25 at 7:08 pm
купить аттестат за 11 классов в волгограде [url=http://www.arus-diplom22.ru]купить аттестат за 11 классов в волгограде[/url] .
Diplomi_rhKt
17 Jul 25 at 7:10 pm
Алкогольный делирий тяжелое состояние , развивающееся из-за зависимости от алкоголя. Симптомы включают такие симптомы, как спутанность сознания, галлюцинации, тремор и проблемы со сном. Выездной нарколог в Туле может оказать экстренную помощь при запое и диагностировать алкогольный синдром . Лечение делирия включает медикаментозную терапию для стабилизации состояния пациента. Важно также провести психотерапию для зависимых , которая поможет справиться с психологическими аспектами зависимости ; Для успешной реабилитации алкоголиков необходима поддержка близких, чтобы они могли понять признаки алкогольного делирия и оказать помощь при алкоголизме . Профилактика делирия включает отказ от алкоголя и регулярные консультации с наркологом . Нарколог на дом в Туле предоставляет комплексные наркологические услуги, включая лечение на дому . нарколог на дом тула
alkogolizmtulaNeT
17 Jul 25 at 7:12 pm
Услуга вызова нарколога на дом в Уфе разработана для оперативного вывода из запоя без необходимости госпитализации. Это особенно актуально для тех, кто столкнулся с алкогольной интоксикацией в условиях, когда каждая минута имеет значение. Своевременная помощь позволяет не только устранить негативное воздействие алкоголя на организм, но и предотвратить возможные осложнения, такие как нарушения работы сердца, печени и почек.
Подробнее – http://narcolog-na-dom-ufa0.ru
KennethRem
17 Jul 25 at 7:18 pm