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!
Ahaa, its fastidious conversation concerning this
paragraph at this place at this weblog, I have read
all that, so now me also commenting at this place.
소액결제 현금화
25 Oct 25 at 6:00 am
1xbet tr [url=https://1xbet-4.com/]https://1xbet-4.com/[/url] .
1xbet_pdol
25 Oct 25 at 6:02 am
BassBet Casino m’a ensorcele BassBet Casino, on ressent une vibe electrisante. La selection de jeux est explosive, comprenant des jeux adaptes aux cryptos. Amplifiant l’excitation du jeu. Disponible 24/7 via chat ou email, toujours pret a mixer. Le processus est simple et vibrant, mais plus de promos regulieres ajouteraient du rythme. Dans l’ensemble, BassBet Casino est un must pour les joueurs pour les fans de casino en ligne ! En plus la plateforme est visuellement electrisante, ce qui rend chaque session plus vibrante. Egalement genial les paiements securises en crypto, propose des avantages sur mesure.
bassbetcasinoappfr.com|
PulseCrafterL3zef
25 Oct 25 at 6:02 am
one x bet [url=http://www.1xbet-7.com]http://www.1xbet-7.com[/url] .
1xbet_tpol
25 Oct 25 at 6:03 am
Je suis totalement envoute par Spinit Casino, il procure une experience magique. Les options sont vastes comme un grimoire, avec des slots aux designs enchantes. 100% jusqu’a 500 € + tours gratuits. Le suivi est irreprochable, avec une aide precise. Les retraits sont fluides comme un conte, bien que des offres plus genereuses seraient enchantees. En bref, Spinit Casino est un incontournable pour les joueurs pour les joueurs en quete d’excitation ! En bonus la navigation est simple et magique, ajoute une touche de mystere. Particulierement interessant les evenements communautaires engageants, assure des transactions fiables.
https://spinitcasinobonusfr.com/|
FairyWhirlG8zef
25 Oct 25 at 6:04 am
Hi there! I know this is sort of off-topic but I needed to ask.
Does running a well-established website like yours
require a massive amount work? I’m brand new to blogging however
I do write in my diary on a daily basis. I’d like to start a blog so
I can share my own experience and feelings online.
Please let me know if you have any recommendations or tips for new aspiring bloggers.
Appreciate it!
bookkeeping
25 Oct 25 at 6:08 am
Hi, after reading this awesome piece of writing i am as
well cheerful to share my experience here with mates.
source
25 Oct 25 at 6:08 am
всегда работают и делают свою работу на 5+ https://buh-ved.ru работал с данным магазином, и по сей день работаю!!! отличный… сегодня посылочка только пришла! товар отличный особенно CHM 100.. спасибо за качество!!
LeonardHOX
25 Oct 25 at 6:08 am
1xbet t?rkiye giri? [url=https://1xbet-7.com/]1xbet-7.com[/url] .
1xbet_vcol
25 Oct 25 at 6:12 am
1xbet ?ye ol [url=https://1xbet-9.com]https://1xbet-9.com[/url] .
1xbet_ulSn
25 Oct 25 at 6:12 am
1xbet mobil giri? [url=http://1xbet-7.com]http://1xbet-7.com[/url] .
1xbet_xqol
25 Oct 25 at 6:14 am
you are really a excellent webmaster. The web site loading speed is
incredible. It sort of feels that you are doing any unique trick.
Moreover, The contents are masterwork. you’ve done a excellent process in this topic!
kill
25 Oct 25 at 6:15 am
1xbet com giri? [url=https://1xbet-4.com/]https://1xbet-4.com/[/url] .
1xbet_dcol
25 Oct 25 at 6:15 am
купить диплом в усть-илимске [url=https://www.rudik-diplom6.ru]https://www.rudik-diplom6.ru[/url] .
Diplomi_sqKr
25 Oct 25 at 6:16 am
bwaylocations.com – The branding looks consistent which adds credibility.
Rosella Badey
25 Oct 25 at 6:16 am
Где купить Габапентин в Выгоничие?Ребята, поделитесь опытом – присмотрел https://worldavtonew.ru
. Цены адекватные, доставляют. Кто-то пробовал с ними? Насколько качественно?
Stevenref
25 Oct 25 at 6:19 am
9vids: Whеre everry click leaⅾs to amazing vіdеo ԁiscoveries.
Look at my blog post bro impregnate sis
bro impregnate sis
25 Oct 25 at 6:20 am
https://t.me/s/bs_1xbet/25
https://t.me/s/bs_1xbet/15
25 Oct 25 at 6:21 am
https://t.me/s/bs_1xbet/13
https://t.me/bs_1xbet/35
25 Oct 25 at 6:22 am
Excellent site you have here but I was curious about if you
knew of any discussion boards that cover the same topics talked about
here? I’d really like to be a part of community where I can get opinions from other experienced individuals that share the same interest.
If you have any recommendations, please let me know. Appreciate it!
how to make bomb
25 Oct 25 at 6:23 am
555win – Sân Chơi Hoàn Hảo Cho Người Yêu Thích Đặt
Cược
555WIN là nền tảng giải trí trực tuyến dẫn đầu tại khu vực châu Á.
Tại đây, người chơi được tận hưởng
hệ thống game đa dạng từ casino trực tuyến, slot game đến các trò chơi
bài hấp dẫn. 555WIN cam kết bảo mật thông tin tuyệt đối, cùng các chương trình ưu đãi hấp dẫn, giúp bạn trải nghiệm giải trí an toàn và
thú vị. Hãy gia nhập 555WIN ngay hôm nay để trải nghiệm thế giới trò chơi đỉnh cao https://55511win.com/
555win
25 Oct 25 at 6:24 am
1xbetgiri? [url=https://1xbet-9.com/]https://1xbet-9.com/[/url] .
1xbet_wwSn
25 Oct 25 at 6:25 am
Мы работаем по модели «72 часа + 2 недели»: первые трое суток посвящены стабилизации витальных показателей, коррекции сна и сокращению «тяговых» откликов, следующие 14 дней — консолидации результата и запуску психотерапевтического блока. Маркеры прописываются заранее, поэтому и пациент, и семья понимают, когда и что мы будем оценивать, как корректируем план, если динамика ниже ожидаемой.
Детальнее – [url=https://narcologicheskaya-klinika-pervouralsk0.ru/]лечение в наркологической клинике[/url]
MatthewStall
25 Oct 25 at 6:25 am
OMT’ѕ proprietary analytic techniques make tackling һard inquiries
seеm lіke a game, assisting students establish
аn authentic love for mathematics and ideas t᧐ shine in examinations.
Transform mathematics obstacles іnto accomplishments with OMT
Math Tuition’s blend օf online ɑnd оn-site alternatives, ƅacked by а
track record of student excellence.
Ꮤith students іn Singapore begіnning official math education from day one and dealing wіth high-stakes assessments,
math tuition օffers the additional edge required t᧐ achieve leading performance іn this essential topic.
primary school school math tuition improves rational
thinking, іmportant fօr interpreting PSLE concerns inncluding sequences and rational reductions.
Ꮐiven thе high risks ⲟf O Levels for high school progression in Singapore,
math tuition mаkes the most of opportunities f᧐r leading grades and desired placements.
Ꮩia regular mock tests аnd thorough responses, tuition aids junior university student identify аnd correct weaknesses bеfore the actual A
Levels.
OMT’s distinct approach featuress а curriculum tһat matche the MOE framework ᴡith collaborative
components, encouraging peer discussions ᧐n mathematics
concepts.
The sʏstem’s resources аre upgraded on a regular basis one,
maintaining you straightened ѡith lɑtest syllabus
for grade increases.
Іn Singapore, wheгe math proficiency opｅns doors to STEM jobs, tuition іs essential fօr strong test foundations.
Μy website – ip math tuition bukit timah
ip math tuition bukit timah
25 Oct 25 at 6:26 am
1xbet resmi giri? [url=https://1xbet-7.com/]https://1xbet-7.com/[/url] .
1xbet_heol
25 Oct 25 at 6:27 am
1xbet mobil giri? [url=https://1xbet-4.com/]https://1xbet-4.com/[/url] .
1xbet_juol
25 Oct 25 at 6:27 am
MCP WordPress
WilliamJet
25 Oct 25 at 6:27 am
https://t.me/bs_1xbet/16
https://t.me/s/bs_1xbet/18
25 Oct 25 at 6:27 am
https://t.me/bs_1xbet/25
https://t.me/s/bs_1xbet/44
25 Oct 25 at 6:28 am
купить аттестат за 9 класс [url=www.rudik-diplom6.ru/]купить аттестат за 9 класс[/url] .
Diplomi_qvKr
25 Oct 25 at 6:28 am
pastorjorgetrujillo.com – The site loads quickly, making browsing smooth and enjoyable.
Rex Thornborough
25 Oct 25 at 6:29 am
This web site certainly has all of the information I needed about this subject and didn’t know who to ask.
read more
25 Oct 25 at 6:29 am
Для жителей Каменска-Уральского мы организовали быстрый и незаметный доступ к помощи. Координатор принимает обращения круглосуточно, уточняет адрес, особенности подъезда, пожелания по конфиденциальности и удобные «окна» визита. Бригады приезжают без опознавательных знаков, расходные материалы — в нейтральной упаковке, а формулировки в документах исключают нежелательные «ярлыки». Если дома временно нельзя обеспечить тишину и безопасность, мы «тихо» переводим пациента в палату краткого наблюдения: отдельный вход, короткий маршрут, минимум контактов и быстрое возвращение к домашнему формату после стабилизации.
Ознакомиться с деталями – [url=https://narkologicheskaya-klinika-kamensk-uralskij0.ru/]лечение в наркологической клинике[/url]
Brandonrig
25 Oct 25 at 6:33 am
купить диплом химика [url=www.rudik-diplom14.ru]купить диплом химика[/url] .
Diplomi_ndea
25 Oct 25 at 6:37 am
Hi there every one, here every one is sharing such knowledge, so
it’s nice to read this website, and I used to pay a quick visit this webpage
daily.
23WIN
25 Oct 25 at 6:37 am
This game looks amazing! The way it blends that old-school chicken crossing concept with actual consequences is brilliant.
Count me in!
Okay, this sounds incredibly fun! Taking that nostalgic chicken crossing gameplay and
adding real risk? I’m totally down to try it.
This is right up my alley! I’m loving the combo of classic chicken crossing mechanics with genuine stakes involved.
Definitely want to check it out!
Whoa, this game seems awesome! The mix of that timeless chicken crossing feel
with real consequences has me hooked. I need to play this!
This sounds like a blast! Combining that iconic chicken crossing gameplay with actual stakes?
Sign me up!
I’m so into this concept! The way it takes that
classic chicken crossing vibe and adds legitimate risk is genius.
Really want to give it a go!
This game sounds ridiculously fun! That fusion of nostalgic chicken crossing action with
real-world stakes has me interested. I’m ready
to jump in!
Holy cow, this looks great! Merging that beloved chicken crossing style with tangible consequences?
I’ve gotta try this out!
chicken road download apk
25 Oct 25 at 6:37 am
мобильные прокси купить Мобильные прокси с ротацией являются вершиной мастерства в мире прокси. Они автоматически меняют ваш IP-адрес через заданный промежуток времени, делая практически невозможным отслеживание вашей онлайн-активности. Эта технология идеально подходит для задач, требующих абсолютно максимальной анонимности и устойчивости к блокировкам. Инвестиции в мобильные прокси с ротацией – это инвестиции в неограниченные возможности и полную свободу действий в цифровом пространстве.
RobertGrirl
25 Oct 25 at 6:38 am
Howdy! I know this is kinda off topic nevertheless I’d figured I’d ask.
Would you be interested in trading links
or maybe guest writing a blog post or vice-versa?
My blog discusses a lot of the same subjects as yours and I think we could greatly benefit
from each other. If you might be interested
feel free to send me an e-mail. I look forward to hearing from you!
Terrific blog by the way!
rox casino фриспины
25 Oct 25 at 6:38 am
J’adore l’elegance de Impressario Casino, on ressent une ambiance delicate. Il y a une abondance de jeux captivants, comprenant des jeux compatibles avec les cryptos. 100% jusqu’a 500 € + tours gratuits. L’assistance est efficace et professionnelle, avec une aide precise. Le processus est simple et elegant, cependant des bonus plus varies seraient un delice. En bref, Impressario Casino est un incontournable pour les amateurs pour les joueurs en quete d’excitation ! En bonus la plateforme est visuellement somptueuse, donne envie de prolonger l’experience. Egalement appreciable les evenements communautaires engageants, assure des transactions fiables.
Apprendre aujourd’hui|
NiceNoirT5zef
25 Oct 25 at 6:38 am
opensky-inc.com – It would help to see more detailed content or case studies to add depth.
Josephina Pardy
25 Oct 25 at 6:38 am
1xbet turkey [url=1xbet-7.com]1xbet-7.com[/url] .
1xbet_nwol
25 Oct 25 at 6:39 am
J’ai une passion ardente pour Monte Cryptos Casino, ca offre une sensation futuriste unique. La selection de jeux est astronomique, avec des slots aux designs modernes. 100% jusqu’a 300 € + tours gratuits. Disponible 24/7 via chat ou email, offrant des solutions claires. Les transferts sont fiables, cependant des recompenses supplementaires seraient ideales. En bref, Monte Cryptos Casino garantit un plaisir constant pour ceux qui parient avec des cryptos ! En bonus la plateforme est visuellement eblouissante, ajoute une touche de sophistication. Un atout cle les paiements securises en BTC/ETH, propose des avantages uniques.
VГ©rifier ceci|
GlitchWaveR2zef
25 Oct 25 at 6:39 am
Je suis stupefait par Monte Cryptos Casino, ca transporte dans un cosmos chiffre. Le catalogue est opulent et diversifie, proposant des jeux de table elegants. Le bonus d’accueil est eclatant. L’assistance est efficace et professionnelle, garantissant un service de pointe. Le processus est lisse comme un wallet, cependant quelques tours gratuits en plus seraient bienvenus. Dans l’ensemble, Monte Cryptos Casino est un must pour les fans de blockchain pour les amateurs de casino en ligne ! A noter le site est rapide et futuriste, facilite une immersion totale. Un atout cle les tournois reguliers pour la competition, propose des avantages uniques.
Entrer maintenant|
DigitalDriftZ3zef
25 Oct 25 at 6:40 am
1xbet t?rkiye giri? [url=https://1xbet-9.com/]https://1xbet-9.com/[/url] .
1xbet_koSn
25 Oct 25 at 6:40 am
http://herengezondheid.com/# Sildenafil zonder recept bestellen
Hermanereli
25 Oct 25 at 6:41 am
Greetings! Very useful advice within this article!
It is the little changes that produce the biggest changes.
Many thanks for sharing!
Đăng nhập fk22
25 Oct 25 at 6:41 am
Как купить Ксанакс в Коврове?Люди, помогите где брать – нашел https://rutopik.ru
. По деньгам нормально, доставка заявлена. Кто-нибудь знаком с ними? Как работают?
Stevenref
25 Oct 25 at 6:42 am
1xbet yeni giri? [url=https://www.1xbet-4.com]https://www.1xbet-4.com[/url] .
1xbet_mjol
25 Oct 25 at 6:44 am
1xbet turkiye [url=http://1xbet-7.com]http://1xbet-7.com[/url] .
1xbet_wcol
25 Oct 25 at 6:45 am
Amazing issues here. I am very happy to look your post. Thank you so
much and I’m taking a look forward to touch you.
Will you kindly drop me a mail?
read here
25 Oct 25 at 6:45 am