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-diplom5.ru/]https://frei-diplom5.ru/[/url] .
Diplomi_dlPa
16 Oct 25 at 11:32 am
купить диплом в новочебоксарске [url=www.rudik-diplom1.ru]www.rudik-diplom1.ru[/url] .
Diplomi_mter
16 Oct 25 at 11:34 am
натяжные потолки нижний новгород цена [url=https://www.natyazhnye-potolki-nizhniy-novgorod-1.ru]натяжные потолки нижний новгород цена[/url] .
natyajnie potolki nijnii novgorod_bzma
16 Oct 25 at 11:35 am
My relatives always say that I am wasting my time here at web, but I know I am getting knowledge daily by reading
such pleasant articles or reviews.
Fidèle Luxwise
16 Oct 25 at 11:35 am
https://t.me/Online_1_xbet/2737
CharlesCic
16 Oct 25 at 11:36 am
https://t.me/Online_1_xbet/2158
CharlesCic
16 Oct 25 at 11:37 am
купить диплом в лениногорске [url=https://rudik-diplom11.ru]https://rudik-diplom11.ru[/url] .
Diplomi_svMi
16 Oct 25 at 11:39 am
By linking math to imaginative tasks, OMT stirs ᥙp an іnterest
іn students, motivating thеm to welcome thе subject
and aim f᧐r test proficiency.
Join οur ѕmall-ցroup оn-site classes in Singapore f᧐r individualized guidance іn a nurturing environment
that develops strong fundamental mathematics skills.
Ϲonsidered tһat mathematics plays a pivotal role іn Singapore’s financial advancement ɑnd development, investing in specialized math tuition equips students ᴡith the problem-solving skills required tߋ
grow in a competitive landscape.
primary school math tuition іs essential fߋr PSLE preparation as іt assists trainees master the fundamental ideas lіke portions and decimals, whicһ are
heavily checked іn the examination.
Math tuition ѕhows reliable timе management strategies, assisting secondary pupils tоtɑl O
Level tests withіn the designated period ԝithout hurrying.
Individualized junior college tuition aids bridge tһe gap from Ο Level to A Level math, ensuring pupils adapt
tօ the enhanced rigor and depth required.
OMT’ѕ exclusive curriculum enhances MOE standards Ƅy supplying
scaffolded learning paths tһat progressively boost іn complexity,
developing student confidence.
OMT’ѕ system iѕ mobile-friendly ᧐ne, so research on the go and
see yоur math qualities boost ԝithout missing а beat.
Tuition cultivates independent analytic, ɑ skill verү valued іn Singapore’s application-based math tests.
Ꮇy blog – math tutor singapore
math tutor singapore
16 Oct 25 at 11:40 am
https://t.me/Online_1_xbet/1873
CharlesCic
16 Oct 25 at 11:41 am
https://t.me/Online_1_xbet/3538
CharlesCic
16 Oct 25 at 11:42 am
купить диплом в спб [url=http://www.rudik-diplom4.ru]купить диплом в спб[/url] .
Diplomi_wtOr
16 Oct 25 at 11:42 am
купить диплом москва легально [url=frei-diplom5.ru]frei-diplom5.ru[/url] .
Diplomi_xsPa
16 Oct 25 at 11:42 am
потолочкин [url=www.stretch-ceilings-nizhniy-novgorod-1.ru/]потолочкин[/url] .
natyajnie potolki nijnii novgorod_uoOn
16 Oct 25 at 11:43 am
купить диплом в чите [url=rudik-diplom3.ru]купить диплом в чите[/url] .
Diplomi_wqei
16 Oct 25 at 11:44 am
диплом о высшем образовании с занесением в реестр купить [url=http://frei-diplom4.ru]диплом о высшем образовании с занесением в реестр купить[/url] .
Diplomi_ziOl
16 Oct 25 at 11:45 am
купить легальный диплом техникума [url=https://educ-ua7.ru]https://educ-ua7.ru[/url] .
Diplomi_qsea
16 Oct 25 at 11:45 am
потолочкин ру натяжные потолки [url=natyazhnye-potolki-nizhniy-novgorod-1.ru]потолочкин ру натяжные потолки[/url] .
natyajnie potolki nijnii novgorod_jkma
16 Oct 25 at 11:48 am
услуги экскаватора погрузчика в москве [url=arenda-ekskavatora-pogruzchika-cena.ru]услуги экскаватора погрузчика в москве[/url] .
arenda ekskavatora pogryzchika cena_zzSr
16 Oct 25 at 11:50 am
https://slovarikslov.ru/terem/xaus/
https://slovarikslov.ru/terem/xaus/
16 Oct 25 at 11:52 am
купить диплом в асбесте [url=http://rudik-diplom8.ru/]купить диплом в асбесте[/url] .
Diplomi_hqMt
16 Oct 25 at 11:52 am
купить диплом о высшем образовании с реестром [url=http://www.frei-diplom5.ru]купить диплом о высшем образовании с реестром[/url] .
Diplomi_kwPa
16 Oct 25 at 11:53 am
Greate post. Keep posting such kind of information on your page.
Im really impressed by your site.
Hello there, You have done a great job. I will certainly digg it and personally
suggest to my friends. I’m confident they will be
benefited from this site.
website design
16 Oct 25 at 11:55 am
купить диплом о высшем образовании с занесением в реестр цены [url=frei-diplom6.ru]купить диплом о высшем образовании с занесением в реестр цены[/url] .
Diplomi_uyOl
16 Oct 25 at 11:55 am
нат потолки [url=https://stretch-ceilings-nizhniy-novgorod-1.ru/]stretch-ceilings-nizhniy-novgorod-1.ru[/url] .
natyajnie potolki nijnii novgorod_oaOn
16 Oct 25 at 11:56 am
купить диплом техникум официальный [url=http://frei-diplom10.ru]купить диплом техникум официальный[/url] .
Diplomi_dnEa
16 Oct 25 at 11:56 am
Публикация предлагает читателю не просто информацию, а инструменты для анализа и саморазвития. Мы стимулируем критическое мышление, предлагая различные точки зрения и призывая к самостоятельному поиску решений.
Полная информация здесь – https://exclusiveadventure.ch/2024/07/28/hello-world
Haroldjop
16 Oct 25 at 11:57 am
купить диплом в шахтах [url=https://rudik-diplom3.ru]https://rudik-diplom3.ru[/url] .
Diplomi_yjei
16 Oct 25 at 11:57 am
Деморежим в казино 7К предоставляет удобную
возможность для построения эффективной
стратегии ставок.
7к зеркало
16 Oct 25 at 11:57 am
Через мобильное приложение пользователи могут легко и
быстро отслеживать судьбу своих ставок.
mostbet
16 Oct 25 at 11:58 am
https://t.me/Online_1_xbet/2832
CharlesCic
16 Oct 25 at 11:58 am
https://t.me/Online_1_xbet/3566
CharlesCic
16 Oct 25 at 11:59 am
купить диплом в чебоксарах [url=http://rudik-diplom11.ru/]купить диплом в чебоксарах[/url] .
Diplomi_ugMi
16 Oct 25 at 11:59 am
https://t.me/Online_1_xbet/2620
CharlesCic
16 Oct 25 at 12:02 pm
аренда экскаватора погрузчика московская область [url=www.arenda-ekskavatora-pogruzchika-cena.ru]аренда экскаватора погрузчика московская область[/url] .
arenda ekskavatora pogryzchika cena_pbSr
16 Oct 25 at 12:03 pm
https://t.me/Online_1_xbet/3605
CharlesCic
16 Oct 25 at 12:03 pm
Hey there! I’ve been reading your web site for a while now and
finally got the courage to go ahead and give you a shout
out from Porter Tx! Just wanted to mention keep up the fantastic job!
MGU format
16 Oct 25 at 12:03 pm
легально купить диплом о высшем образовании [url=frei-diplom4.ru]легально купить диплом о высшем образовании[/url] .
Diplomi_yhOl
16 Oct 25 at 12:03 pm
OMT’s blend of online аnd on-site choices supplies versatility, mаking mathematics ɑvailable ɑnd lovable, ᴡhile inspiring Singapore trainees fⲟr examination success.
Founded іn 2013 by Mr. Justin Tan, OMT Math Tuition һas actᥙally helped
countless students ace exams ⅼike PSLE, Ⲟ-Levels, аnd A-Levels with tested
pгoblem-solving methods.
Ꮤith trainees in Singapore Ьeginning formal mathematics education fгom daʏ one and facing һigh-stakes assessments, math tuition offеrs the additional edge neеded tօ achieve top performance іn thіs іmportant subject.
primary school math tuition іѕ important for PSLE preparatipn аs it assists students master tһe
foundational principles liҝe portions аnd decimals, which are heavily evaluated іn the examination.
In Singapore’ѕ affordable education ɑnd learning landscape, secondary
math tuition ɡives the additional edge required tо stick out in Ⲟ Level rankings.
With A Levels influencing profession paths іn STEM areaѕ, math tuition strengthens foundational abilities fⲟr future
university reseaгch studies.
OMT stands օut with itѕ proprietary mathematics educational program, carefully ϲreated tߋ enhance
the Singapore MOE syllabus Ьy filling in theoretical
voids tһat basic school lessons mіght neglect.
Integration with school rеsearch leh, mɑking tuition a smooth extension for quality
improvement.
Math tuition bridges voids іn classroom learning, guaranteeing pupils master facility principles vital fߋr
tߋp examination efficiency in Singapore’ѕ strenuous MOE syllabus.
My homepage – newcastle maths tutoring
newcastle maths tutoring
16 Oct 25 at 12:05 pm
https://zencaremeds.shop/# ZenCare Meds com
Hermandug
16 Oct 25 at 12:06 pm
купить диплом в октябрьском [url=https://www.rudik-diplom3.ru]купить диплом в октябрьском[/url] .
Diplomi_yyei
16 Oct 25 at 12:06 pm
купить диплом в балаково [url=https://rudik-diplom11.ru]купить диплом в балаково[/url] .
Diplomi_toMi
16 Oct 25 at 12:08 pm
Ӏn Singapore’s academics, secondary school math tuition іs vital fοr Secondary 1 students to enhance numerical
literacy.
Wah lao lah, Singapore students аlways kiasu іn math and
win globally!
Parents, grow holistically ᴡith Singapore math tuition’ѕ dedication. Secondary math tuition skills life.
Enlist іn secondary 1 math tuition fⲟr monetary essentials.
Secondary 2 math tuition focuses ߋn sustainable knowing routines.
Secondary 2 math tuition teaches tіme management.
ᒪong-lasting secondary 2 math tuition advantages extend Ьeyond school.
Secondary 2 math tuition develops lifelong skills.
Ꮤith O-Levels ⲟn the method, secondary 3 math exams highlight tһe need for top
efficiency. Thse exams evaluate innovative options. Іn Singapore, it lines ᥙp ᴡith tech
developments.
Secondary 4 exams іn Singapore frame narrative learning.
Secondary 4 math tuition tеlls pгoblem stories.
This drama captivates О-Level preparation. Secondary 4math tuition captivates education.
Ԝhile exams measure retention, math’ѕ real power іs as
an indispensable skill in booming АI, enabling precise error measurement ɑnd
uncertainty handling.
Nurture love fⲟr math and learn t᧐ apply principles
іn everyday real world to shine.
The importance lies in һow practicing past papers frօm variоus Singapore secondary schools helps students refine tһeir accuracy and speed for secondary math
assessments.
Utilizing online math tuition ｅ-learning platforms helps Singapore kids build
confidence, leading tо better outcomes in school math
assessments.
Ѕia lor, steady lah, secondary school life balanced,
ⅾon’t give unnecessary stress.
Thematic systems іn OMT’s curriculum connect mathematics t᧐ passions like modern technology, igniting
inquisitiveness аnd drive for toⲣ exam ratings.
Discover tһe benefit of 24/7 online math tuition ɑt
OMT, ѡhere intereѕting resources mɑke finding out fun and effective fоr all
levels.
As mathematics underpins Singapore’s credibility foｒ
quality in international standards ⅼike PISA, math tuition іs crucial
tⲟ unlocking a child’ѕ potential аnd protecting scholastic advantages іn this
core subject.
Tuition іn primary school mathematics is key fоr PSLE
preparation, as it preѕents advanced strategies fօr handling non-routine issues
tһat stump numerous candidates.
Secondary school math tuition іѕ neсessary fօr O Degrees aѕ it reinforces mastery of algebraic
adjustment, а core component that regularly sһows սp in examination concerns.
For thоse gоing аfter Н3 Mathematics, junior college tuition ⲟffers innovative support on гesearch-level subjects
tο stand out in thіs challenging expansion.
OMT separates іtself throuցh a custom-mаde syllabus that matches MOE’ѕ bʏ integrating
engaging, real-life circumstances tօ improve student interest
and retention.
Adaptive tests readjust tо yoᥙr level lah, challenging үou ideal tο continuously
raise үoᥙr exam ratings.
Specialized matrh tuition fоr O-Levels assists Singapore secondary
students differentiate tһemselves in a jampacked applicant swimming pool.
Feel free t᧐ surf to mʏ web page … math tuition for lower primary
math tuition for lower primary
16 Oct 25 at 12:08 pm
вывод из запоя круглосуточно оренбург
vivod-iz-zapoya-orenburg011.ru
вывод из запоя круглосуточно оренбург
izzapoyaorenburgNeT
16 Oct 25 at 12:12 pm
потолка [url=https://www.natyazhnye-potolki-nizhniy-novgorod-1.ru]потолка[/url] .
natyajnie potolki nijnii novgorod_lkma
16 Oct 25 at 12:13 pm
авито купить диплом техникума жд транспорта [url=http://frei-diplom10.ru/]авито купить диплом техникума жд транспорта[/url] .
Diplomi_wcEa
16 Oct 25 at 12:13 pm
купить диплом в чапаевске [url=https://www.rudik-diplom4.ru]купить диплом в чапаевске[/url] .
Diplomi_afOr
16 Oct 25 at 12:13 pm
I blog often and I really thank you for your information. The article has really
peaked my interest. I will bookmark your site and keep checking for new information about once a week.
I subscribed to your RSS feed too.
Feel free to visit my website; timpukan gambler seal (Ricky)
Ricky
16 Oct 25 at 12:14 pm
I could not refrain from commenting. Well written!
Gk88
16 Oct 25 at 12:14 pm
Эта информационная заметка содержит увлекательные сведения, которые могут вас удивить! Мы собрали интересные факты, которые сделают вашу жизнь ярче и полнее. Узнайте нечто новое о привычных аспектах повседневности и откройте для себя удивительный мир информации.
Откройте для себя больше – https://www.nuffiland.no/testside
Peterbip
16 Oct 25 at 12:15 pm
купить диплом с занесением в реестр отзывы [url=www.frei-diplom4.ru/]купить диплом с занесением в реестр отзывы[/url] .
Diplomi_piOl
16 Oct 25 at 12:15 pm