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!
купить диплом колледжа цена [url=https://frei-diplom10.ru]https://frei-diplom10.ru[/url] .
Diplomi_dvEa
21 Oct 25 at 11:03 pm
Если пациент не может приехать в клинику, в Краснодаре нарколог приедет к нему домой. Помощь оказывает «Детокс» круглосуточно.
Узнать больше – [url=https://narkolog-na-dom-krasnodar29.ru/]платный нарколог на дом в краснодаре[/url]
AllanHib
21 Oct 25 at 11:05 pm
SanteHommeFrance [url=https://santehommefrance.shop/#]sildenafil 50 mg ou 100 mg posologie[/url] pharmacie en ligne fiable France
CharlesNeono
21 Oct 25 at 11:05 pm
список seo [url=https://reiting-runeta-seo.ru]список seo[/url] .
reiting ryneta seo_gmma
21 Oct 25 at 11:06 pm
топ seo продвижение заказать [url=https://reiting-kompanii-po-prodvizheniyu-sajtov.ru]https://reiting-kompanii-po-prodvizheniyu-sajtov.ru[/url] .
agentstvo poiskovogo prodvijeniya_uuKt
21 Oct 25 at 11:07 pm
Адекватное лечение, комфорт и забота — так проходят дни в стационаре «Частного Медика 24» во время вывода из запоя.
Детальнее – http://vyvod-iz-zapoya-v-stacionare-samara24.ru
JamessoypE
21 Oct 25 at 11:08 pm
seo раскрутка продвижение [url=www.reiting-runeta-seo.ru]seo раскрутка продвижение[/url] .
reiting ryneta seo_vfma
21 Oct 25 at 11:09 pm
рейтинг компаний по продвижению сайтов [url=http://www.seo-prodvizhenie-reiting.ru]рейтинг компаний по продвижению сайтов[/url] .
seo prodvijenie reiting_uxEa
21 Oct 25 at 11:10 pm
раскрутка сайта москва [url=http://reiting-seo-agentstv-moskvy.ru/]раскрутка сайта москва[/url] .
reiting seo agentstv moskvi_dvMl
21 Oct 25 at 11:10 pm
лучшие seo агентства [url=https://reiting-seo-kompanii.ru]лучшие seo агентства[/url] .
reiting seo kompanii_mwsn
21 Oct 25 at 11:11 pm
seo agentura [url=https://reiting-seo-agentstv.ru/]seo agentura[/url] .
reiting seo agentstv_ocsa
21 Oct 25 at 11:13 pm
BluePeakMeds: discreet shipping for ED medication – Sildenafil side effects and safe dosage
AnthonySep
21 Oct 25 at 11:14 pm
рейтинг агентств digital россии [url=https://luchshie-digital-agencstva.ru/]https://luchshie-digital-agencstva.ru/[/url] .
lychshie digital agentstva_nzoi
21 Oct 25 at 11:15 pm
рейтинг компаний по продвижению сайтов [url=seo-prodvizhenie-reiting.ru]рейтинг компаний по продвижению сайтов[/url] .
seo prodvijenie reiting_hpEa
21 Oct 25 at 11:19 pm
рейтинг компаний seo оптимизации [url=reiting-seo-kompanii.ru]reiting-seo-kompanii.ru[/url] .
reiting seo kompanii_uosn
21 Oct 25 at 11:19 pm
компании по продвижению сайта [url=reiting-kompanii-po-prodvizheniyu-sajtov.ru]reiting-kompanii-po-prodvizheniyu-sajtov.ru[/url] .
agentstvo poiskovogo prodvijeniya_pwKt
21 Oct 25 at 11:21 pm
сео продвижение сайтов 10 [url=http://www.reiting-runeta-seo.ru]http://www.reiting-runeta-seo.ru[/url] .
reiting ryneta seo_zqma
21 Oct 25 at 11:22 pm
Лечение запоя на дому с помощью капельницы – оптимальный способ для борьбы с алкоголизмом. Обращение к наркологу в Красноярске позволяет получить квалифицированную помощь при алкоголизме прямо на дому. Часто родственникам сложно уговорить зависимого на лечение, но необходимо учитывать психологической поддержке и профессиональной помощи нарколога; вызов нарколога Красноярск Процесс начинается с детоксикацию организма, что помогает организму восстановиться после запойного состояния. Услуги нарколога включают капельницы, которые облегчают симптоматику. Профилактика запойного состояния имеет огромное значение для предотвращения рецидивов. Нарколог на дому проводит психотерапевтические занятия для зависимых, что способствует успешному лечению алкоголизма. Не забывайте, что помощь при алкоголизме доступна, и лечение алкоголизма на дому – это реальный вариант для многих.
lecheniekrasnoyarskNeT
21 Oct 25 at 11:22 pm
топ агентств seo продвижения [url=www.reiting-seo-kompanii.ru]www.reiting-seo-kompanii.ru[/url] .
reiting seo kompanii_yqsn
21 Oct 25 at 11:22 pm
StopKor — портал журналистских расследований о коррупции, бизнесе и обществе: авторские материалы, досье и аналитика, обновления по резонансным делам. Проекты выходят на украинском и русском языках, с источниками, датами и контекстом. Удобная навигация по рубрикам «Розслідування», «Економіка», «Злочинність» ускоряет поиск. Изучите публикации на https://stopkor.info/ — следите за новыми выпусками и архивом материалов. Портал создан для тех, кто ценит факты, доказательность и прозрачность.
xikebhApade
21 Oct 25 at 11:22 pm
Hello my loved one! I want to say that this article is amazing,
great written and include approximately all significant infos.
I’d like to look more posts like this .
창문시트지
21 Oct 25 at 11:23 pm
Potenzmittel rezeptfrei kaufen: Sildenafil Wirkung und Dosierung – Viagra rezeptfreie Schweiz bestellen
WilliamUnjup
21 Oct 25 at 11:25 pm
купить диплом техникума в украине пять плюс [url=www.frei-diplom9.ru/]купить диплом техникума в украине пять плюс[/url] .
Diplomi_mjea
21 Oct 25 at 11:25 pm
Скорая наркологическая помощь – это необходимая услуга, который оказывает необходимую помощь людям, имеющим проблемы с зависимостями. В трудной ситуации, когда нужна экстренная помощь, на помощь выходит на помощь наркологическая служба. Преодоление зависимостей включает лекарственное лечение и всеобъемлющую реабилитацию наркозависимых. При алкоголизме срочная помощь крайне важна. Обращение к психологу может быть первым шагом на пути к выздоровлению. Поддержка семьи является важным аспектом реабилитации. Группы поддержки и психотерапевтические сеансы помогают справиться с трудностями. Предупреждение наркозависимости также не менее важна. Борьба с наркотиками не может быть эффективной без участия общества. Обращение за помощью на сайте vivod-iz-zapoya-vladimir029.ru даст возможность найти нужные ресурсы для старта новой, трезвой жизни.
zapojvladimirNeT
21 Oct 25 at 11:25 pm
Если пациент не может приехать в клинику, в Краснодаре нарколог приедет к нему домой. Помощь оказывает «Детокс» круглосуточно.
Получить больше информации – [url=https://narkolog-na-dom-krasnodar29.ru/]нарколог на дом краснодар[/url]
AllanHib
21 Oct 25 at 11:27 pm
раскрутка сайтов москва [url=www.reiting-seo-agentstv-moskvy.ru/]раскрутка сайтов москва[/url] .
reiting seo agentstv moskvi_sqMl
21 Oct 25 at 11:28 pm
агентство seo [url=https://www.seo-prodvizhenie-reiting.ru]агентство seo[/url] .
seo prodvijenie reiting_jhEa
21 Oct 25 at 11:29 pm
услуги seo компании [url=reiting-seo-agentstv.ru]услуги seo компании[/url] .
reiting seo agentstv_mrsa
21 Oct 25 at 11:30 pm
капремонт двигателей цена [url=https://dzen.ru/a/aO5JcSrFuEYaWtpN/]https://dzen.ru/a/aO5JcSrFuEYaWtpN/[/url] .
Reiting avtoservisov po kapitalnomy remonty dvigatelei v Moskve_mzsi
21 Oct 25 at 11:32 pm
This is a very good tip particularly to those
new to the blogosphere. Brief but very accurate information… Many thanks for sharing this one.
A must read article!
Anchor Gainlux
21 Oct 25 at 11:35 pm
seo top agencies [url=http://reiting-seo-kompanii.ru/]http://reiting-seo-kompanii.ru/[/url] .
reiting seo kompanii_mxsn
21 Oct 25 at 11:36 pm
schweizer sportwetten einzelwetten strategie anbieter
sportwetten einzelwetten strategie
21 Oct 25 at 11:36 pm
Hi my loved one! I want to say that this article is amazing, great
written and come with almost all important infos. I’d like to look more posts like
this .
casino utan svensk licens
21 Oct 25 at 11:36 pm
kraken
Also visit my homepage кракен тор
кракен тор
21 Oct 25 at 11:37 pm
рейтинг агентств по seo [url=http://www.luchshie-digital-agencstva.ru]рейтинг агентств по seo[/url] .
lychshie digital agentstva_rzoi
21 Oct 25 at 11:38 pm
заказать кухню спб [url=www.kuhni-spb-2.ru]www.kuhni-spb-2.ru[/url] .
kyhni spb_rpmn
21 Oct 25 at 11:39 pm
Добрый день!
Покупка — это просто: купить постоянный виртуальный номер в два клика. Наш сайт позволяет легко купить постоянный виртуальный номер. Вы получите стабильную связь, решив купить постоянный виртуальный номер. Убедитесь, как удобно купить постоянный виртуальный номер у нас. Доверяйте профессионалам, чтобы купить постоянный виртуальный номер.
Полная информация по ссылке – https://elihim.ru/virtualnyj-nomer-telefona-belorussii-vozmozhnosti-dlya-biznesa-i-obshheniya/
купить виртуальный номер навсегда, купить постоянный виртуальный номер, купить номер телефона навсегда
купить виртуальный номер навсегда, купить номер телефона навсегда, купить виртуальный номер для смс навсегда
Удачи и комфорта в общении!
Lynwoodassok
21 Oct 25 at 11:39 pm
seo продвижение сайта заказать в москве [url=http://www.reiting-seo-agentstv-moskvy.ru]seo продвижение сайта заказать в москве[/url] .
reiting seo agentstv moskvi_tmMl
21 Oct 25 at 11:41 pm
expandyourhorizons – Great resource for inspiration when you’re ready to move ahead in life.
Kelsi Kleinwolterin
21 Oct 25 at 11:41 pm
I am not sure where you’re getting your information, but great topic.
I needs to spend some time learning much more or
understanding more. Thanks for great information I was looking for this information for
my mission.
fire damage cleanup
21 Oct 25 at 11:41 pm
Если вы хотите получить дополнительных бонусов от компании 1xBet, следует соблюсти ряд правил, хотя промокоды позволяют получить их быстрее и проще.Размеры бонусов, доступных игрокам через промокоды 1xBet, варьируются, но даже умеренный бонус способен значительно расширить возможности для игры клиента.Активируйте промокод, чтобы получить 100% бонус в 2026 году.Промокод можно найти по ссылке ниже: промокод 1xbet получить.
Jasonbrado
21 Oct 25 at 11:42 pm
top seo company [url=https://www.seo-prodvizhenie-reiting.ru]top seo company[/url] .
seo prodvijenie reiting_vsEa
21 Oct 25 at 11:42 pm
сео интернет [url=https://reiting-runeta-seo.ru/]сео интернет[/url] .
reiting ryneta seo_cbma
21 Oct 25 at 11:43 pm
explorethepossibilitiesnow – Found several actionable tips on branching out and expanding horizons.
Jc Courtwright
21 Oct 25 at 11:44 pm
Hello there! I know this is kinda off topic but I was wondering which blog platform
are you using for this website? I’m getting tired of WordPress because I’ve had problems
with hackers and I’m looking at alternatives for another platform.
I would be fantastic if you could point me in the direction of a good platform.
Pocket Option
21 Oct 25 at 11:44 pm
сео компании [url=https://reiting-seo-agentstv.ru]сео компании[/url] .
reiting seo agentstv_stsa
21 Oct 25 at 11:47 pm
Minotaurus coin’s utility in boosts and customizations is practical. ICO’s community building events foster loyalty. Early stage feels opportunistic. minotaurus token
WilliamPargy
21 Oct 25 at 11:48 pm
рекламное агентство seo [url=http://www.reiting-seo-kompanii.ru]рекламное агентство seo[/url] .
reiting seo kompanii_lpsn
21 Oct 25 at 11:48 pm
Если вы ищете надежную клинику для вывода из запоя, обратитесь в «Детокс» в Краснодаре. Услуга вызова нарколога на дом доступна круглосуточно. Врачи приедут к вам в течение 1–2 часов и окажут необходимую помощь.
Детальнее – [url=https://narkolog-na-dom-krasnodar28.ru/]выезд нарколога на дом краснодар[/url]
StephenTuple
21 Oct 25 at 11:48 pm
оптимизация сайта под продвижение [url=https://www.reiting-runeta-seo.ru]оптимизация сайта под продвижение[/url] .
reiting ryneta seo_pama
21 Oct 25 at 11:51 pm