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=http://www.frei-diplom10.ru]за сколько можно купить диплом техникума[/url] .
Diplomi_osEa
6 Oct 25 at 11:14 pm
Minotaurus ICO’s whitepaper highlights balanced token release. $MTAUR holders shape via DAO—democratic and cool. Casual market entry is spot on.
mtaur token
WilliamPargy
6 Oct 25 at 11:16 pm
В «Частном Медике 24» в Самаре лечение организовано так, чтобы пациент чувствовал себя безопасно и защищённо.
Выяснить больше – [url=https://vyvod-iz-zapoya-v-stacionare-samara24.ru/]наркология вывод из запоя в стационаре в самаре[/url]
Richardspeen
6 Oct 25 at 11:16 pm
zukdfj.shop – This seems like a passion project, content reflects genuine effort.
Terry Galante
6 Oct 25 at 11:16 pm
Купить диплом колледжа в Полтава [url=educ-ua7.ru]educ-ua7.ru[/url] .
Diplomi_keea
6 Oct 25 at 11:16 pm
купить диплом в армавире [url=http://www.rudik-diplom4.ru]купить диплом в армавире[/url] .
Diplomi_osOr
6 Oct 25 at 11:16 pm
купить диплом инженера по охране труда [url=www.rudik-diplom13.ru/]купить диплом инженера по охране труда[/url] .
Diplomi_qxon
6 Oct 25 at 11:17 pm
купить диплом легальный [url=www.frei-diplom4.ru]купить диплом легальный[/url] .
Diplomi_siOl
6 Oct 25 at 11:17 pm
Holzdekoration fur Terrassen in Berlin
Berlin ist eine Stadt, die sich durch ihre vielfaltigen Architekturstile auszeichnet. Besonders attraktiv sind dabei Terrassen, die ein schones Ambiente bieten und den Au?enbereich zu einem begehrten Aufenthaltsort machen. In diesem Artikel werden verschiedene Arten von Gehobelten Brettern sowie Bangkirai und Merbau, zwei tropische Holzer, vorgestellt, die haufig fur Terrassendielen verwendet werden.
[url=https://bvholz.de/ ]Bangkirai und Merbau in Berlin[/url]
¦ Gehobelte Bretter – Larche in Berlin kaufen
Dieses Material findet man hauptsachlich bei Spezialisten fur Holzprodukte oder Baumarkten wie Hornbach und Bauhaus. Es gibt jedoch auch Online-Anbieter, die liefern lassen. Larchenholz zeichnet sich durch seine hohe Dauerhaftigkeit und Wetterbestandigkeit aus, was es besonders geeignet macht fur au?entragende Flachen wie Terrassen.
¦ Preise & Qualitat
[url=https://bvholz.de/ ]Terrassendielen mit dunnen Nuten konnen in Berlin erworben werden[/url]
Preislich variiert das Angebot je nach Herkunft des Materials. Eine qualitativ hochwertige Larche kann leicht uber €10 pro Quadratmeter kosten. Wer auf Budget achtet, sollte auf Markenartikel achten, die oft im Rahmen von Sonderangeboten erhaltlich sind.
¦ Bangkirai und Merbau in Berlin
Fur Kunden, die etwas Exotischeres suchen, stehen tropische Holzer wie Bangkirai und Merbau zur Verfugung. Diese beiden Sorten sind bekannt fur ihre asthetischen Eigenschaften sowie ihre Bestandigkeit gegen Schimmel und Insektenbefall. Obwohl sie mehr kosten als traditionelle Holzer wie Eiche oder Fichte, lohnt sich der Zukauf aufgrund ihrer langen Lebensdauer.
¦ Verarbeitung & Pflege
[url=https://bvholz.de/holz-bangkirai ]Bangkirai und Merbau in Aachen[/url]
Beide Holzer sollten regelma?ig geolt werden, um ihr Aussehen zu erhalten und vor Feuchtigkeitsschaden zu schutzen. Hierzu empfehlen Experten spezielle Ole, die fur Tropenholzer entwickelt wurden.
¦ Bangkirai und Merbau in Aachen
Auch au?erhalb Berlins sind diese exotischen Holzer beliebt. So findet man sie zum Beispiel in Aachen, wo sie ebenfalls in Baumarkten und Online-Shops angeboten werden. Die Preise entsprechen denen in Berlin und liegen abhangig vom Anbieter zwischen €15 und €30 pro Quadratmeter.
¦ Terrassendielen mit dunnen Nuten konnen in Berlin erworben werden
Neben klassischen Brettern sind auch Dielen mit dunnen Nuten sehr gefragt. Sie ermoglichen eine schnelle Montage und sorgen fur einen modernen Look. Fur solche Produkte ist insbesondere der Online-Handel interessant, da hier eine gro?e Auswahl an Formaten und Farben verfugbar ist.
¦ Vorteile dieser Terrassendielen
Ein besonderer Vorteil dieser Systeme liegt darin, dass sie nicht nur optisch anspruchsvoll sind, sondern auch robust und wetterfest sind. Durch die dunne Nut lasst sich das Wasser besser ableiten, was vor Algenbildung schutzt.
¦ Holz Bangkirai Berlin
In Berlin hat sich Bangkirai mittlerweile etabliert als eines der bevorzugten Holzer fur Terrassenbelag. Seine rotliche Farbe passt hervorragend zu modernen Wohnungsarchitekturen und unterstreicht den Naturcharakter des Materials. Auch wenn Bangkirai anfangs teurer erscheinen mag, so zahlen sich seine Vorteile wie Dauerhaftigkeit und Robustheit schnell wieder aus.
¦ Terrassendielen glatt Berlin
Zuruckhaltender und klassischer wirken hingegen glatte Terrassendielen. Dieser Typ wird ebenfalls gerne eingesetzt, vor allem dann, wenn man einen ruhigeren Stil wunscht. Mit einer guten Abriebfestigkeit eignen sie sich ideal fur Familien mit Kindern oder Haustieren.
¦ Schlussfolgerung
Ob klassisches Larchenholz, exotische Sorten wie Bangkirai und Merbau oder moderne Diensysteme mit dunnen Nuten – jeder Geschmack findet sein passendes Material in Berlin. Unabhangig davon, welches Holz gewahlt wird, sollte immer darauf geachtet werden, dass es ordnungsgema? behandelt und gepflegt wird, damit es lange Freude bereitet.
Terrassendielen mit dunnen Nuten konnen in Berlin erworben werden
https://bvholz.de/holz-laerche-terrasse/terrassendiele-glatt
ArchieSon
6 Oct 25 at 11:17 pm
zithromax z- pak buy online: buy zithromax – azithromycin zithromax
Charleshaw
6 Oct 25 at 11:19 pm
купить диплом эколога [url=http://rudik-diplom3.ru/]http://rudik-diplom3.ru/[/url] .
Diplomi_wjei
6 Oct 25 at 11:19 pm
Hello there, I found your website by means of Google whilst searching for a comparable subject, your
site got here up, it seems to be great. I’ve bookmarked it in my google bookmarks.
Hi there, simply was alert to your weblog through Google,
and located that it is truly informative. I am
gonna watch out for brussels. I’ll be grateful when you continue this in future.
Numerous people will probably be benefited from your writing.
Cheers!
flm bokep
6 Oct 25 at 11:19 pm
купить диплом в туймазы [url=http://www.rudik-diplom5.ru]купить диплом в туймазы[/url] .
Diplomi_rpma
6 Oct 25 at 11:20 pm
глория мебель [url=http://www.kuhni-spb-4.ru]http://www.kuhni-spb-4.ru[/url] .
kyhni spb_pver
6 Oct 25 at 11:20 pm
I’ve been exploring for a little bit for any high quality articles or blog posts in this sort of
area . Exploring in Yahoo I eventually stumbled upon this web site.
Studying this information So i’m happy to show
that I’ve an incredibly excellent uncanny feeling I discovered
just what I needed. I so much undoubtedly will make
sure to do not omit this website and give it a look on a constant basis.
бесплатные вращения в казино
6 Oct 25 at 11:24 pm
частная клиника наркологическая [url=www.narkologicheskaya-klinika-20.ru/]www.narkologicheskaya-klinika-20.ru/[/url] .
narkologicheskaya klinika _tzPr
6 Oct 25 at 11:25 pm
купить диплом о высшем образовании с занесением в реестр в москве [url=http://frei-diplom4.ru/]купить диплом о высшем образовании с занесением в реестр в москве[/url] .
Diplomi_jqOl
6 Oct 25 at 11:26 pm
купить диплом колледжа [url=https://rudik-diplom13.ru]купить диплом колледжа[/url] .
Diplomi_nron
6 Oct 25 at 11:26 pm
80hg88.cc – I like this site’s vibe, topics feel relevant to my interests.
Roslyn Caretto
6 Oct 25 at 11:27 pm
https://k-projekt.ru
HowardGoony
6 Oct 25 at 11:27 pm
заказать кухню по индивидуальным размерам в спб [url=www.kuhni-spb-4.ru/]заказать кухню по индивидуальным размерам в спб[/url] .
kyhni spb_vser
6 Oct 25 at 11:27 pm
где купить диплом медицинского колледжа [url=https://frei-diplom10.ru/]https://frei-diplom10.ru/[/url] .
Diplomi_iqEa
6 Oct 25 at 11:27 pm
купить диплом в химках [url=https://rudik-diplom14.ru/]купить диплом в химках[/url] .
Diplomi_vyea
6 Oct 25 at 11:27 pm
This is my first time pay a visit at here and
i am actually pleassant to read all at single place.
вызвать капельницу от запоя в Краснодаре
6 Oct 25 at 11:28 pm
где купить диплом о техникуме [url=http://frei-diplom9.ru]где купить диплом о техникуме[/url] .
Diplomi_dfea
6 Oct 25 at 11:29 pm
купить диплом о высшем образовании с занесением в реестр в москве [url=https://frei-diplom1.ru/]купить диплом о высшем образовании с занесением в реестр в москве[/url] .
Diplomi_jxOi
6 Oct 25 at 11:29 pm
купить диплом в миассе [url=www.rudik-diplom11.ru]купить диплом в миассе[/url] .
Diplomi_kxMi
6 Oct 25 at 11:29 pm
купить диплом в губкине [url=www.rudik-diplom4.ru/]www.rudik-diplom4.ru/[/url] .
Diplomi_klOr
6 Oct 25 at 11:30 pm
Купить диплом колледжа в Винница [url=http://www.educ-ua7.ru]http://www.educ-ua7.ru[/url] .
Diplomi_pcea
6 Oct 25 at 11:31 pm
я купил диплом с проводкой [url=http://frei-diplom4.ru]я купил диплом с проводкой[/url] .
Diplomi_jmOl
6 Oct 25 at 11:31 pm
warmm1.cc – The tone feels genuine, as if someone wrote from experience.
Jonah Dawkin
6 Oct 25 at 11:32 pm
где заказать кухню в спб [url=https://kuhni-spb-4.ru/]где заказать кухню в спб[/url] .
kyhni spb_cwer
6 Oct 25 at 11:32 pm
я купил проведенный диплом [url=www.frei-diplom3.ru]я купил проведенный диплом[/url] .
Diplomi_mvKt
6 Oct 25 at 11:32 pm
купить диплом магистра [url=https://rudik-diplom3.ru]купить диплом магистра[/url] .
Diplomi_ljei
6 Oct 25 at 11:33 pm
купить диплом техникума недорого пять плюс [url=www.frei-diplom10.ru/]купить диплом техникума недорого пять плюс[/url] .
Diplomi_nyEa
6 Oct 25 at 11:35 pm
купить диплом в балашове [url=www.rudik-diplom12.ru]купить диплом в балашове[/url] .
Diplomi_htPi
6 Oct 25 at 11:35 pm
All operations happen on-device, so even if your PC is infected, your funds remain unreachable to malicious software.
trezor bridge
trezor-bridge-info.live
TrezorAlexfd
6 Oct 25 at 11:37 pm
Aw, this was an incredibly good post. Taking the time and actual effort to produce a superb article… but what can I say… I procrastinate
a whole lot and never manage to get anything done.
dog vaccinations Ames IA
6 Oct 25 at 11:38 pm
В больничных условиях «Частного Медика 24» врачи контролируют давление, сердце и функции жизненно важных органов при выводе из запоя.
Исследовать вопрос подробнее – [url=https://vyvod-iz-zapoya-v-stacionare-samara23.ru/]www.vyvod-iz-zapoya-v-stacionare-samara23.ru[/url]
Garrettpew
6 Oct 25 at 11:39 pm
qyrhjd.top – The visuals complement the text nicely, makes reading more fun.
Chester Bumbalo
6 Oct 25 at 11:39 pm
Если вы ищете надежную клинику для вывода из запоя в Сочи, обратитесь в «Детокс». Здесь опытные специалисты окажут необходимую помощь в стационаре. Услуга доступна круглосуточно, анонимно и начинается от 2000 ?.
Подробнее – [url=https://vyvod-iz-zapoya-sochi24.ru/]наркология вывод из запоя в сочи[/url]
DavidAttag
6 Oct 25 at 11:39 pm
pin up android yuklab olish [url=https://pinup5006.ru]https://pinup5006.ru[/url]
pin_up_qqKt
6 Oct 25 at 11:41 pm
Clomid fertility [url=https://clomicareusa.shop/#]Buy Clomid online[/url] Clomid price
Davidbax
6 Oct 25 at 11:43 pm
купить диплом охранника [url=http://rudik-diplom8.ru/]купить диплом охранника[/url] .
Diplomi_rzMt
6 Oct 25 at 11:47 pm
It’s in fact very complicated in this full of activity
life to listen news on TV, therefore I simply use the web for
that reason, and get the latest news.
Navigating highlighted comment feature YouTube
6 Oct 25 at 11:47 pm
купить диплом в вольске [url=http://rudik-diplom15.ru]http://rudik-diplom15.ru[/url] .
Diplomi_zyPi
6 Oct 25 at 11:48 pm
zukdfj.shop – Great find! I’ll be checking new articles from this often.
Leland Har
6 Oct 25 at 11:48 pm
диплом государственного образца купить реестр [url=www.frei-diplom2.ru/]диплом государственного образца купить реестр[/url] .
Diplomi_tcEa
6 Oct 25 at 11:48 pm
OMT’s standalone ｅ-learning choices equip independent
expedition, supportig ɑ personal love fߋr math and examination ambition.
Experience flexible knowing anytime, аnywhere tһrough OMT’s thoгough online
е-learning platform, featuring unlimited access tօ video lessons аnd
interactive tests.
In Singapore’ѕ rigorous education ѕystem, wһere mathematics is obligatory ɑnd consumes aгound 1600 һours of curriculum tіme іn primary school аnd secondary schools, matfh tuition endѕ up being necessary to help trainees develop a strong structure
fօr lifelong success.
Tuition emphasizes heuristic ⲣroblem-solving methods, crucial f᧐r dealing with PSLE’ѕ difficult
ᴡoｒⅾ issues that neеd multiple actions.
Offered tһe high risks ᧐f O Levels for senior һigh
school progression in Singapore, math tuition tɑkes full advantage ᧐f opportunities for top qualities аnd desired positionings.
Ꮤith A Levels affecting career paths іn STEM fields,
math tuition strengthens foundational skills f᧐r future university rеsearch studies.
Distinctively, OMT’ѕ syllabus matches tһe MOE framework bʏ supplying modular lessons tһat enable for repeated reinforcement ߋf weak locations аt
the pupil’s pace.
Themed modules mаke finding out thematic lor,
assisting қeep informаtion longеr for enhanced mathematics
efficiency.
Tuition іn mathematics assists Singapore trainees develop speed ɑnd
precision, essential f᧐r finishing examinations ԝithin timе limitations.
Αlso visit my page math tuition singapore
math tuition singapore
6 Oct 25 at 11:49 pm
диплом внесенный в реестр купить [url=http://www.frei-diplom4.ru]диплом внесенный в реестр купить[/url] .
Diplomi_vbOl
6 Oct 25 at 11:51 pm