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!
Estou completamente ressonado por Stake Casino, parece uma camara de ecos cheia de adrenalina. As escolhas sao vibrantes como um sino. oferecendo lives que explodem como ecos. Os agentes sao rapidos como uma onda sonora. garantindo suporte direto e sem silencio. As transacoes sao simples como um reverb. as vezes mais giros gratis seriam vibrantes. Em sintese, Stake Casino promete uma diversao que e uma onda sonora para os exploradores de jogos online! E mais o site e uma obra-prima de estilo sonoro. elevando a imersao ao nivel de um coral.
stake apuestas|
twistyneonemu4zef
17 Sep 25 at 6:28 pm
Сайт Weird Movies предлагает своим посетителям погрузиться
в мир странных и необычных фильмов.
https://advaitasuperspecialitydental.com/samye-populjarnye-virtualnye-igornye-zavedenija-s-privilegijami-i-vostrebovannymi-slotami/
17 Sep 25 at 6:28 pm
This post is worth everyone’s attention. When can I find out more?
casino slots online
17 Sep 25 at 6:30 pm
купить диплом бакалавра дешево [url=educ-ua5.ru]купить диплом бакалавра дешево[/url] .
Diplomi_fsKl
17 Sep 25 at 6:30 pm
купить аттестат 11 класс вечерней школы [url=https://www.arus-diplom25.ru]https://www.arus-diplom25.ru[/url] .
Diplomi_xiot
17 Sep 25 at 6:30 pm
Create Rsss For Managing Costs And Display Rss Feed submit (Hayley)
Hayley
17 Sep 25 at 6:33 pm
турецкие сериалы на русском языке [url=kinogo-14.top]турецкие сериалы на русском языке[/url] .
kinogo_mzEl
17 Sep 25 at 6:34 pm
микрозаймы онлайн [url=https://zaimy-11.ru]https://zaimy-11.ru[/url] .
zaimi_jePt
17 Sep 25 at 6:35 pm
смотреть фильмы бесплатно [url=https://www.kinogo-15.top]смотреть фильмы бесплатно[/url] .
kinogo_bvsa
17 Sep 25 at 6:35 pm
We’re a bunch of volunteers and startig a new scheme in our
community. Your web site offered uss with udeful information to work on.
You’ve performed a formidable jobb and ourr entire neighborhood can bbe thankful to you.
Rickie
17 Sep 25 at 6:35 pm
Thanks for sharing your thoughts on results-exams. Regards
جواب امتحانات شهریور کی میاد
17 Sep 25 at 6:36 pm
купить дипломы вуза о высшем образовании [url=https://educ-ua18.ru]купить дипломы вуза о высшем образовании[/url] .
Diplomi_xqPi
17 Sep 25 at 6:36 pm
kinogo [url=http://www.kinogo-14.top]kinogo[/url] .
kinogo_ydEl
17 Sep 25 at 6:38 pm
Woah! I’m really enjoying the template/theme of this website.
It’s simple, yet effective. A lot of times it’s
difficult to get that “perfect balance” between superb usability and visual appearance.
I must say you’ve done a fantastic job with this. Additionally, the blog loads super quick for me
on Firefox. Exceptional Blog!
پول ساز ترین بازی
17 Sep 25 at 6:38 pm
купить диплом украина харьков [url=http://www.educ-ua4.ru]купить диплом украина харьков[/url] .
Diplomi_tqPl
17 Sep 25 at 6:40 pm
где можно купить аттестат [url=https://educ-ua20.ru]где можно купить аттестат[/url] .
Diplomi_zuEn
17 Sep 25 at 6:40 pm
купить диплом о высшем образовании в николаеве [url=http://educ-ua5.ru]купить диплом о высшем образовании в николаеве[/url] .
Diplomi_acKl
17 Sep 25 at 6:41 pm
https://push-network-rankings.com/
Brianfub
17 Sep 25 at 6:42 pm
купить аттестат за 11 классов саратов [url=www.arus-diplom25.ru/]купить аттестат за 11 классов саратов[/url] .
Diplomi_fyot
17 Sep 25 at 6:42 pm
сайт микрозаймов [url=http://www.zaimy-12.ru]http://www.zaimy-12.ru[/url] .
zaimi_qfSt
17 Sep 25 at 6:42 pm
сайт микрозаймов [url=http://zaimy-13.ru/]http://zaimy-13.ru/[/url] .
zaimi_xhKt
17 Sep 25 at 6:42 pm
исторические фильмы [url=http://kinogo-14.top/]исторические фильмы[/url] .
kinogo_hoEl
17 Sep 25 at 6:43 pm
все микрозаймы на карту [url=zaimy-11.ru]zaimy-11.ru[/url] .
zaimi_emPt
17 Sep 25 at 6:43 pm
смотреть комедии онлайн [url=http://kinogo-15.top/]смотреть комедии онлайн[/url] .
kinogo_etsa
17 Sep 25 at 6:44 pm
авиатор игра онлайн [url=http://1win12014.ru/]http://1win12014.ru/[/url]
1win_gcOl
17 Sep 25 at 6:44 pm
Алкогольная зависимость – заболевание, при котором страдает не только тело, но и психика человека. При длительных запоях нарушается работа сердца, печени, почек, появляются острые психоэмоциональные расстройства: тревожность, страхи, агрессия, проблемы со сном. В стадии абстиненции часто отмечается учащённый пульс, скачки давления, дрожь в руках, галлюцинации. Это крайне опасное состояние, требующее профессионального вмешательства нарколога. Клиника «Решение+» в Ногинске предлагает квалифицированный вывод из запоя на дому и в стационаре — с индивидуальным подходом, круглосуточной поддержкой и полным соблюдением анонимности.
Узнать больше – http://vyvod-iz-zapoya-noginsk5.ru
Davidswerm
17 Sep 25 at 6:45 pm
смотреть русские сериалы [url=kinogo-15.top]смотреть русские сериалы[/url] .
kinogo_posa
17 Sep 25 at 6:47 pm
все займы онлайн [url=https://zaimy-11.ru/]https://zaimy-11.ru/[/url] .
zaimi_clPt
17 Sep 25 at 6:47 pm
Thank you for the auspicious writeup. It in reality used to be a
entertainment account it. Look complex to more brought agreeable from you!
However, how could we communicate?
dewa scatter
17 Sep 25 at 6:50 pm
Oһ, mathematics іs the base stone ߋf primary education, assisting children іn dimensional analysis to design careers.
Оh dear, wіthout solid mathematics іn Junior College, no matter
leading institution children mіght stumble ѡith high school equations, ѕo build that
ρromptly leh.
Dunman Нigh School Junior College excels іn multilingual education, blending Eastern and Western viewpoints
tо cultivate culturally astute аnd ingenious thinkers.
The incorporated program οffers smooth progression ѡith
enriched curricula inn STEM ɑnd liberal arts,
supported ƅy innovative centers like resеarch labs. Students prosper in an unified
environment tһat highlights imagination, management, ɑnd community involvement thгough diverse activities.
Global immersion programs boost cross-cultural understanding
ɑnd prepare trainees for worldwide success. Graduates consistently attain leading outcomes, ѕhowing thе school’s dedication to academic rigor ɑnd individual excellence.
Anglo-Chinese School (Independent) Junior College delivers аn enriching education deeply rooted іn faith, wһere
intellectual expedition іs harmoniously stabilized ԝith core ethical concepts, directing students tоwards bеcomіng compassionate аnd гesponsible worldwide people
geared ᥙp to attend to intricate societal obstacles.
Ƭhе school’s prestigious International Baccalaureate Diploma Programme promotes innovative іmportant thinking, rеsearch study skills, ɑnd interdisciplinary knowing, bolstered
ƅʏ extraordinary resources lіke dedicated development centers ɑnd professional faculty ᴡһo mentor students
in attaining scholastic distinction. Ꭺ broad spectrum ᧐f co-curricular offerings, fгom
innovative robotics cⅼubs tһаt motivate technological creativity t᧐ chamber orchestra tһɑt develop musical
skills, permits students tо find and fіne-tune their distinct
abilities іn a supportive and stimulating environment. Ву incorporating service knowing initiatives, ѕuch as community
outreach projects аnd volunteer programs Ьoth in ｙоur arеa and internationally,
the college cultivates a strong sense of social duty, compassion, ɑnd active citizenship
аmongst its student body. Graduates ⲟf Anglo-Chinese School (Independent) Junior
College ɑre remarkably ԝell-prepared foｒ entry intо elite universities ɑｒound the world,
bｒing witһ them a prominent tradition of academic
quality, individual stability, ɑnd a dedication tо lifelong learning and contribution.
Wah, math acts ⅼike the groundwork pillar ⲟf primary schooling,
assisting kids fоr geometric analysis f᧐r architecture
paths.
Eh eh, calm pom рі рi, mathematics proves ɑmong from tһe higһest topics
аt Junior College, building groundwork іn Α-Level
calculus.
Օh dear, lacking robust math ⅾuring Junior College,
even leading establishment children сould stumble with high school equations, tһerefore build that now leh.
A-level Math prepares үou for coding and AI,
hot fields гight now.
Avoid taкe lightly lah, pair ɑ good Junior Collegbe рlus math proficiency
in order to assure һigh A Levels scores ⲣlus seamless shifts.
Ꮇｙ blog post … Sec School
Sec School
17 Sep 25 at 6:51 pm
все микрозаймы онлайн [url=zaimy-11.ru]zaimy-11.ru[/url] .
zaimi_opPt
17 Sep 25 at 6:52 pm
кино онлайн [url=http://kinogo-15.top/]кино онлайн[/url] .
kinogo_hcsa
17 Sep 25 at 6:52 pm
как увеличить срок службы дизельного генератора
Williamcem
17 Sep 25 at 6:54 pm
купить диплом бакалавра цена [url=https://www.educ-ua18.ru]купить диплом бакалавра цена[/url] .
Diplomi_rvPi
17 Sep 25 at 6:56 pm
фильмы онлайн без подписки [url=https://www.kinogo-12.top]https://www.kinogo-12.top[/url] .
kinogo_blol
17 Sep 25 at 6:59 pm
online apotheke preisvergleich: diskrete lieferung von potenzmitteln – online apotheke
Israelpaync
17 Sep 25 at 7:00 pm
Thanks for every other excellent post. Where else could
anybody get that kind of information in such an ideal way of writing?
I’ve a presentation next week, and I am on the search
for such information.
hm888
17 Sep 25 at 7:02 pm
купить диплом о среднем образовании с занесением в реестр [url=http://www.educ-ua15.ru]купить диплом о среднем образовании с занесением в реестр[/url] .
Diplomi_vumi
17 Sep 25 at 7:11 pm
диплом купить с занесением в реестр [url=https://www.educ-ua14.ru]диплом купить с занесением в реестр[/url] .
Diplomi_qwkl
17 Sep 25 at 7:12 pm
https://xn--krken23-bn4c.com
Howardreomo
17 Sep 25 at 7:13 pm
купить диплом института ссср [url=http://educ-ua18.ru]http://educ-ua18.ru[/url] .
Diplomi_dyPi
17 Sep 25 at 7:14 pm
Hi my loved one! I wish to say that this article is
amazing, nice written and come with almost all significant infos.
I would like to look more posts like this .
ludo earn money app
17 Sep 25 at 7:15 pm
Semoga tulisan seperti ini semakin sering dipublikasikan, karena
banyak pemain baru maupun lama membutuhkan panduan yang jelas seputar KUBET dan Situs Judi Bola.
Artikel ini bisa jadi referensi penting bagi mereka yang ingin memahami lebih jauh dunia taruhan online.
comment-188325
17 Sep 25 at 7:20 pm
Tourists fined and banned from Venice for swimming in canal
[url=https://trip-scan.co]трип скан[/url]
A couple from the United Kingdom had to cut their vacation in Venice short after being caught swimming in the Grand Canal.
The 35-year-old British man and his 25-year-old Romanian girlfriend were forced to return to their home in the UK on Thursday, the same day they arrived in the city, after gondoliers reported them to local police for taking a dip in the canal.
The pair were fined €450 ($529) each and expelled from Venice for 48 hours, marking the 1,136th such sanction to be handed down to badly behaved tourists in the city so far this year, according to the Venice City Police.
The unnamed couple took the plunge near the Accademia bridge near St. Mark’s Square and gondoliers at the Rio San Vidal kiosk immediately called authorities, who removed them from the water.
“I thank the gondoliers for their cooperation and timely reporting,” said Venice Security Councillor Elisabetta Pesce in a statement published by city authorities on Friday.
https://trip-scan.co
трипскан сайт
“Venice must be defended from those who disrespect it: protecting the city means ensuring decorum for residents and visitors who experience it with civility.”
Swimming in the Venice canals is prohibited for a variety of reasons, including the intense boat traffic and the cleanliness — or lack thereof — of the water, according to the city’s tourism ministry.
Of the 1,136 orders of expulsion from the city so far this year, about 10 were for swimming.
Related article
Tourists take photographs on the Rialto Bridge in Venice, Italy, on Saturday, April 8, 2023. Italy’s upcoming budget outlook will probably incorporate a higher growth forecast for 2023 followed by a worsened outlook for subsequent years, according to people familiar with the matter. Photographer: Andrea Merola/Bloomberg via Getty Images
Rising waters and overtourism are killing Venice. Now the fight is on to save its soul
“Since the beginning of the year, we have issued a total of 1,136 orders of expulsion for incidents of degradation and uncivilized behavior,” Venice local police deputy commander Gianni Franzoi said in a statement shared with CNN.
Poor visitor behavior is one of the worst byproducts of overtourism, Franzoi said, and incidents are on the rise.
In July 2024, an Australian man was fined and expelled for diving off the Rialto Bridge after his friends posted about it on social media.
The year before, two French tourists were fined and expelled for skinny dipping in the canal under the moonlight. In August 2022, a German man was fined and expelled for surfing in the canal.
Related article
Aerial view of the plagued ghost island of Poveglia in the Venetian lagoon
‘Haunted’ Venice island to become a locals-only haven where tourists are banned
Venice’s authorities have been trying to balance the need for visitor income with residents’ demands for a city that works for them.
Day trippers now pay a €10 entrance fee on summer weekends and during busy periods throughout the year.
The city has also banned tour groups of more than 25 people, loudspeakers and megaphones, and even standing on narrow streets to listen to tour guides.
“It was necessary to establish a system of penalties that would effectively deter potential violations,” Pesce said when the ordinance was passed in February.
“Our goal remains to combat all forms of irregularities related to overtourism in the historic lagoon city center,” she added.
“The new rules for groups accompanied by guides encourage a more sustainable form of tourism, while also ensuring greater protection and safety in the city and better balancing the needs of Venice residents and visitors.”
CharlesTum
17 Sep 25 at 7:20 pm
купить диплом о образовании в киеве [url=http://www.educ-ua18.ru]http://www.educ-ua18.ru[/url] .
Diplomi_nyPi
17 Sep 25 at 7:23 pm
кинопоиск смотреть онлайн [url=www.kinogo-12.top]www.kinogo-12.top[/url] .
kinogo_tzol
17 Sep 25 at 7:25 pm
Hello There. I found your weblog the usage of
msn. This is an extremely well written article.
I’ll be sure to bookmark it and come back to read more of your
useful information. Thanks for the post. I will certainly return.
Moon Reading Reviews
17 Sep 25 at 7:25 pm
Как реализовано в «РеабилитейшнПро»
Ознакомиться с деталями – [url=https://narkologicheskaya-pomoshch-domodedovo6.ru/]anonimnaya-narkologicheskaya-pomoshch[/url]
Robertsem
17 Sep 25 at 7:26 pm
kraken ссылка тор 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
17 Sep 25 at 7:26 pm
https://xn--krken21-bn4c.com
Howardreomo
17 Sep 25 at 7:28 pm