events.md

Olaylar (Events)

• Basit Kullanım
• Joker Dinleyiciler
• Dinleyici Olarak Sınıfları Kullanmak
• Olayları Sıraya Sokma
• Olay Aboneleri

Basit Kullanım

Laravel'in Event sınıfı, uygulamanızdaki olaylara abone olmanıza ve dinlemenize imkan veren basit bir gözlemci aracıdır.

Bir Olaya Abone Olma

Event::listen('uye.login', function($uye)
{
	$uye->last_login = new DateTime;

	$uye->save();
});

Bir Olayı Ateşleme

$olay = Event::fire('uye.login', array($uye));

Olaylara abone olurken bir öncelik de belirtebilirsiniz. Daha yüksek önceliği olan dinleyiciler daha önce çalışacak, aynı önceliğe sahip dinleyiciler ise abonelik sırasına göre çalışacaklardır.

Bir Olaya Abone Olurken Öncelik Belirtme

Event::listen('uye.login', 'LoginHandler', 10);

Event::listen('uye.login', 'DigerHandler', 5);

Bazen bir olayın diğer dinleyicilere yayılmasını durdurmak isteyebilirsiniz. Dinleyicinizden false döndürerek bunu gerçekleştirebilirsiniz:

Bir Olayın Yayılımının Durdurulması

Event::listen('uye.login', function($event)
{
	// Olayı işle...

	return false;
});

Joker Dinleyiciler

Bir olay dinleyiciyi kayda geçirirken, joker dinleyicileri belirtmek üzere yıldız işareti kullanabilirsiniz:

Joker Olay Dinleyicilerin Kayda Geçirilmesi

Event::listen('falan.*', function($param, $event)
{
	// Olayı işle...
});

Bu dinleyici falan. ile başlayan tüm olayları işleyecektir. Tam olay adının işleyiciye son parametre olarak geçildiğine dikkat ediniz.

Dinleyici Olarak Sınıfları Kullanma

Bazı durumlarda, bir olayı işlemek için bir bitirme fonksiyonu yerine bir sınıf kullanmak isteyebilirsiniz. Sınıf olay dinleyileri Laravel'in IoC konteyneri ile çözümlenecek, böylece size dinleyicileriniz üzerinde tam bir koloni enjeksiyonu gücü verecektir.

Bir Sınıf Dinleyicinin Kayda Geçirilmesi

Event::listen('uye.login', 'LoginIsleyici');

Ön tanımlı olarak, LoginHandler sınıfındaki handle metodu çağrılacaktır:

Bir Olay Dinleyici Sınıfının Tanımlanması

class LoginIsleyici {

	public function handle($data)
	{
		//
	}

}

Eğer ön tanımlı handle metodunu kullanmak istemiyorsanız, abone olunacak metodu belirleyebilirsiniz:

Hangi Metoda Abone Olunduğunun Tanımlanması

Event::listen('uye.login', 'LoginIsleyici@onLogin');

Olayları Sıraya Sokma

queue ve flush metodlarını kullanarak, bir olayı hemen ateşlemeyip, ateşlenmek üzere "sıraya" sokabilirsiniz:

Sıralı Bir Olayın Kayda Geçirilmesi

Event::queue('falan', array($uye));

Bir Olay Flusher'ın Kayda Geçirilmesi

Event::flusher('falan', function($uye)
{
	//
});

Son olarak, ilgili "flusher"ı çalıştırabilir ve flush metodunu kullanarak sıradaki tüm olayları harekete geçirebilirsiniz:

Event::flush('falan');

Olay Aboneleri

Olay aboneleri, sınıfın kendi içinden birden çok olaya abone olabilen sınıflardır. Aboneler bir subscribe metodu ile tanımlanırlar ve bu metoda parametre olarak bir olay sevkiyatçısı olgusu geçilecektir:

Bir Olay Abonesi Tanımlanması

class UyeOlayIsleyici {

	/**
	 * Uye login olaylarını işle.
	 */
	public function onUyeLogin($event)
	{
		//
	}

	/**
	 * Uye logout olaylarını hallet.
	 */
	public function onUyeLogout($event)
	{
		//
	}

	/**
	 * Abone dinleyicilerini kayda geçir.
	 *
	 * @param  Illuminate\Events\Dispatcher  $events
	 * @return array
	 */
	public function subscribe($events)
	{
		$events->listen('uye.login', 'UyeOlayIsleyici@onUyeLogin');

		$events->listen('uye.logout', 'UyeOlayIsleyici@onUyeLogout');
	}

}

Abone tanımlandıktan sonra, Event sınıfı kullanılarak kayda geçirilebilir.

Bir Olay Abonesinin Kayda Geçirilmesi

$abone = new UyeOlayIsleyici;

Event::subscribe($abone);