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://mostbet4124.ru/]https://mostbet4124.ru/[/url]
mostbet_wlsr
3 Sep 25 at 8:43 am
Hello! I just wanted to ask if you ever have any problems with hackers?
My last blog (wordpress) was hacked and I ended up losing months of hard work due to no back up.
Do you have any methods to protect against hackers?
more information
3 Sep 25 at 8:43 am
I think what you said made a great deal of sense.
However, think on this, what if you wrote a catchier post title?
I mean, I don’t want to tell you how to run your blog, however suppose
you added a post title to possibly get folk’s attention? I mean PHP hook, building hooks in your
application – Sjoerd Maessen blog at Sjoerd Maessen blog is a little vanilla.
You ought to peek at Yahoo’s home page and watch how they create post headlines to grab
people to open the links. You might try adding a video or a
picture or two to get readers interested about what you’ve got to
say. In my opinion, it could make your website
a little bit more interesting.
Stefanie
3 Sep 25 at 8:44 am
Если состояние слишком тяжёлое, или в анамнезе есть сердечно-сосудистые заболевания, может быть рекомендована госпитализация в стационар клиники «Светлый Мир». Там пациент находится под круглосуточным наблюдением и получает полный комплекс восстановительной терапии, включая психологическую поддержку и консультации психотерапевта.
Узнать больше – http://vyvod-iz-zapoya-domodedovo3.ru/
DennisTem
3 Sep 25 at 8:45 am
Visit the website https://mlbet-mbet.com/ and you will learn everything about the Melbet bookmaker, with which you can bet on sports and play in an online casino. Find out basic information, how to register, how to top up your balance and withdraw funds, everything about the mobile application and much more. Do not forget to use a profitable promo code on the website, which will give a number of advantages!
wuxurrdTUT
3 Sep 25 at 8:46 am
Howdy! I’m at work surfing around your blog from my new iphone!
Just wanted to say I love reading your blog and look forward to all your posts!
Carry on the superb work!
Facebook Ads
3 Sep 25 at 8:50 am
Hi friends, how is the whole thing, and what you want to say on the
topic of this piece of writing, in my view its genuinely awesome in favor of me.
پیش فروش سکه بانک مرکزی ۱۴۰۴
3 Sep 25 at 8:51 am
https://potofu.me/h6g3o7ie
KurtisTob
3 Sep 25 at 8:51 am
An interesting discussion is definitely
worth comment. I believe that you ought to publish more about this topic,
it may not be a taboo subject but usually people don’t
speak about these subjects. To the next! All the best!!
ดูซีรีย์
3 Sep 25 at 8:56 am
Ancient Tumble играть в Париматч
Darwinlix
3 Sep 25 at 8:56 am
https://t.me/bezposrednikov_omsk
https://t.me/bezposrednikov_omsk
3 Sep 25 at 8:57 am
проверить провайдеров по адресу краснодар
inernetvkvartiru-krasnodar005.ru
провайдеры по адресу дома
inernetkrdelini
3 Sep 25 at 8:59 am
Nice post. I learn something new and challenging on sites I stumbleupon every day.
It will always be useful to read through articles
from other writers and use a little something from their web
sites.
hair transplant turkey
3 Sep 25 at 9:00 am
выигрышные live ставки на мостбет [url=https://mostbet4120.ru/]https://mostbet4120.ru/[/url]
mostbet_tqpr
3 Sep 25 at 9:01 am
сайт мостбет [url=https://mostbet4119.ru/]https://mostbet4119.ru/[/url]
mostbet_deEt
3 Sep 25 at 9:03 am
регистрация на мостбет [url=https://mostbet4124.ru/]https://mostbet4124.ru/[/url]
mostbet_jssr
3 Sep 25 at 9:03 am
Мы изготавливаем дипломы любой профессии по приятным ценам. Покупка документа, который подтверждает обучение в университете, – это грамотное решение. Купить диплом университета: [url=http://social.elpaso.world/read-blog/26808_kupit-diplom-obrazovanie.html/]social.elpaso.world/read-blog/26808_kupit-diplom-obrazovanie.html[/url]
Mazrjnd
3 Sep 25 at 9:05 am
Your style is really unique compared to other people I’ve read stuff from.
I appreciate you for posting when you have the opportunity, Guess I will
just bookmark this site.
강남가라오케
3 Sep 25 at 9:08 am
Smart DNS
SmartStreaming.TV: the clever way to access your favorite programming anywhere
Nowadays, we consume series, films and music from almost any device: PCs, Smart TVs, video game systems, streaming devices and even cell phones.
However, anyone who has left their country knows how annoying it can be to check into a hotel or an airport and find out that the material we enjoy at home is not available in another country.
This is where SmartStreaming.TV comes into play, a solution designed to make your entertainment stay with you.
How does SmartStreaming.TV work?
Online services identify your location through the network address of your device. This means that, depending on the country you are in, you may have access (or blocks) to certain catalogs of films, series or live broadcasts.
The proposal of SmartStreaming.TV is simple but functional: the system masks your real location and gives you an IP address in the country where the catalog is available. In this way, you can enter your shows, movies and platforms as if you lived at home, no matter where you are.
Security, speed, and legality
One of the most common concerns when talking about this type of service is whether it is reliable or valid. In the case of SmartStreaming.TV, the answer is definite: absolutely.
The system operates through a protocol called Smart DNS, which does not keep your personal data or slow down your connection. It is fast, safe and 100% legal.
In addition, unlike other solutions that are more complex, you don’t need to install heavy programs or change your system deeply. The setup is quick and compatible with most modern devices.
Ideal for those who travel
If you travel for work, do an academic stay outside or simply enjoy exploring the world, SmartStreaming.TV becomes an fundamental resource.
You will no longer worry about missing the latest episode of your favorite show or not being able to watch a live sporting event.
In short, SmartStreaming.TV makes your fun authentically worldwide: no matter your location, access to your programming will be within easy reach.
Smart DNS
3 Sep 25 at 9:08 am
купить проведенный диплом вуза [url=http://arus-diplom33.ru/]http://arus-diplom33.ru/[/url] .
Diplomi_bySa
3 Sep 25 at 9:11 am
перевод текстов Перевод документов — это точная и юридически значимая работа, требующая не только лингвистической компетенции, но и внимательного отношения к оформлению, реквизитам и структуре исходного документа. В эту категорию входят свидетельства о рождении и браке, дипломы и приложения, доверенности, контракты, судебные решения и корпоративная документация — каждый тип документов имеет свои требования к оформлению и заверению. Переводчик должен корректно передать имена, даты, номера и официальные формулировки, а при необходимости указать транслитерацию или нормативные соответствия терминов в целевой юрисдикции. Для официального использования переводы часто требуют нотариального заверения или апостиля, поэтому при заказе важно заранее уточнить требования принимающей стороны — консульства, миграционные службы, университеты или работодатели. Стоимость и сроки зависят от объёма, сложности и необходимости дополнительных действий (верстка, нотариус, легализация), поэтому перед началом рекомендуется получить детальную смету и согласовать формат сдачи. Подготовка качественных сканов оригиналов и чёткие инструкции заказчика существенно ускоряют процесс и уменьшают риск ошибок.
GarryHax
3 Sep 25 at 9:13 am
https://www.metooo.io/u/68ae6485f6540f60fe1f0e57
KurtisTob
3 Sep 25 at 9:14 am
В этой публикации мы предлагаем подробные объяснения по актуальным вопросам, чтобы помочь читателям глубже понять их. Четкость и структурированность материала сделают его удобным для усвоения и применения в повседневной жизни.
Почему это важно? – https://pietrowicewielkie.de/friedhof/4images/details.php?image_id=1049&l=polski
ThomasBab
3 Sep 25 at 9:16 am
mostbet oficial [url=https://mostbet4122.ru/]mostbet oficial[/url]
mostbet_cbpl
3 Sep 25 at 9:17 am
Для тех, кто хочет качественный и современный метод к автомобилю — компания Allcartuning выполняет чип-тюнинг и ЭКО-тюнинг для автомобилей, грузовиков и производственного транспорта. С 2007-го наши услуги, сертифицированные TUV, дают увеличение мощности, динамику и экономию топлива. [url=https://china-avto-k.ru]https://china-avto-k.ru[/url] Посмотрите подробнее — оптимизация двигателя доступна на сайте.
Spravkijko
3 Sep 25 at 9:22 am
Great blog! Is your theme custom made or did you download it from somewhere?
A theme like yours with a few simple tweeks would really make
my blog shine. Please let me know where you got your theme.
Thanks a lot
Payment Gateway
3 Sep 25 at 9:22 am
All Ways Luck слот
Louisdut
3 Sep 25 at 9:23 am
Refresh Renovation Southwest Charlotte
1251 Arrow Pine Ɗr ⅽ121,
Charlotte, NC 28273, United Ⴝtates
+19803517882
Bookmarks
Bookmarks
3 Sep 25 at 9:24 am
mostbet официальный сайт скачать [url=https://mostbet4124.ru]mostbet официальный сайт скачать[/url]
mostbet_glsr
3 Sep 25 at 9:27 am
купить аттестат 11 класса в оренбурге [url=www.arus-diplom22.ru/]www.arus-diplom22.ru/[/url] .
Diplomi_frsl
3 Sep 25 at 9:29 am
диплом купить в реестре [url=www.arus-diplom33.ru/]диплом купить в реестре[/url] .
Diplomi_tjSa
3 Sep 25 at 9:30 am
купить диплом львов [url=https://www.educ-ua3.ru]купить диплом львов[/url] .
Diplomi_amki
3 Sep 25 at 9:31 am
Этот текст сочетает в себе элементы познавательного рассказа и аналитической подачи информации. Читатель получает доступ к уникальным данным, которые соединяют прошлое с настоящим и открывают двери в будущее.
Нажмите, чтобы узнать больше – https://barizaoman.com/experience-review-crowne-plaza-muscat
Davidaffer
3 Sep 25 at 9:33 am
https://juliusdpks486.huicopper.com/why-countertop-companies-across-50-states-compete-for-a-spot-in-the-ranking
Did you know that in the latest ranking, only around 2,000 companies earned a spot in the Top Countertop Contractors Ranking out of over ten thousand evaluated? That’s because at we set a very high bar.
Our ranking is unbiased, updated regularly, and built on dozens of criteria. These include ratings from Google, Yelp, and other platforms, quotes, communication, and results. On top of that, we conduct 5,000+ phone calls and multiple estimate requests through our mystery shopper program.
The result is a standard that benefits both clients and installation companies. Homeowners get a safe way to choose contractors, while listed companies gain prestige, digital exposure, and even more inquiries.
The Top 500 Awards spotlight categories like Veteran Companies, Best Young Companies, and Value Leaders. Winning one of these honors means a company has achieved unmatched credibility in the industry.
If you’re searching for a countertop contractor—or your company wants to stand out—this site is where quality meets visibility.
JuniorShido
3 Sep 25 at 9:35 am
Hello! I’ve been reading your site for a while now and finally got
the courage to go ahead and give you a shout out from Houston Texas!
Just wanted to mention keep up the good work!
Temeka
3 Sep 25 at 9:35 am
Even during his days off, Raul Morales gets spotted by fans. On a recent visit to Universal Studios Hollywood, Morales, owner of Taqueria Vista Hermosa in Los Angeles, was waiting in line when he heard shouting.
“People called out ‘Chef Al Pastor! Chef Al Pastor!’” Morales said, laughing. Morales, who was born in Mexico City, came by the nickname through decades of hard work.
[url=https://trip-scan39.org]tripscan top[/url]
He’s the third generation of his family to make al pastor tacos, their fresh tortillas filled with richly seasoned pork shaved from a rotating vertical spit.
“My recipe is very special, and very old,” he said.
Yet while Morales’ family recipes go back generations, and similar spit-roasted meats like shawarma and doner have been around for hundreds of years, his tacos represent a kind of cuisine that’s as contemporary and international as it is ancient and traditional. When you thread meat onto a spinning spit to roast it, it turns out, it doesn’t stay in one place for long.
https://trip-scan39.org
трипскан сайт
‘Any place you have a pointy stick or a sword’
Roasting meat on a spit or stick is likely among humans’ most ancient cooking techniques, says food historian Ken Albala, a professor of history at the University of the Pacific.
Feasts of spit-roasted meat appear in the Homeric epics The Iliad and The Odyssey, writes Susan Sherratt, emeritus professor of East Mediterranean archaeology at the University of Sheffield, in the journal Hesperia.
Iron spits that might have been used for roasting appear in the Aegean starting in the 10th century BCE. Such spits have been unearthed in tombs associated with male warriors, Sherratt writes, noting that roasting meat may have been a practice linked to male bonding and masculinity.
“I think the reason that it’s associated with men is partly because of hunting, and the tools, or weapons, that replicated what you would do in war,” Albala said. “When you celebrated a victory, you would go out and sacrifice an animal to the gods, which would basically be like a big barbecue.”
Roasting meat is not as simple as dangling a hunk of meat over the flames. When roasting, meat is not cooked directly on top of the heat source, Albala says, but beside it, which can generate richer flavors.
“Any place you have a pointy stick or a sword, people are going to figure out very quickly … if you cook with it off to the side of the fire, it’s going to taste much more interesting,” Albala said.
JustinCek
3 Sep 25 at 9:36 am
Having read this I believed it was very informative.
I appreciate you taking the time and energy to put this informative article together.
I once again find myself spending a lot of time both reading
and commenting. But so what, it was still worth it!
Hay88
3 Sep 25 at 9:36 am
I think this is among the most significant info for me.
And i’m glad reading your article. But wanna remark on few
general things, The web site style is perfect, the articles is really nice : D.
Good job, cheers
clean energy supplement skepticism
3 Sep 25 at 9:37 am
https://wirtube.de/a/deansorib.star/video-channels
KurtisTob
3 Sep 25 at 9:37 am
https://t.me/s/deposit_50_rub
Jamescib
3 Sep 25 at 9:38 am
I am in fact thankful to the holder of this web site who has shared this enormous article at here.
Mayra
3 Sep 25 at 9:40 am
В статье представлены ключевые моменты по актуальной теме, дополненные советами экспертов и ссылками на дополнительные ресурсы. Цель материала — дать читателю инструменты для самостоятельного развития и принятия осознанных решений.
Как достичь результата? – http://sinomach-hi.ru
AnthonyDrify
3 Sep 25 at 9:42 am
Hi to all, how is all, I think every one is getting more from this
website, and your views are pleasant in support of new
visitors.
Elvis
3 Sep 25 at 9:42 am
Hello it’s me, I am also visiting this site regularly,
this site is truly fastidious and the visitors are actually sharing nice thoughts.
pg66
3 Sep 25 at 9:42 am
Great goods from you, man. I have take into accout your stuff previous to and
you’re just too great. I actually like what you’ve bought here, really like what you’re stating and the best way through which you
say it. You are making it entertaining and
you continue to take care of to stay it sensible. I cant wait to read far more from
you. That is really a terrific web site.
git.vicagroup.com.cn
3 Sep 25 at 9:44 am
купить диплом занесенный реестр [url=http://arus-diplom35.ru]купить диплом занесенный реестр[/url] .
Bistro zakazat diplom o visshem obrazovanii!_oaot
3 Sep 25 at 9:45 am
мостбет войти [url=http://mostbet4122.ru/]мостбет войти[/url]
mostbet_gqpl
3 Sep 25 at 9:49 am
Этот информативный текст отличается привлекательным содержанием и актуальными данными. Мы предлагаем читателям взглянуть на привычные вещи под новым углом, предоставляя интересный и доступный материал. Получите удовольствие от чтения и расширьте кругозор!
Секреты успеха внутри – https://www.kayrana.com/decorating-and-furnishing-small-spaces
Edwardfaibe
3 Sep 25 at 9:56 am
motsbet [url=https://mostbet4126.ru]https://mostbet4126.ru[/url]
mostbet_kg_hzkn
3 Sep 25 at 9:57 am
Предлагаем вашему вниманию интересную справочную статью, в которой собраны ключевые моменты и нюансы по актуальным вопросам. Эта информация будет полезна как для профессионалов, так и для тех, кто только начинает изучать тему. Узнайте ответы на важные вопросы и расширьте свои знания!
Изучить вопрос глубже – http://www.javatech.ee/?attachment_id=10
Richardcrone
3 Sep 25 at 9:58 am