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!
In [url=https://www.netpropatch.tisindia.net/blog/exploring-casinos-that-are-not-on-gamstop-3/]https://www.netpropatch.tisindia.net/blog/exploring-casinos-that-are-not-on-gamstop-3/[/url] gamstop, you will find styles and functions that meet your needs, from American roulette to cutting edge versions of double ball.
KatrinaloF
17 Oct 25 at 8:12 pm
Ukrainian President Volodymyr Zelensky condemned Russian attacks on the Ukrainian regions of Kharkiv, Zaporizhzhia and Sumy on Monday, saying that the Kremlin intends to “humiliate diplomatic efforts” just hours before European leaders visit the White House.
[url=https://kra-42–cc.ru]kra41 at[/url]
“The Russian war machine continues to destroy lives despite everything,” Zelensky said in a statement, hours before he’s due to meet US President Donald Trump in the Oval Office. “That is precisely why we are seeking assistance to put an end to the killings. That is why reliable security guarantees are required. That is why Russia should not be rewarded for its participation in this war.”
[url=https://kra—42cc.ru]kra38 cc[/url]
“Everyone seeks dignified peace and true security,” the Ukrainian president said. “And at this very moment, the Russians are attacking Kharkiv, Zaporizhzhia, the Sumy region, and Odesa, destroying residential buildings and our civilian infrastructure.”
At least seven people were killed in Russia’s attack? on Kharkiv and a further three killed in the ballistic missile strike on the city of Zaporizhzhia, with scores more injured, according to Ukrainian authorities.
“This was a demonstrative and cynical Russian strike,” Zelensky added.
kra39 at
https://kra-42at.com
Danieljeove
17 Oct 25 at 8:13 pm
Very good info. Lucky me I found your blog by accident (stumbleupon).
I’ve saved as a favorite for later!
비아그라구입
17 Oct 25 at 8:15 pm
купить диплом инженера по охране труда [url=https://rudik-diplom12.ru]купить диплом инженера по охране труда[/url] .
Diplomi_sgPi
17 Oct 25 at 8:16 pm
https://t.me/s/Official_1xbet_1xbet/1723
Josephadvem
17 Oct 25 at 8:17 pm
https://t.me/Official_1xbet_1xbet/1799
Josephadvem
17 Oct 25 at 8:17 pm
Minotaurus coin’s audits by top firms reassure. Presale stage savings massive. Customizations await.
minotaurus presale
WilliamPargy
17 Oct 25 at 8:18 pm
mostbet uz [url=www.mostbet4182.ru]www.mostbet4182.ru[/url]
mostbet_uz_nckt
17 Oct 25 at 8:18 pm
mostbet skachat app [url=https://mostbet4185.ru/]https://mostbet4185.ru/[/url]
mostbet_uz_xfer
17 Oct 25 at 8:18 pm
купить диплом в сосновом бору [url=www.rudik-diplom12.ru]www.rudik-diplom12.ru[/url] .
Diplomi_ctPi
17 Oct 25 at 8:25 pm
можно купить диплом медсестры [url=http://frei-diplom14.ru/]можно купить диплом медсестры[/url] .
Diplomi_qjoi
17 Oct 25 at 8:25 pm
Realmente has desglosado el artículo de forma profesional.|
Impresionante, excelentes puntos clave relacionados con juegos de
azar.|
Valioso post. Mil gracias.|
Esto está muy bien escrito.|
Fantástico análisis, Se aprecia!|
Buen trabajo, Aprendí bastante con este análisis de casino|Sólido texto de plataformas online.|
Saludos! Gran colección de tips sobre juegos de azar aquí.
http://ecgs.gunpo.hs.kr/bbs/board.php?bo_table=free&wr_id=1848309
17 Oct 25 at 8:25 pm
linebet apk ios
linebet partners
17 Oct 25 at 8:28 pm
Snagged more $MTAUR; referrals pay. Presale’s value jumps. Minotaur customizable.
minotaurus presale
WilliamPargy
17 Oct 25 at 8:32 pm
The Playamo gaming casino platform presents outstanding entertainment with over 3,000 top-tier slots, classic games, and live gaming sessions from renowned software developers. From playing updated online slot games to employing your strategy at card games or diving into actual real-time casino entertainment, Playamo caters to all user preferences. With its refined, straightforward interface, the casino ensures effortless browsing throughout mobile and desktop, permitting you to use games at any time or location.
Playamo casino
AlfredLog
17 Oct 25 at 8:33 pm
Excellent post however , I was wanting to know if you
could write a litte more on this topic? I’d be very grateful if you could elaborate a little
bit more. Many thanks!
web site
17 Oct 25 at 8:35 pm
https://t.me/s/Official_1xbet_1xbet/1833
Josephadvem
17 Oct 25 at 8:39 pm
https://clocks-top.com/
RandallHen
17 Oct 25 at 8:39 pm
The $MTAUR token utility in unlocking special zones is what sets it apart from generic play-to-earn. Presale stage 1 savings are massive, up to 5x value. Team’s experience from top crypto projects adds credibility.
minotaurus ico
WilliamPargy
17 Oct 25 at 8:43 pm
http://tektura.phorum.pl/viewtopic.php?p=9753#9753
LarryBek
17 Oct 25 at 8:44 pm
https://www.credly.com/users/1xbet-promo-code-registration-pakistan-1xbet-promo-/edit#credly
Ernestlob
17 Oct 25 at 8:44 pm
https://t.me/Official_1xbet_1xbet/1643
Josephadvem
17 Oct 25 at 8:45 pm
https://t.me/Official_1xbet_1xbet/1668
Josephadvem
17 Oct 25 at 8:46 pm
OMT’s bite-sized lessons prevent bewilder, enabling progressive love
for mathematics tο grow and inspire consistent exam prep ѡork.
Broaden yoᥙr horizons ԝith OMT’s upcoming neԝ physical ɑrea opening
in Sеptember 2025, offering еven more opportunities for
hands-ⲟn math expedition.
In Singapore’ѕ extensive education ѕystem, where mathematics is obligatory and consumes ɑround 1600
hoսrs of curriculum time in primary and secondary schools,
math tuition Ƅecomes important tο assist students develop a strong structure fⲟr lifelong success.
Improving primary education ѡith math tuition prepares trainees fⲟr PSLE by cultivating a growth ѕtate of mind toᴡards difficult subjects
ⅼike symmetry аnd changes.
Recognizing and correcting specific weak pointѕ, ⅼike іn probability oг coordinate geometry, mɑkes
secondary tuition indispensable fⲟr O Level quality.
Math tuition at the junior college level stresses theoretical quality оveｒ memorizing memorization, іmportant for taking on application-based А Level inquiries.
OMT stands оut with іts exclusive math educational program, carefully developed tօ match
thе Singapore MOE syllabus Ьү completing conceptual voids
tһat typical school lessons mіght overlook.
OMT’ѕ system tracks your renovation օveｒ time sіa, motivating you to aim gгeater in mathematics
grades.
Tuition reveals trainees tο diverse concern types, broadening tһeir readiness fоr unpredictable
Singapore math exams.
Feel free t᧐ surf to mｙ webpage … Kaizenaire Math Tuition Centres Singapore
Kaizenaire Math Tuition Centres Singapore
17 Oct 25 at 8:48 pm
Технологии — это сила kraken ссылка зеркало кракен онион тор кракен онион зеркало кракен даркнет маркет
RichardPep
17 Oct 25 at 8:48 pm
My spouse and I stumbled over here from a different page and thought
I should check things out. I like what I see so i am just
following you. Look forward to exploring your web page yet again.
free investing tools
17 Oct 25 at 8:48 pm
I am regular visitor, how are you everybody?
This post posted at this site is genuinely fastidious.
https://subscribe.ru/author/32052355
17 Oct 25 at 8:50 pm
This design is steller! You definitely know how to keep a reader
amused. Between your wit and your videos, I was almost moved to start my own blog (well,
almost…HaHa!) Wonderful job. I really loved what you had to say, and more than that,
how you presented it. Too cool!
scott dylan
17 Oct 25 at 8:54 pm
купить аттестат школы [url=http://www.rudik-diplom12.ru]купить аттестат школы[/url] .
Diplomi_mjPi
17 Oct 25 at 8:57 pm
Great weblog right here! Also your website a lot up very
fast! What web host are you the usage of? Can I am getting your affiliate link in your host?
I desire my site loaded up as quickly as yours
lol
facts
17 Oct 25 at 8:58 pm
To restore energy and promote endurance, many athletes [url=https://epo-hgh.com/vero-epoetin-2000iu/]buy vero epoetin[/url] from reputable sources. This EPO-based formula increases hemoglobin levels, optimizes oxygen delivery, and boosts physical capacity. Used under proper supervision, it supports balanced performance and long-term recovery.
Dervabifutle
17 Oct 25 at 9:00 pm
лечение запоя
narkolog-krasnodar018.ru
экстренный вывод из запоя краснодар
zapojkrasnodarNeT
17 Oct 25 at 9:00 pm
Feel free to visit my website: high stakes Poker player
high stakes Poker player
17 Oct 25 at 9:04 pm
где заказать проект перепланировки квартиры [url=http://www.proekt-pereplanirovki-kvartiry16.ru]http://www.proekt-pereplanirovki-kvartiry16.ru[/url] .
proekt pereplanirovki kvartiri_tcMl
17 Oct 25 at 9:04 pm
Если вы ищете надежную клинику для вывода из запоя в Сочи, обратитесь в «Детокс». Здесь опытные специалисты окажут необходимую помощь в стационаре. Услуга доступна круглосуточно, анонимно и начинается от 2000 ?.
Подробнее можно узнать тут – [url=https://vyvod-iz-zapoya-sochi24.ru/]наркология вывод из запоя в сочи[/url]
Bryankax
17 Oct 25 at 9:06 pm
https://t.me/Official_1xbet_1xbet/1619
Josephadvem
17 Oct 25 at 9:08 pm
mostbet uz [url=https://www.mostbet4185.ru]https://www.mostbet4185.ru[/url]
mostbet_uz_rger
17 Oct 25 at 9:09 pm
Explore premium entertainment at Playamo gaming site with 3,000+ high-quality slot machines, table games, and live casino games from renowned software developers. The platform caters for all—experience recent video slots, demonstrate your skills at twenty-one, or engage in immersive live casino games. Featuring a sophisticated, intuitive layout, the venue guarantees effortless navigation via all devices, enabling you use top options at on your schedule.
Playamo casino
AlfredLog
17 Oct 25 at 9:10 pm
mostbet o’ynash [url=https://mostbet4182.ru]https://mostbet4182.ru[/url]
mostbet_uz_vekt
17 Oct 25 at 9:11 pm
Kaizenaire.com iѕ уоur website to Singapore’ѕ leading deals аnd occasion promotions.
Ƭhe vivid shopping scene іn Singapore, a true heaven fߋr purchasers, aligns effortlessly ԝith residents’ interest for promotions and deals.
Signing ᥙp wіth biking clubs develops area amongst pedal-pushing Singaporeans, and
ҝeep in mind tο remain upgraded оn Singapore’ѕ most current promotions and shopping deals.
Love, Bonito рrovides women’s garments ᴡith flexible designs, favored Ƅy Singaporean ladies fⲟr their complementary fits
аnd contemporary style.
Shopee, ɑ leading ecommerce ѕystem sia, offеrs every ⅼittle thing frⲟm gadgets to groceries lah, precious by Singaporeans f᧐r its flash
sales аnd uѕeｒ-friendly application lor.
LiHO Tea rejuvenates ԝith fruit teas and cheese foams, preferred Ьy citizens fοr vibrant, ingenious flavors that defeat tһe exotic heat.
Aunties claim leh, Kaizenaire.сom for cost savings one.
Lοok at my web ⲣage – Kaizenaire.com Promotions
Kaizenaire.com Promotions
17 Oct 25 at 9:11 pm
Представляем вашему вниманию национальные парки и заповедники России.
Между прочим, если вас интересует Изучение ООПТ России: парки, заповедники, водоемы, загляните сюда.
Смотрите сами:
[url=https://alloopt.ru]https://alloopt.ru[/url]
Спасибо за внимание! Надеюсь, вам было интересно.
fixRow
17 Oct 25 at 9:15 pm
https://t.me/Official_1xbet_1xbet/1649
Josephadvem
17 Oct 25 at 9:15 pm
Bullish on Minotaurus ICO’s viral referrals. $MTAUR utility strong. Sector expansion aids.
minotaurus ico
WilliamPargy
17 Oct 25 at 9:15 pm
https://t.me/s/Official_1xbet_1xbet/1771
Josephadvem
17 Oct 25 at 9:15 pm
прогноз на футбол [url=http://www.prognozy-na-futbol-9.ru]прогноз на футбол[/url] .
prognozi na fytbol_hjea
17 Oct 25 at 9:17 pm
http://medicosur.com/# mexico pharmacy
MervinWoorE
17 Oct 25 at 9:21 pm
заказать проект перепланировки [url=http://proekt-pereplanirovki-kvartiry16.ru]http://proekt-pereplanirovki-kvartiry16.ru[/url] .
proekt pereplanirovki kvartiri_mnMl
17 Oct 25 at 9:25 pm
Тысячи клиентов ежедневно пытаются найти гарантированный способ для входа на торговую площадку Kraken, сталкиваясь с множеством фейковых сайтов и неактуальной инструкциями. Дабы минимизировать подобные проблемы и сохранить ваше время, существует простое и эффективное место для поиска. [url=https://www.heroizutech.com.ng/]кракен даркнет ссылка[/url] Этот ресурс служит в качестве надежного источника рабочих ссылок, позволяя любому желающему в любой момент получить действующий адрес на площадку Кракен. Запомнив эту страницу, вы раз и навсегда решите проблему от необходимости выискивать рабочие ссылки на посторонних форумах, рискуя своей безопасностью.
Othex
17 Oct 25 at 9:27 pm
rvfxfa
📩 💰 Exclusive Deal - 1.25 BTC bonus available. Claim today > https://graph.org/Get-your-BTC-09-04?hs=7255fc1a3bb72291f146f9661674a5a8& 📩
17 Oct 25 at 9:29 pm
https://telegra.ph/Kupit-dron-dji-10-13-3
JesseHow
17 Oct 25 at 9:30 pm