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!
https://mama-kenguru.ru
RandyEluse
13 Oct 25 at 6:11 am
В этом обзорном материале представлены увлекательные детали, которые находят отражение в различных аспектах жизни. Мы исследуем непонятные и интересные моменты, позволяя читателю увидеть картину целиком. Погрузитесь в мир знаний и удивительных открытий!
Обратиться к источнику – https://ohoagency.com/product/flat-shoes
Timothymotly
13 Oct 25 at 6:14 am
где купить диплом техникума моих [url=https://frei-diplom8.ru]где купить диплом техникума моих[/url] .
Diplomi_gmsr
13 Oct 25 at 6:14 am
What’s up, yeah this post is actually pleasant and I have
learned lot of things from it concerning blogging. thanks.
분당가라오케
13 Oct 25 at 6:14 am
купить диплом в уссурийске [url=rudik-diplom7.ru]rudik-diplom7.ru[/url] .
Diplomi_olPl
13 Oct 25 at 6:14 am
купить диплом в кургане занесением в реестр [url=http://frei-diplom3.ru/]купить диплом в кургане занесением в реестр[/url] .
Diplomi_wbKt
13 Oct 25 at 6:17 am
купить диплом в междуреченске [url=http://www.rudik-diplom2.ru]http://www.rudik-diplom2.ru[/url] .
Diplomi_xhpi
13 Oct 25 at 6:18 am
купить диплом медсестры [url=http://frei-diplom14.ru/]купить диплом медсестры[/url] .
Diplomi_gqoi
13 Oct 25 at 6:20 am
zudena for sale
zudena for sale
13 Oct 25 at 6:21 am
growthverse – A pleasure to browse, everything is well-organized and clear.
Myron Randahl
13 Oct 25 at 6:22 am
диплом нефтяного техникума купить [url=www.frei-diplom8.ru/]диплом нефтяного техникума купить[/url] .
Diplomi_tlsr
13 Oct 25 at 6:24 am
Ⴝmall-group on-site classes аt OMT produce a helpful
community ѡhere pupils share math explorations, sparking a love for the subject tһat thrusts tһem
toward examination success.
Ԍet ready for success in upcoming exams ᴡith OMT Math Tuition’ѕ
exclusive curriculum, developed t᧐ promote critical thinking and ѕelf-confidence in ｅverｙ trainee.
Singapore’ѕ emphasis on critical believing tһrough mathematics highlights tһe value of math tuition, whіch
helps trainees establish thｅ analytical skills required ƅy the nation’s forward-thinking curriculum.
Ԝith PSLE mathematics concerns frequently including real-ѡorld
applications, tuition ߋffers targeted practice tߋ develop imρortant thinking skills essential
fоr һigh ratings.
Givｅn the hіgh stakes of O Levels fоr high school progression іn Singapore, math tuition makes best use of
opportunities fοr leading grades and preferred positionings.
Вｙ providing extensive experiment рast Α Level exam papers, math
tuition acquaints trainees ᴡith question styles ɑnd
marking planjs f᧐r ideal performance.
Ԝhat sets apart OMT іѕ іts custom educational program tһat lines uⲣ with MOE wһile concentrating on metacognitive skills, instructing students һow to discover mathemaatics properly.
Ιn-depth services offered ⲟn the internet leh, mentor yoᥙ eҳactly һow
tߋ resolve pｒoblems appropriately fߋr fаr bettеr
grades.
Math tuition in littⅼe groups ensres personalized
interest, typically ɗoing not have in larցе Singapore school classes fߋr examination prep.
Feel free t᧐ visit mу blog; math tuition singapore
math tuition singapore
13 Oct 25 at 6:25 am
Ativan lindert Angstzustande schnell. Langfristige Anwendung kann Abhangigkeit verursachen.
Pravachol
ThomasInvag
13 Oct 25 at 6:27 am
купить диплом косметолога [url=rudik-diplom7.ru]купить диплом косметолога[/url] .
Diplomi_ncPl
13 Oct 25 at 6:28 am
диплом медсестры с аккредитацией купить [url=https://www.frei-diplom14.ru]диплом медсестры с аккредитацией купить[/url] .
Diplomi_wloi
13 Oct 25 at 6:29 am
аренда погрузчиков в москве и московской области [url=www.arenda-ekskavatora-pogruzchika-cena-2.ru/]www.arenda-ekskavatora-pogruzchika-cena-2.ru/[/url] .
arenda ekskavatora pogryzchika cena_eust
13 Oct 25 at 6:32 am
В этой статье вы найдете уникальные исторические пересечения с научными открытиями. Каждый абзац — это шаг к пониманию того, как наука и события прошлого создают основу для технологического будущего.
Прочесть заключение эксперта – https://www.od-bau-gmbh.de/blog_single_layout_overlay
Michaelled
13 Oct 25 at 6:33 am
Ich bin abhangig von SpinBetter Casino, es fuhlt sich an wie ein Strudel aus Freude. Die Titelvielfalt ist uberwaltigend, mit innovativen Slots und fesselnden Designs. Der Service ist von hoher Qualitat, bietet klare Losungen. Der Ablauf ist unkompliziert, obwohl mehr abwechslungsreiche Boni waren super. In Kurze, SpinBetter Casino bietet unvergessliche Momente fur Krypto-Enthusiasten ! Zusatzlich das Design ist ansprechend und nutzerfreundlich, was jede Session noch besser macht. Hervorzuheben ist die Community-Events, die den Spa? verlangern.
https://spinbettercasino.de/|
Miscusimerle3zef
13 Oct 25 at 6:36 am
диплом техникума старого образца купить в [url=https://frei-diplom8.ru]диплом техникума старого образца купить в[/url] .
Diplomi_bbsr
13 Oct 25 at 6:36 am
Выбор новогодней елки – это всегда ответственный и волнующий момент. Живая ель наполняет дом неповторимым хвойных ароматом, создавая атмосферу настоящего зимнего леса. Искусственные елки, в свою очередь, более практичны и долговечны, позволяя сохранить природу и избежать ежегодной утилизации.
Украшение елки – это целое искусство, передаваемое из поколения в поколение. Семейные реликвии, винтажные игрушки, самодельные украшения – все они хранят в себе историю и тепло домашнего очага. Разноцветные гирлянды, сверкающие шары, фигурки сказочных персонажей превращают елку в настоящее произведение искусства, даря радость и вдохновение. Где посоветуете [url=https://forum.sportmashina.com/index.php?threads/pokupka-elok-sosen-ot-nadezhnogo-postavschika.26324/]елки сосны – купить по выгодной ценя?[/url]
Kevincerne
13 Oct 25 at 6:37 am
диплом о высшем образовании с занесением в реестр купить [url=https://frei-diplom3.ru]диплом о высшем образовании с занесением в реестр купить[/url] .
Diplomi_wzKt
13 Oct 25 at 6:37 am
Cheers. I enjoy this.
https://stellargazebrokage.com.ng/author/rudygrayndler3/
13 Oct 25 at 6:37 am
https://myfashionhouse.ru
RandyEluse
13 Oct 25 at 6:37 am
купить диплом в нальчике [url=www.rudik-diplom7.ru]купить диплом в нальчике[/url] .
Diplomi_jdPl
13 Oct 25 at 6:39 am
forzest without prescription
forzest without prescription
13 Oct 25 at 6:43 am
https://litenews.com.ua/food/sekret-idealnyh-cheburekiv-yak-zrobyty-tisto-hrustkym-a-nachynku-nadzvychajno-sokovytoyu-5824/
Jamesdrild
13 Oct 25 at 6:46 am
1win canlı kazino [url=1win5004.com]1win5004.com[/url]
1win_uroi
13 Oct 25 at 6:47 am
В этом информативном тексте представлены захватывающие события и факты, которые заставят вас задуматься. Мы обращаем внимание на важные моменты, которые часто остаются незамеченными, и предлагаем новые перспективы на привычные вещи. Подготовьтесь к тому, чтобы быть поглощенным увлекательными рассказами!
ТОП-5 причин узнать больше – https://raidlayer.in/appsara-a-rapid-enterprise-and-e-commerce-mobile-app-development-platform
Nolanwet
13 Oct 25 at 6:47 am
This article is actually a fastidious one it helps new internet viewers, who are wishing for blogging.
Fermo Fluxor
13 Oct 25 at 6:48 am
forzest without prescription
forzest without prescription
13 Oct 25 at 6:49 am
Prednisolone tablets UK online: cheap prednisolone in UK – MedRelief UK
JamesDes
13 Oct 25 at 6:49 am
купить диплом менеджера [url=http://rudik-diplom7.ru]купить диплом менеджера[/url] .
Diplomi_tlPl
13 Oct 25 at 6:50 am
купить диплом в ельце [url=http://rudik-diplom2.ru]http://rudik-diplom2.ru[/url] .
Diplomi_qkpi
13 Oct 25 at 6:51 am
J’adore l’ambiance de Locowin Casino, on ressent une vibe delirante. Le catalogue est riche et diversifie, incluant des paris sportifs palpitants. Amplifiant l’experience initiale. Les agents repondent avec rapidite, joignable a toute heure. Les paiements sont securises et fluides, cependant des bonus plus varies seraient bienvenus. Dans l’ensemble, Locowin Casino est un incontournable pour les joueurs pour ceux qui aiment parier en crypto ! Cerise sur le gateau la plateforme est visuellement top, donne envie de prolonger l’experience. Un plus non negligeable le programme VIP avec des niveaux exclusifs, assure des transactions fiables.
Voir les dГ©tails|
CrazySpinQ4zef
13 Oct 25 at 6:52 am
Эта информационная заметка содержит увлекательные сведения, которые могут вас удивить! Мы собрали интересные факты, которые сделают вашу жизнь ярче и полнее. Узнайте нечто новое о привычных аспектах повседневности и откройте для себя удивительный мир информации.
ТОП-5 причин узнать больше – https://latinloyalty.com/hello-world
Edwarddug
13 Oct 25 at 6:52 am
аренда экскаватора погрузчика в москве [url=https://arenda-ekskavatora-pogruzchika-cena-2.ru/]аренда экскаватора погрузчика в москве[/url] .
arenda ekskavatora pogryzchika cena_adst
13 Oct 25 at 6:55 am
диплом медсестры с аккредитацией купить [url=https://www.frei-diplom15.ru]диплом медсестры с аккредитацией купить[/url] .
Diplomi_rwoi
13 Oct 25 at 6:55 am
https://reality38261.blogzet.com/detox-examen-de-orina-cosas-que-debe-saber-antes-de-comprar-52593947
Limpieza para examen de miccion se ha convertido en una solucion cada vez mas popular entre personas que necesitan eliminar toxinas del sistema y superar pruebas de deteccion de drogas. Estos suplementos estan disenados para facilitar a los consumidores a depurar su cuerpo de componentes no deseadas, especialmente las relacionadas con el ingesta de cannabis u otras sustancias.
Uno buen detox para examen de pipi debe proporcionar resultados rapidos y visibles, en especial cuando el tiempo para prepararse es limitado. En el mercado actual, hay muchas opciones, pero no todas prometen un proceso seguro o fiable.
De que funciona un producto detox? En terminos simples, estos suplementos funcionan acelerando la expulsion de metabolitos y toxinas a traves de la orina, reduciendo su concentracion hasta quedar por debajo del umbral de deteccion de algunos tests. Algunos funcionan en cuestion de horas y su impacto puede durar entre 4 a seis horas.
Resulta fundamental combinar estos productos con adecuada hidratacion. Beber al menos 2 litros de agua diariamente antes y despues del ingesta del detox puede mejorar los resultados. Ademas, se recomienda evitar alimentos dificiles y bebidas azucaradas durante el proceso de uso.
Los mejores productos de limpieza para orina incluyen ingredientes como extractos de naturales, vitaminas del grupo B y minerales que apoyan el funcionamiento de los sistemas y la funcion hepatica. Entre las marcas mas destacadas, se encuentran aquellas que tienen certificaciones sanitarias y estudios de prueba.
Para usuarios frecuentes de cannabis, se recomienda usar detoxes con tiempos de accion largas o iniciar una preparacion anticipada. Mientras mas extendida sea la abstinencia, mayor sera la potencia del producto. Por eso, combinar la organizacion con el uso correcto del suplemento es clave.
Un error comun es suponer que todos los detox actuan igual. Existen diferencias en formulacion, sabor, metodo de toma y duracion del impacto. Algunos vienen en envase liquido, otros en capsulas, y varios combinan ambos.
Ademas, hay productos que incluyen fases de preparacion o purga previa al dia del examen. Estos programas suelen instruir abstinencia, buena alimentacion y descanso adecuado.
Por ultimo, es importante recalcar que ningun detox garantiza 100% de exito. Siempre hay variables personales como metabolismo, nivel de consumo, y tipo de examen. Por ello, es vital seguir las instrucciones del fabricante y no descuidarse.
JuniorShido
13 Oct 25 at 6:56 am
nigger
Brentsek
13 Oct 25 at 6:56 am
valuevision – Navigation is decent, but some links need clearer labels.
Francisco Babbitt
13 Oct 25 at 6:57 am
В этой статье вы найдете уникальные исторические пересечения с научными открытиями. Каждый абзац — это шаг к пониманию того, как наука и события прошлого создают основу для технологического будущего.
Почему это важно? – https://siciliammare.it/sicurezza-alimentare-lasp-di-palermo-a-lampedusa-per-freschezza-del-pesce-e-rischi-sanitari_8884
MatthewJag
13 Oct 25 at 6:57 am
Erleben Sie die beste Nuru Massage in Bangkok. Sinnliche, erotische und VIP-Massagen, Seifenmassage und Happy-End-Erlebnisse in luxuriösem Ambiente.
Echte Fotos, echte Masseusen, echtes Vergnügen.
Nuru Massage
13 Oct 25 at 6:58 am
Этот информационный обзор станет отличным путеводителем по актуальным темам, объединяющим важные факты и мнения экспертов. Мы исследуем ключевые идеи и представляем их в доступной форме для более глубокого понимания. Читайте, чтобы оставаться в курсе событий!
Исследовать вопрос подробнее – https://spotifybrasil.com.br/where-to-spent-summer
Darrenrunda
13 Oct 25 at 7:00 am
купить диплом в магадане [url=https://rudik-diplom2.ru]купить диплом в магадане[/url] .
Diplomi_pnpi
13 Oct 25 at 7:01 am
купить проведенный диплом вуза [url=https://frei-diplom3.ru/]https://frei-diplom3.ru/[/url] .
Diplomi_ckKt
13 Oct 25 at 7:02 am
https://litenews.com.ua/ru/food/kompot-iz-vishni-kotoryj-idealno-dopolnit-stol-uznajte-kak-sdelat-ego-idealnym-4745/
Jamesdrild
13 Oct 25 at 7:03 am
https://letopromo.ru
RandyEluse
13 Oct 25 at 7:04 am
tripscan
WillieCot
13 Oct 25 at 7:06 am
купить диплом парикмахера [url=www.rudik-diplom2.ru/]купить диплом парикмахера[/url] .
Diplomi_dqpi
13 Oct 25 at 7:07 am
где купить диплом колледжа в казахстане [url=https://frei-diplom9.ru/]https://frei-diplom9.ru/[/url] .
Diplomi_xaea
13 Oct 25 at 7:11 am