Web uygulamalarında URL yönetimi, SEO ve güvenlik açısından kritik bir rol oynar. Front controller deseni, tek bir giriş noktası (genellikle index.php) üzerinden tüm istekleri işleyerek kod tekrarını azaltır, merkezi bir hata yönetimi sağlar ve URL'leri temiz tutar. Bu ders, Apache sunucusunda .htaccess dosyasıyla nasıl yönlendirme yapılacağını, temel kuralları ve gerçek bir proje içinde nasıl uygulanacağını ayrıntılı olarak anlatır.
Temeller
Front controller, MVC (Model‑View‑Controller) gibi mimarilerin kalbinde yer alır. Gelen HTTP isteği doğrudan bir dosyaya (ör. about.html) yönlendirilmez; bunun yerine .htaccess içinde tanımlı RewriteRule sayesinde index.php dosyasına yönlendirilir. index.php dosyası, $_SERVER['REQUEST_URI'] değerini analiz eder, rotayı belirler ve ilgili kontrolcüye (controller) ya da görünüm dosyasına (view) yönlendirir.
Apache mod_rewrite modülü, URL yeniden yazma işlemlerinin motorudur. En yaygın kullanılan direktifler şunlardır:
RewriteEngine On– modülü etkinleştirir.RewriteCond %{REQUEST_FILENAME} !-f– istenen kaynak gerçek bir dosya değilse kuralı uygular.RewriteCond %{REQUEST_FILENAME} !-d– istenen kaynak gerçek bir klasör değilse kuralı uygular.RewriteRule ^ index.php [L]– tüm diğer istekleriindex.phpye yönlendirir,Lflag’i kural zincirinin sonlandırılmasını sağlar.
Adım adım kurulum
1. .htaccess dosyasını projenizin kök dizinine oluşturun. Dosyanın adı kesinlikle .htaccess olmalı ve sunucunun AllowOverride All ayarına sahip olması gerekir.
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^ index.php [L]
2. index.php dosyasını aynı dizine ekleyin. Bu dosya, gelen URI’yı ayrıştırıp uygun işlem bloğuna yönlendirecek.
3. Tarayıcınızda http://localhost/ adresini açın. .htaccess kuralları sayesinde index.php çalışacak ve REQUEST_URI değeri / olarak algılanacaktır.
4. Yeni bir rota eklemek istediğinizde, index.php içinde switch ya da bir router sınıfı kullanarak mantığı genişletebilirsiniz. Aşağıdaki örnek, basit bir router’ın temelini gösterir.
Örnek kod
Aşağıdaki iki kod bloğu, gerçek bir projede front controller ve .htaccess kullanımını gösterir. İlk blok .htaccess kurallarını, ikinci blok ise index.php içinde URI işleme mantığını içerir.
# .htaccess (proje kökü)
RewriteEngine On
# Gerçek dosya ya da klasör varsa yönlendirme yapma
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# Tüm diğer istekleri index.php'ye gönder
RewriteRule ^ index.php [L]
AnasayfaHoş geldiniz!
";
break;
case '/about':
echo "Hakkımızda
Şirketimiz 2010 yılında kurulmuştur.
";
break;
case '/contact':
echo "İletişim
E‑posta: info@example.com
";
break;
default:
// 404 – Sayfa bulunamadı
header($_SERVER["SERVER_PROTOCOL"] . " 404 Not Found");
echo "404 - Sayfa Bulunamadı
";
break;
}
?>
Yukarıdaki kod, /about ve /contact gibi temiz URL’leri doğrudan index.php üzerinden işleyerek, ayrı ayrı HTML dosyaları tutma ihtiyacını ortadan kaldırır.
Sık yapılan hatalar
- .htaccess dosyasının konumu: Dosya kök dizinde değilse yönlendirme çalışmaz. Sunucu yapılandırması
AllowOverride Allolmalıdır. - RewriteBase eksikliği: Alt klasörlerde çalışıyorsanız
RewriteBase /altklasor/eklemek gerekir. - Döngüsel yönlendirme:
RewriteRule ^ index.php [L]kuralı,index.phpiçinde başka bir rewrite tetiklenirse sonsuz döngü oluşabilir.Lflag’i bu riski azaltır, ancak kod içinde ek kontroller yapılmalıdır. - Gerçek dosya ve klasör kontrolü:
-fve-dkoşulları unutulursa statik dosyalar (CSS, JS, resimler) daindex.phpye yönlendirilir ve 404 hataları alınır. - Güvenlik açıkları: Kullanıcı girdisi doğrudan
echoedilirse XSS riski vardır. Çıktılarınhtmlspecialchars()ile kaçış yapılması gerekir.
Kontrol listesi
- .htaccess dosyası kök dizinde mi?
- Apache
mod_rewriteaktif mi? - Gerçek dosya ve klasörler
-f/-dkoşullarıyla muaf tutulmuş mu? - Router içinde tanımlı rotalar doğru mu?
- 404 ve 500 gibi hata sayfaları kullanıcı dostu mu?
- Üretim ortamında hata mesajları gizlenmiş mi?
SSS
1. .htaccess dosyasını nerede tutmalıyım?
Dosya, web uygulamanızın belge kökü (document root) içinde olmalıdır. Alt klasörlerde ayrı .htaccess dosyaları kullanılabilir, ancak her birinde RewriteBase ayarı yapılmalıdır.
2. Apache mod_rewrite yüklü değilse ne yapmalıyım?
Sunucu yöneticinizle iletişime geçerek mod_rewrite modülünün LoadModule rewrite_module modules/mod_rewrite.so satırıyla etkinleştirilmesini isteyin. Çoğu modern LAMP paketinde bu modül varsayılan olarak bulunur.
3. Front controller nasıl test edilir?
Tarayıcıda farklı URL’ler (ör. /about, /nonexistent) açın. 404 sayfası geldiğinde router’ın default bloğu çalışıyor demektir. Ayrıca curl -I http://localhost/about komutuyla HTTP başlıklarını inceleyebilirsiniz.
Özet
Bu derste, front controller deseninin temel mantığını, Apache .htaccess dosyasıyla tüm istekleri index.phpye yönlendirme adımlarını ve yaygın hataları ele aldık. Doğru RewriteCond ve RewriteRule kombinasyonu sayesinde statik varlıklar (CSS, JS, resimler) sorunsuz çalışır, dinamik sayfalar ise tek bir noktadan yönetilir. Uygulamanızın güvenliğini artırmak için kullanıcı girdilerini daima kaçışlayın, üretim ortamında hata mesajlarını gizleyin ve bir kontrol listesi ile dağıtım öncesi testleri tekrarlayın. Bu yaklaşımla, ölçeklenebilir ve bakım dostu PHP projeleri geliştirmek artık çok daha ulaşılabilir.
Yorumlar
Henüz onaylanmış yorum yok. İlk yorumu siz yazın.
Yorum yaz
Yorumunuz yönetici onayından sonra yayınlanır.