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!

Written by Sjoerd Maessen

May 23rd, 2011 at 8:02 pm

Posted in API

Tagged with modular, Observer, SPL, Subject

97,245 Responses to 'PHP hook, building hooks in your application'

Subscribe to comments with RSS or TrackBack to 'PHP hook, building hooks in your application'.

В больничных условиях «Частного Медика 24» врачи контролируют давление, сердце и функции жизненно важных органов при выводе из запоя.
Подробнее тут – [url=https://vyvod-iz-zapoya-v-stacionare-samara23.ru/]вывод из запоя в стационаре анонимно[/url]

Williamliz

19 Oct 25 at 10:07 am
Современная наркологическая клиника в Мариуполе ориентирована на комплексное и индивидуальное лечение алкогольной и наркотической зависимости, обеспечивая пациентам высококвалифицированную помощь с использованием доказанных медицинских протоколов и новейших технологий. Зависимость — это хроническое заболевание, требующее профессионального подхода, основанного на научных данных и многолетнем опыте специалистов.
Получить дополнительную информацию – [url=https://narkologicheskaya-klinika-mariupol13.ru/]наркологическая клиника стационар[/url]

Gilbertnup

19 Oct 25 at 10:14 am
купить диплом в юрге [url=https://www.rudik-diplom9.ru]купить диплом в юрге[/url] .

Diplomi_evei

19 Oct 25 at 10:14 am
купить диплом в мытищах [url=rudik-diplom4.ru]купить диплом в мытищах[/url] .

Diplomi_spOr

19 Oct 25 at 10:14 am
купить диплом в чайковском [url=http://www.rudik-diplom13.ru]купить диплом в чайковском[/url] .

Diplomi_laon

19 Oct 25 at 10:15 am
где купить дипломы медсестры [url=http://frei-diplom13.ru/]где купить дипломы медсестры[/url] .

Diplomi_crkt

19 Oct 25 at 10:15 am
I think the admin of this website is in fact working hard
in favor of his website, for the reason that here every material is quality based information.

Visit Your URL

19 Oct 25 at 10:16 am
кракен обмен
kraken vpn

JamesDaync

19 Oct 25 at 10:17 am
We’re a group of volunteers and opening a new scheme in our community.

Your website provided us with valuable information to work on. You have done
an impressive job and our whole community will be thankful to you.

77bet

19 Oct 25 at 10:17 am
À propos de Betify, il faut savoir que ce bookmaker/casino en ligne
existe depuis des années maintenant et qu’il a toujours opéré
en toute transparence et la légalité, dans
le respect de la loi.

Alfredo

19 Oct 25 at 10:18 am
Browse Kaizenaire.ⅽom fߋr Singapore’ѕ
top-tier option оf curated shopping promotions, discount rates, ɑnd special event deals.

Ԝith varied offerings, Singapore’ѕ shopping heaven satisfies promotion-craving residents.

Singaporeans ⅼike signing up ԝith flash crowds іn public rߋoms for spontaneous enjoyable,
and қeep іn mind tߋ stay updated оn Singapore’s mօѕt recent promotions ɑnd shopping deals.

CapitaLand Investment establishes ɑnd manages residential or commercial properties, treasured ƅy Singaporeans foг theіr iconic malls and residential areas.

Grеat Eastern provides life insurance policy ɑnd health care plans
lor, precious by Singaporeans for tһeir detailed protection аnd comfort in unpredictable tіmes
leh.

Dian Xiao Εr roasts natural ducks аnd Chinese рrices, cherished bʏ Singaporeans foг tasty marinates and family-style dining.

Eh, smart m᧐vｅ mah, surf Kaizenaire.com repeatedly lah.

Μy blog …best personal loans singapore

best personal loans singapore

19 Oct 25 at 10:20 am
купить диплом в муроме [url=http://www.rudik-diplom10.ru]купить диплом в муроме[/url] .

Diplomi_ltSa

19 Oct 25 at 10:21 am
где можно купить диплом медсестры [url=https://frei-diplom13.ru]где можно купить диплом медсестры[/url] .

Diplomi_rhkt

19 Oct 25 at 10:21 am
Hello there! Quick question that’s totally off topic.
Do you know how to make your site mobile friendly?
My blog looks weird when viewing from my apple iphone.
I’m trying to find a theme or plugin that might be able to fix this issue.
If you have any suggestions, please share. Thank
you!

webpage

19 Oct 25 at 10:21 am
условия бонуса в мелбет [url=melbetbonusy.ru]условия бонуса в мелбет[/url] .

melbet_ueOi

19 Oct 25 at 10:21 am
1win yangi domen [url=https://www.1win5510.ru]1win yangi domen[/url]

1win_uz_cwsi

19 Oct 25 at 10:23 am
купить диплом в азове [url=https://rudik-diplom9.ru/]купить диплом в азове[/url] .

Diplomi_vbei

19 Oct 25 at 10:23 am
мелбет приветственный бонус [url=https://www.melbetbonusy.ru]мелбет приветственный бонус[/url] .

melbet_zeOi

19 Oct 25 at 10:27 am
Thanks for finally talking about > PHP hook, building hooks in your application –
Sjoerd Maessen blog at Sjoerd Maessen blog < Loved it!

Smart Dog Collar

19 Oct 25 at 10:30 am
купить диплом в ангарске [url=https://rudik-diplom4.ru]купить диплом в ангарске[/url] .

Diplomi_esOr

19 Oct 25 at 10:30 am
Yes! Finally something about Conner Roofing.

roofing contractors

19 Oct 25 at 10:30 am
кракен vk4
кракен даркнет

JamesDaync

19 Oct 25 at 10:36 am
купить диплом в когалыме [url=https://rudik-diplom4.ru]https://rudik-diplom4.ru[/url] .

Diplomi_syOr

19 Oct 25 at 10:37 am
купить диплом в новосибирске [url=www.rudik-diplom10.ru]купить диплом в новосибирске[/url] .

Diplomi_kfSa

19 Oct 25 at 10:37 am
Hmm is anyone else experiencing problems with the images on this blog loading?
I’m trying to find out if its a problem on my end or if it’s the blog.
Any feed-back would be greatly appreciated.

water damage repair

19 Oct 25 at 10:39 am
Наша платформа https://probilets работает круглосуточно и не знает слова «перерыв». Бронировать и планировать можно где угодно: в поезде, на даче, в кафе или лежа на диване. Хотите купить билет, пока идёте по супермаркету? Просто достаньте телефон и оформите поездку. Нужно скорректировать планы, отменить или перенести билет? Это тоже можно сделать онлайн, без звонков и визитов.

IsmaelNek

19 Oct 25 at 10:40 am
купить диплом ссср [url=http://rudik-diplom10.ru]купить диплом ссср[/url] .

Diplomi_rbSa

19 Oct 25 at 10:46 am
купить диплом медицинского училища [url=https://rudik-diplom4.ru/]купить диплом медицинского училища[/url] .

Diplomi_spOr

19 Oct 25 at 10:48 am
1вин играть в казино [url=www.1win5509.ru]www.1win5509.ru[/url]

1win_uz_hpKt

19 Oct 25 at 10:50 am
1win yangi domen [url=https://www.1win5510.ru]1win yangi domen[/url]

1win_uz_lfsi

19 Oct 25 at 10:51 am
сайт мелбет [url=https://melbetbonusy.ru]https://melbetbonusy.ru[/url] .

melbet_ncOi

19 Oct 25 at 10:51 am
Вызов нарколога на дом в Краснодаре — услуга клиники «Детокс». Специалисты оказывают квалифицированную помощь прямо у вас дома.
Выяснить больше – [url=https://narkolog-na-dom-krasnodar27.ru/]вызвать врача нарколога на дом в краснодаре[/url]

DanielNus

19 Oct 25 at 10:54 am
kraken зеркало
kraken vpn

JamesDaync

19 Oct 25 at 10:56 am
Дизайнерский ремонт: искусство преображения пространства

Дизайн интерьера играет важную роль в создании комфортной и уютной атмосферы в доме. Сегодня мы поговорим о таком понятии, как дизайнерский ремонт, который позволяет превратить обычное жилье в уникальное пространство, отражающее индивидуальность владельца.
[url=https://designapartment.ru ]РґРёР·Р°Р№РЅРµСЂСЃРєРёР№ СЂРµРјРѕРЅС‚ РґРѕРјР°[/url]
Что такое дизайнерский ремонт?

Дизайнерский ремонт — это комплекс работ, направленных на создание оригинального дизайна помещения. Это не просто обновление отделки, а полноценный творческий процесс, включающий разработку концепции, подбор материалов и мебели, а также реализацию проекта.

Ключевые особенности дизайнерского ремонта:

– Индивидуальный подход к каждому проекту.
– Использование качественных материалов и современных технологий.
– Создание уникального стиля, соответствующего вкусам заказчика.
– Оптимизация пространства для максимального комфорта и функциональности.

Виды дизайнерских ремонтов
[url=https://designapartment.ru ]РґРёР·Р°Р№РЅРµСЂСЃРєРёР№ СЂРµРјРѕРЅС‚ РєРѕС‚С‚РµРґР¶Р° РјРѕСЃРєРІР°[/url]
Существует несколько видов дизайнерских ремонтов, каждый из которых имеет свои особенности и преимущества.

#1 Дизайнерский ремонт квартиры

Это наиболее распространенный вид ремонта, подходящий для тех, кто хочет обновить интерьер своей городской квартиры. Специалисты разрабатывают проект, учитывая размеры помещений, пожелания клиента и бюджет. Такой ремонт включает перепланировку, замену коммуникаций, отделочные работы и декорирование.

Пример дизайна: светлая гостиная с панорамными окнами, минималистичный дизайн кухни и спальни в стиле лофт.

#2 Дизайнерский ремонт дома

Такой ремонт предполагает полное преобразование жилого дома, начиная от фундамента и заканчивая крышей. Здесь важно учитывать архитектурные особенности здания, климатические условия региона и предпочтения владельцев. Часто используется экодизайн, натуральные материалы и энергосберегающие технологии.

Пример дизайна: просторный холл с камином, стеклянная веранда с видом на сад, спальня в пастельных тонах.
[url=https://designapartment.ru]РґРёР·Р°Р№РЅРµСЂСЃРєРёР№ СЂРµРјРѕРЅС‚ РєРѕС‚С‚РµРґР¶Р° РїРѕРґ РєР»СЋС‡[/url]
#3 Дизайнерский ремонт виллы

Ремонт вилл требует особого подхода, поскольку такие объекты часто расположены в живописных местах и имеют большую площадь. Важно сохранить гармонию с окружающей средой, используя природные материалы и цвета. Особое внимание уделяется созданию зон отдыха, бассейнов и садов.

Пример дизайна: роскошная вилла с бассейном, открытая терраса с видами на море, спальная зона в тропическом стиле.

#4 Дизайнерский ремонт коттеджа

Коттедж отличается от обычного дома наличием придомового участка и возможностью организации дополнительных функциональных зон. Ремонт коттеджей включает работу над фасадом, ландшафтом и внутренним пространством. Стили могут варьироваться от классики до хай-тека.

Пример дизайна: двухэтажный коттедж с мансардой, гостиная-столовая в скандинавском стиле, детская комната с игровой зоной.

#5 Дизайнерский ремонт пентхауса

Пентхаус — это элитное жилье, расположенное на верхних этажах зданий с панорамными видами. Для такого типа недвижимости характерны высокие потолки, большие окна и эксклюзивные элементы декора. Проектирование пентхауса требует учета особенностей конструкции здания и пожеланий клиентов относительно приватности и удобства.

Пример дизайна: современный пентхаус с открытой планировкой, кабинет с видом на город, зона отдыха с джакузи.

Заключение

Дизайнерский ремонт — это возможность создать идеальное пространство для жизни и отдыха. Независимо от того, хотите ли вы обновить квартиру, дом, виллу, коттедж или пентхаус, профессиональный подход гарантирует вам комфорт и эстетическое удовольствие на долгие годы.

https://designapartment.ru
РґРёР·Р°Р№РЅРµСЂСЃРєРёР№ СЂРµРјРѕРЅС‚ Р°РїР°СЂС‚Р°РјРµРЅС‚РѕРІ РїРѕРґ РєР»СЋС‡

GeraldZek

19 Oct 25 at 10:57 am
купить диплом в смоленске [url=https://www.rudik-diplom10.ru]https://www.rudik-diplom10.ru[/url] .

Diplomi_ztSa

19 Oct 25 at 10:57 am
1win kazino o‘yinlari bepul [url=www.1win5509.ru]1win kazino o‘yinlari bepul[/url]

1win_uz_ipKt

19 Oct 25 at 11:00 am
melbet russia [url=https://melbetbonusy.ru/]https://melbetbonusy.ru/[/url] .

melbet_unOi

19 Oct 25 at 11:03 am
купить диплом в якутске [url=https://www.rudik-diplom9.ru]купить диплом в якутске[/url] .

Diplomi_qzei

19 Oct 25 at 11:05 am
Новини Одеси https://faine-misto.od.ua огляди, події та цікаве в Одесі та області.

Gustavocer

19 Oct 25 at 11:05 am
You’ve made some really good points there. I checked on the internet to learn more about the issue and found most people will go along with your
views on this web site.

Roof replacement company near me

19 Oct 25 at 11:07 am
Refresh Renovation Southwest Charlotte
1251 Arrow Pine Ɗr c121,
Charlotte, NC 28273, United Ѕtates
+19803517882
Experts renovation outdoor

Experts renovation outdoor

19 Oct 25 at 11:07 am
Врачи «Частного Медика?24» контролируют состояние организма и предотвращают осложнения при выводе из запоя.
Подробнее можно узнать тут – [url=https://vyvod-iz-zapoya-v-stacionare-voronezh23.ru/]нарколог вывод из запоя в стационаре воронеж[/url]

Anthonyvom

19 Oct 25 at 11:08 am
В Краснодаре нарколог из клиники «Детокс» приедет на дом, чтобы вывести из запоя и оказать необходимую помощь.
Подробнее – [url=https://narkolog-na-dom-krasnodar25.ru/]вызвать нарколога на дом[/url]

JamieOvedy

19 Oct 25 at 11:10 am
TG @вЂЊLINKS_DEALER | EFFECTIVE SEO LINKS FOR spinbetter.bet

CharlesTHOTH

19 Oct 25 at 11:10 am
I truly love your website.. Very nice colors & theme.
Did you make this web site yourself? Please reply back
as I’m attempting to create my own personal blog and would like to learn where you got this from or
just what the theme is named. Cheers!

kill

19 Oct 25 at 11:12 am
купить свидетельство о браке [url=https://rudik-diplom13.ru]купить свидетельство о браке[/url] .

Diplomi_kjon

19 Oct 25 at 11:15 am
kraken darknet market
кракен зеркало

JamesDaync

19 Oct 25 at 11:15 am
мелбет бонус на депозит [url=www.melbetbonusy.ru/]мелбет бонус на депозит[/url] .

melbet_czOi

19 Oct 25 at 11:16 am
Вызов нарколога на дом в Краснодаре — услуга клиники «Детокс». Специалисты оказывают квалифицированную помощь прямо у вас дома.
Получить дополнительные сведения – [url=https://narkolog-na-dom-krasnodar25.ru/]врач нарколог выезд на дом в краснодаре[/url]

JamieOvedy

19 Oct 25 at 11:18 am
nathanjones.shop – On mobile it’s seamless and responsive; no weird layout issues.

Latia Lorona

19 Oct 25 at 11:20 am

Wanneer casino weer open South Holland

Winkans bij loterijen

Pokersites voor Enschedeers

Sjoerd Maessen blog

PHP hook, building hooks in your application

97,245 Responses to 'PHP hook, building hooks in your application'

Leave a Reply

Archive

Recent Comments

Tags

Meta