Özgür Adem Işıklı Özgür Adem Işıklı Software Developer Resume Contact

Software Developer

Symfony/Routing İle Rotalarınızı Yönetin

Genellikle birçok projemizde bir yönlendirme (link) yapısına ihtiyacımız olur. Bunu kimi zaman .htaccess dosyalarıyla çözeriz, kimi zaman da doğrudan PHP dosyalarının adını linkmiş gibi veririz. Fakat tüm bunlar amatör işi çözümlerdir.

Yeni bir projeye başlayacaksanız mutlaka framework kullanın. Eğer illa kendinize bir framework yazmak istiyorsanız, olabildiğince hazır çözümlerden yararlanın. Bu yazımızda projelerinizde ya da eğer yazacak kadar deliyseniz kendi frameworkünüzde kullanabileceğiniz bir paketi tanıtacağım; Symfony/Routing.

Kimler Kullanıyor?

Bu paket Symfony Framework‘ü için geliştirilmiştir. Ancak o kadar güçlü bir tasarıma sahiptir ki; başka frameworkler de bu paketi yönlendirme işlemleri için kullanmaktadır. Bu frameworkler arasında oldukça tanıdık bir isim daha var; Laravel.

Nasıl Kullanacağım?

Paketi kullanmanın en iyi yolu, paketi Composer ile birlikte projenize dahil etmektir;


{
    "require": {
        "symfony/routing": "3.0.*@dev",
        "symfony/http-foundation": "3.0.*@dev"
    }
}

Bu işlemden sonra composer update komutunu kullanarak bağımlılıkların projenize dahil olmasını sağlayabilirsiniz.

http-foundation benim vereceğim örnekte kullanılacağı için ben dahil ettim. Bu paket yalnızca benim işlerimi biraz daha kolaylaştırmaktır.

Örnek Kullanım

Symfony/Routing paketi temel olarak aşağıdaki 3 adımda çalışmaktadır;

  • Rota koleksiyonu (RouteCollection) oluşturulur.
  • Rotalar uygulama içerisinden koleksiyona aktarılır.
  • Mevcut kullanıcı isteği rota koleksiyonunda var mı kontrol edilir, yoksa exception fırlatılır.

Koleksiyon Oluşturma

Aşağıda koleksiyon oluşturma işlemini görebilirsiniz;


// Sınıflar çağırılır
use Symfony\Component\Routing\RouteCollection;

// Koleksiyon oluşturma işlemi
$routes = new RouteCollection();

Rota Tanımlama

Bu adımdan sonra rotalarımızı tutacağımız koleksiyonumuz artık hazırdır. Bundan sonra rotaları aşağıdaki gibi ekleyebiliriz;


// Sınıflar çağırılır
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;

// Koleksiyon oluşturma işlemi
$routes = new RouteCollection();

// Yeni bir rota oluşturulur
$route = new Route('/welcome', ['controller' => 'WelcomeController']);
// Rota koleksiyona dahil edilir.
$routes->add('welcome', $route);

Rota oluşturmak işlemini kısaltmak için aşağıdaki gibi kullanmanız da mümkündür;


// Rota oluşturulur ve koleksiyona dahil edilir.
$routes->add('welcome', new Route('/welcome', ['controller' => 'WelcomeController']));

Rota Kontrolü

Rota kontrolü için kullanıcı hangi url’yi çağırıyor kontrol ettirmemiz gerekmektedir. Bunu birçok farklı yol izleyerek yapabilirsiniz. Ancak amacımız az kodla çok iş yapmak olduğundan, Symfony tarafından hazırlanan HttpFoundation paketindeki Request sınıfını kullanmamız yerinde bir tercih olacaktır.


// Sınıflar çağırılır
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
use Symfony\Component\Routing\RequestContext;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\Routing\Matcher\UrlMatcher;

// Koleksiyon oluşturma işlemi
$routes = new RouteCollection();

// Yeni bir rota oluşturulur
$route = new Route('/welcome', ['controller' => 'WelcomeController']);
// Rota koleksiyona dahil edilir.
$routes->add('welcome', $route);

// Yeni bir istek nesnesi oluşturulur
$context = new RequestContext();
// Bu nesnenin içeriği Request sınıfı ile doldurulur
$context = $context->fromRequest(Request::createFromGlobals());		
// Url Karşılaştırma sınıfı oluşturulur
$matcher = new UrlMatcher($routes, $context);
// Mevcut url karşılaştırılır
try {
	$parameters = $matcher->match($context->getPathInfo());
} catch (ResourceNotFoundException $e) {
	echo '404!';
}

Bu işlem rota karşılaştırma işlemidir. Son satırda eğer rota varsa rota tanımlama aşamasında kaydedilen parametreler bize geri döner. Eğer yoksa bir Exception fırlatılır; ResourceNotFoundException. Biz de try-catch blogu ile bu hatayı yaklayamaya çalışıyoruz.

Hepsi bu kadar. Yalnızca dakikalar içerisinde oldukça kullanışlı bir yönlendirme işlemimiz oldu. Ancak bu makalede anlatılanlar Routing paketinin son derece yalın bir kullanımıdır. Aşağıdaki kaynaklardan daha detaylı bilgiler edinebilirsiniz;

What About Comments?

I do not use any comment system such as Disqus because of user's privacy. If you want to discuss something about this post, you may open an issue on the repo.

You may check what is the problem with Disqus;