Sayfa yükleniyor

Destek Müşteri Girişi Sepet (0)

Ders 86 – Front controller ve .htaccess

Apache Rewrite ile tüm istekleri index.php'ye yönlendiren front controller yapısını, .htaccess kurallarını ve yaygın hataları adım adım öğrenin.

Ders 86 – Front controller ve .htaccess

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 istekleri index.phpye yönlendirir, L flag’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]
Anasayfa

Hoş 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 All olmalı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.php içinde başka bir rewrite tetiklenirse sonsuz döngü oluşabilir. L flag’i bu riski azaltır, ancak kod içinde ek kontroller yapılmalıdır.
  • Gerçek dosya ve klasör kontrolü: -f ve -d koşulları unutulursa statik dosyalar (CSS, JS, resimler) da index.phpye yönlendirilir ve 404 hataları alınır.
  • Güvenlik açıkları: Kullanıcı girdisi doğrudan echo edilirse XSS riski vardır. Çıktıların htmlspecialchars() ile kaçış yapılması gerekir.

Kontrol listesi

  • .htaccess dosyası kök dizinde mi?
  • Apache mod_rewrite aktif mi?
  • Gerçek dosya ve klasörler -f / -d koş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.

Paylaş

Yorumlar

Henüz onaylanmış yorum yok. İlk yorumu siz yazın.

Yorum yaz

Yorumunuz yönetici onayından sonra yayınlanır.

İlgili yazılar

Ders 100 – İleri yol haritası

PHP serisinin son dersinde ileri seviye konular, framework seçimi, Composer ekosistemi, mikro pro…

Ders 99 – Güvenli yapılandırma kontrol listesi

Üretim ortamı için PHP yapılandırma ayarlarını adım adım kontrol eden, hatasız ve güvenli bir yap…

Ders 98 – OpCache ve performans ipuçları

OpCache'ın çalışma prensibi, yapılandırma adımları ve gerçek dünyada performans artırmak için pra…

Ders 97 – Fibers’a kısa bakış (PHP 8.1)

PHP 8.1 ile gelen Fibers özelliğini adım adım öğrenin, kooperatif concurrency kavramını kavrayın …

Demo
Büyütülmüş Görsel