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!
Кроме стандартного вывода из запоя и детоксикации, врач клиники «Реабилитация Плюс» может предложить дополнительные процедуры, направленные на полноценное восстановление пациента:
Углубиться в тему – https://narcolog-na-dom-sochi00.ru/vyzov-narkologa-na-dom-sochi/
Hi to all, the contents existing at this site
are actually amazing for people experience, well, keep up the
nice work fellows.
шторы Уличные шторы – это отличный способ создать уютную атмосферу на террасе или в саду. Шторы на кухню
Покупка документа о высшем образовании через качественную и надежную фирму дарит ряд плюсов. Приобрести диплом о высшем образовании: [url=http://aegiscareandstaff.com/employer/diplomirovans]aegiscareandstaff.com/employer/diplomirovans[/url]
I’ve heard great things about Nitric Boost Ultra—especially how it gives
a natural energy lift without the crash. Sounds like a solid addition for anyone looking to boost mood and performance sustainably!
купить в иваново диплом [url=http://www.arus-diplom3.ru]купить в иваново диплом[/url] .
Thousands share their rehab journey, from detox to sober living — explore their stories.
Read more – group chat for quitting drugs
It’s truly very complex in this busy life to
listen news on TV, therefore I just use the web for that purpose, and take the
hottest information.
мостбет ставки мостбет ставки
I am sure this post has touched all the internet visitors, its
really really pleasant paragraph on building up new webpage.
mostbet.com uz http://www.mbtest123.ru
Does your website have a contact page? I’m having a tough time locating
it but, I’d like to send you an email. I’ve got some creative ideas
for your blog you might be interested in hearing.
Either way, great website and I look forward to seeing it grow
over time.
mostbet apk android https://mostbet4010.ru/
Особое внимание в клинике уделяется предотвращению рецидивов. Мы обучаем пациентов навыкам управления стрессом и эмоциональной стабильности, помогая формировать здоровые привычки. Это способствует долгосрочному восстановлению и снижает вероятность возвращения к зависимости.
Подробнее – https://медицинский-вывод-из-запоя.рф/vyvod-iz-zapoya-anonimno-v-rostove-na-donu.xn--p1ai
It’s great to see a program focused on real results like reducing pain and
getting people moving again. Ageless Knees sounds like
a natural, effective way to regain confidence in daily
activities. Thanks for sharing this!
Asking questions are really good thing if you are not understanding something fully, but this post offers pleasant
understanding even.
Зависимость — это коварное хроническое заболевание, затрагивающее как физическое, так и психическое здоровье человека. Она воздействует на волю и разум, искажает восприятие реальности и разрушает жизни, семьи и судьбы. Алкоголизм, наркомания и игровая зависимость — все это проявления одной и той же проблемы, требующей комплексного и профессионального подхода.
Узнать больше – https://надежный-вывод-из-запоя.рф/vyvod-iz-zapoya-anonimno-v-voronezhe.xn--p1ai/
mental health app http://mental-health3.com .
mental health chatbot mental-health5.com .
I think this is one of the most important information for me.
And i’m glad reading your article. But wanna remark on few general things, The site style is ideal,
the articles is really nice : D. Good job, cheers
Особое внимание в клинике уделяется предотвращению рецидивов. Мы обучаем пациентов навыкам управления стрессом и эмоциональной стабильности, помогая формировать здоровые привычки. Это способствует долгосрочному восстановлению и снижает вероятность возвращения к зависимости.
Углубиться в тему – https://медицинский-вывод-из-запоя.рф/
После процедуры пациент чувствует значительное облегчение состояния, улучшение самочувствия и снижение тяги к алкоголю.
Разобраться лучше – вызвать капельницу от запоя в сочи
mental health chatbot [url=https://www.mental-health3.com]https://www.mental-health3.com[/url] .
Быстро заказать диплом университета. Покупка документа о высшем образовании через качественную и надежную компанию дарит ряд достоинств для покупателя. Такое решение позволяет сберечь как дорогое время, так и серьезные финансовые средства. orikdok-2v-gorode-tula-71.online
мостбет скачать на андроид [url=http://mostbet11002.ru/]http://mostbet11002.ru/[/url]
Заказать диплом на заказ в столице вы сможете через официальный сайт компании. orikdok-2v-gorode-kazan-16.online
После завершения процедур врач дает пациенту и его родственникам подробные рекомендации по дальнейшему восстановлению и профилактике рецидивов.
Получить дополнительную информацию – http://narcolog-na-dom-krasnodar00.ru/vyzov-narkologa-na-dom-krasnodar/https://narcolog-na-dom-krasnodar00.ru
Admiring the hard work you put into your site and detailed information you present.
It’s good to come across a blog every once in a while that isn’t the same out
of date rehashed material. Great read! I’ve saved your site and I’m
including your RSS feeds to my Google account.
Заказать диплом о высшем образовании. Приобретение подходящего диплома через надежную фирму дарит множество достоинств для покупателя. Такое решение позволяет сберечь как личное время, так и серьезные финансовые средства. orikdok-3v-gorode-kirov-43.online
значки из латуни на заказ znacki-na-zakaz.ru .
Купить диплом под заказ в Москве возможно через сайт компании. orikdok-5v-gorode-syktyvkar-11.online
ставки на спорт бишкек http://mostbet11003.ru
mostbet ro’yxatdan o’tish [url=http://mostbet4007.ru/]http://mostbet4007.ru/[/url]
железные значки http://znacki-na-zakaz.ru .
штора для ванной Купить шторы – это значит добавить в свой дом немного тепла и уюта, создать атмосферу, в которой будет приятно находиться. Карниз для штор
автоломбард под залог птс
proavtolombard-pts65.ru/kazan.html
займ под птс авто
Заказать диплом о высшем образовании. Заказ документа о высшем образовании через проверенную и надежную компанию дарит немало достоинств. Это решение дает возможность сберечь время и значительные деньги. [url=http://orikdok-v-gorode-irkutsk-38.online/]orikdok-v-gorode-irkutsk-38.online[/url]
1win download apk [url=www.1win3010.com]www.1win3010.com[/url]
металлические значки на заказ цена [url=znacki-na-zakaz.ru]znacki-na-zakaz.ru[/url] .
Купить диплом на заказ можно используя официальный портал компании. [url=http://orikdok-3v-gorode-cheboksary-21.online/]orikdok-3v-gorode-cheboksary-21.online[/url]
Мы активно используем методы, такие как когнитивно-поведенческая терапия, гештальт-терапия и арт-терапия, помогая пациентам преодолеть психологические травмы и внутренние конфликты, лежащие в основе аддиктивного поведения. Также наши консультанты по химической зависимости предоставляют информационную поддержку пациентам и их семьям, помогая разобраться в вопросах лечения, реабилитации и социальной адаптации.
Исследовать вопрос подробнее – http://надежный-вывод-из-запоя.рф/vyvod-iz-zapoya-anonimno-v-voronezhe.xn--p1ai/
“Обратился в ‘Ренессанс’ с алкоголизмом. Лечение было непростым, но врачи поддерживали меня на каждом шагу. Сейчас я живу трезво и очень благодарен за это.” — Дмитрий, 38 лет”Много лет боролась с зависимостью от марихуаны и наконец нашла помощь здесь. ‘Ренессанс’ предложила грамотный подход, и с их помощью я справилась.” — Екатерина, 25 лет”Страдал от лудомании и знал, что сам не справлюсь. Врачи предложили методы, которые помогли мне избавиться от зависимости. Теперь азартные игры — это прошлое.” — Алексей, 41 год
Разобраться лучше – https://качество-вывод-из-запоя.рф/vyvod-iz-zapoya-v-kruglosutochno-v-permi.xn--p1ai
деньги под птс без отказа
zaimpod-pts89.ru/ekb.html
получить кредит под залог птс
Чат с психологом. С кем можно поговорить. Анонимный чат поддержки.
Во время процедуры врач контролирует состояние больного, по необходимости корректирует лечение, чтобы добиться максимального терапевтического эффекта. После проведения детоксикации пациенту назначается курс поддерживающей терапии, а также даются рекомендации по дальнейшему восстановлению и профилактике рецидивов.
Исследовать вопрос подробнее – http://narcolog-na-dom-sochi0.ru/vyzov-narkologa-na-dom-sochi/
Hey this is kinda of off topic but I was wondering if blogs use WYSIWYG editors or if you have to manually code with HTML. I’m starting a blog soon but have no coding experience so I wanted to get advice from someone with experience. Any help would be enormously appreciated!
quanto dura l’effetto del tadalafil 5 mg?
Мы предлагаем документы об окончании любых ВУЗов России. Документы производятся на фирменных бланках. blogs.rufox.ru/~worksale/66865.htm
Экстренная установка капельницы необходима, если пациент находится в состоянии запоя более 2–3 дней или испытывает симптомы тяжелой интоксикации алкоголем:
Получить дополнительные сведения – https://kapelnica-ot-zapoya-sochi00.ru/kapelnicza-ot-zapoya-czena-sochi
После поступления вызова клиника «ЗдоровьеНорм» отправляет к пациенту опытного нарколога, который прибывает на дом в течение 30–60 минут. По приезду врач проводит комплексную диагностику, включающую измерение артериального давления, пульса, уровня кислорода в крови и тщательную оценку общего состояния пациента. На основе полученных данных специалист подбирает индивидуальную схему лечения.
Исследовать вопрос подробнее – http://narcolog-na-dom-krasnodar0.ru
Алкогольная и наркотическая зависимость требуют незамедлительного и комплексного вмешательства для предотвращения серьезных осложнений и сохранения здоровья пациента. В Уфе, Республика Башкортостан, опытные наркологи выезжают на дом 24 часа в сутки, предоставляя оперативную помощь при запоях и в случаях наркотической интоксикации. Такой формат лечения позволяет начать детоксикацию в комфортной, привычной обстановке, обеспечивая максимальную конфиденциальность и индивидуальный подход к каждому пациенту.
Ознакомиться с деталями – https://narcolog-na-dom-ufa000.ru/narkolog-na-dom-ufa-czeny