Yönlendirme Kuralı Oluşturucu

Yönlendirme Kuralı Oluşturucu Nedir?

Yönlendirme Kuralı Oluşturucu, web sitenizde yönlendirmek istediğiniz eski adreslerin listesini ve bunların gitmesini istediğiniz yeni adresleri alarak, web sunucunuzda veya barındırma platformunuzda bu yönlendirmelerin gerçekleşmesini sağlayacak özel kodları üreten bir araçtır.

Bu araç, özellikle şu durumlarda büyük kolaylık sağlar:

• Bir web sitesini başka bir adrese taşırken (web sitesi taşıma),
• Bir web sitesindeki URL yapılarını yeniden düzenlerken,
• Web sitesindeki eski ve artık kullanılmayan içerikleri temizlerken.

Web yöneticileri ve geliştiriciler, yönlendirmek istedikleri adres listesini bir CSV dosyası olarak araca yükler, yönlendirmenin kalıcı mı yoksa geçici mi olacağını seçer ve kullanacakları web ortamını belirler. Araç, bu girdilere göre uygun yönlendirme kurallarını oluşturur; kullanıcılar da bu kuralları doğrudan kopyalayabilir veya indirebilir.

Giriş Dosyası ve CSV Biçimlendirme Kuralları

Aracın düzgün çalışabilmesi için yükleyeceğiniz CSV dosyasının belirli kurallara ve biçimlendirme standartlarına uygun olması gerekir.

• Sütun Yapısı: CSV dosyasının başlık satırında mutlaka kaynak (source) ve hedef (target veya destination) sütunları yer almalıdır. Başlık satırından sonraki her bir satır, bir kaynak URL'si ve bir hedef URL'si içermelidir.
• Kaynak URL Biçimi: Kaynak URL'si, eksiksiz bir HTTP veya HTTPS URL'si olabileceği gibi, / karakteri ile başlayan bir yol (path) da olabilir.
• Hedef URL Biçimi: Hedef URL'si, eksiksiz bir HTTP veya HTTPS URL'si ya da köke göreli (root-relative) bir yol olabilir.
• Dosya Boyutu Sınırı: Yüklenecek CSV dosyasının boyutu 5 MB'ın altında olmalıdır.
• Eşleme Sınırı: Araç, tek seferde en fazla 2.000 adet yönlendirme eşlemesini kabul eder ve işler.

Desteklenen Durum Kodları ve Web Ortamları

Yönlendirme kurallarını oluştururken iki farklı durum kodundan birini seçebilir ve üç farklı web ortamı için çıktı alabilirsiniz.

Durum Kodları (Status Codes)

• 301 Kalıcı (Permanent): Arama motorlarına ve tarayıcılara kaynağın kalıcı olarak yeni bir adrese taşındığını bildirir.
• 302 Geçici (Temporary): Kaynağın geçici bir süre için farklı bir adrese yönlendirildiğini belirtir.

Desteklenen Ortamlar (Environments)

• Nginx: Nginx web sunucularında kullanılmak üzere optimize edilmiş yönlendirme blokları üretir.
• Apache: Apache sunucularında .htaccess dosyasına eklenebilecek yönlendirme kuralları oluşturur.
• Vercel: Vercel platformunun yapılandırma dosyasına uygun yönlendirme kuralları üretir.

Kurallar, Sınırlar ve Özel Durumlar

Yönlendirme kurallarının hatasız çalışması için araç belirli teknik kuralları ve kısıtlamaları uygular:

• Tam Eşleşme (Exact Match): Oluşturulan tüm yönlendirmeler tam eşleşme esasına dayanır. Nginx ve Apache çıktıları doğrudan tam kaynak yoluna göre sabitlenirken, Vercel de aynı tam ve değişmez yolu alır.
• Kaynak Ana Makine Adı: Giriş olarak verilen kaynak URL'lerindeki ana makine adları (hostnames) araç tarafından otomatik olarak kaldırılır.
• Sorgu Dizeleri ve Joker Karakterler: Kaynak URL'lerinde yer alan sorgu dizeleri (query strings), fragment'lar (örneğin # işaretinden sonraki kısımlar) ve joker karakter (wildcard) tarzı desenler kabul edilmez ve reddedilir.
• Vercel statusCode Yapılandırması: Vercel'in kendi varsayılan kalıcı anahtarı 308, geçici anahtarı ise 307 yönlendirmesi üretir. Seçtiğiniz 301 veya 302 durum kodunun tam olarak korunmasını sağlamak amacıyla, üretilen Vercel çıktısında statusCode parametresi kullanılır.
• Tekrarlanan Kaynaklar: Her bir kaynak yol yalnızca bir kez tanımlanabilir. Aynı kaynak yolunun birden fazla satırda tekrarlanması durumunda hata mesajı verilir.

Gizlilik ve Veri İşleme

Yönlendirme Kuralı Oluşturucu aracını kullanırken veri güvenliğiniz korunur. Yüklediğiniz CSV dosyası ve bu dosyadan üretilen yönlendirme kuralları tamamen tarayıcınızda kalır. Hiçbir veriniz BroBroGo sunucularına yüklenmez veya dışarıya aktarılmaz.

Sıkça Sorulan Sorular (SSS)

CSV dosyasını nasıl biçimlendirmeliyim?

Kaynak (source) ve hedef (target veya destination) sütunlarını içeren bir başlık satırı kullanın. Sonraki her satır, eksiksiz bir HTTP/HTTPS kaynak URL'si veya / ile başlayan bir yol ile birlikte eksiksiz veya köke göreli (root-relative) bir hedef içerebilir.

Oluşturulan yönlendirmeler tam eşleşme (exact match) mi sağlar?

Evet. Nginx ve Apache çıktıları tam kaynak yoluna göre sabitlenir ve Vercel de aynı tam yolu alır. Kaynak ana makine adı kaldırılır; kaynak sorgu dizeleri, fragment'lar ve joker karakter (wildcard) tarzı desenler, üç ortamın bunları farklı şekilde işlemesi nedeniyle reddedilir.

Vercel çıktısı neden statusCode kullanıyor?

Vercel'in kalıcı yönlendirmesi 308, geçici yönlendirmesi ise 307 üretir. Seçiminizin tam olarak 301 veya 302 kalması için statusCode kullanılır. Standart Vercel dağıtımları toplamda 2.048 rotaya izin verdiğinden, bu araç en fazla 2.000 eşlemeyi kabul eder.