Yönlendirmeleri ve Yeniden Yazmaları Yapılandırma

Orbit, yeniden yönlendirme ve yeniden yazma işlemini gerçekleştiren yerleşik bir motora sahiptir ve bu işlem, KPanel'de veya depo dosyasında yapılandırılan şekilde yapılır. Bu kılavuz her iki yöntemi, örüntü söz dizimini ve yakalamalarını, kuralların sıralanmasını, sınırları ve insanları yakalayan davranışı kapsar.

Kuralları Nereye Yapılandıracağınız

İki yer vardır ve bunlar sabit bir sırada değerlendirilir.

1. KPanel'de. Projenizi Orbit'te açın, Ayarlar'a gidin ve ortam için yeniden yönlendirmeler ve yeniden yazma bölümüne gidin. Her ortamın kendi bağımsız kural kümesi vardır, bu nedenle üretim ve hazırlama ayrı ayrı yapılandırılır.
2. Deponuzda, bir kaps.json dosyası olarak. Bu, aşağıda ele alınmıştır.

Panel kuralları önce değerlendirilir. Hiçbiri eşleşmezse, kaps.json kuralları denenir.

KPanel'de Kural Ekleme

1. Kural ekle'ye tıklayın.
2. Kaynağı doldurun, gelen istekleri eşleştirmek için yol örüntüsü. Yer tutucu beklediği iki şekli gösterir: /old-path or /blog/:slug.
3. Hedefi doldurun. Yer tutucu /new-path or https://...'yi gösterir, bu nedenle hem yerel bir yol hem de tam bir harici URL geçerlidir.
4. Kural türünü seçin:
   • 301 Kalıcı: URL kalıcı olarak taşındı. Tarayıcılar ve arama motorları bunu önbelleğe alır.
   • 302 Geçici: şimdilik taşındı, önbelleğe alınmaz. Kampanyalar ve deneyler için kullanın.
   • Yeniden yazma: tarayıcının adres çubuğundaki URL'yi değiştirmeden hedef yolunu sunun.
5. Kuralları kaydet'e tıklayın.

Kaynak Yolu Örüntüleri

:id ve :rest* arasındaki fark önemli olandır. Adlandırılmış bir parametre tek bir segmenti eşleştirir ve sonraki eğik çizgide durur. Bir joker kalan her şeyi, eğik çizgiler dahil eşleştirir.

Yakalamalarını Hedefte Kullanma

Adlandırılmış bir parametreyi ada göre ve basit bir joker karakterini * olarak başvurun:

Kural Sırası

Kurallar listenin en üstünden aşağıya doğru test edilir ve ilk eşleşme kazanır. Bir kural eşleştiğinde, sonraki hiçbir kural dikkate alınmaz. Panel, liste altında söyler: "Kurallar sırasında test edilir. İlk eşleşme kazanır."

Hiçbir kural eşleşmezse, istek normal olarak sunulur.

Yaygın Kullanım Durumları

Sayfayı Yeniden Adlandırma

/about-us'yi /about'ye yeniden adlandırdınız ve eski bağlantıların çalışmaya devam etmesini istiyorsunuz.

• Kaynak: /about-us
• Hedef: /about
• Tür: 301 Kalıcı

Bütün Bir Bölümü Taşıma

Blogunuz /news/:slug'dan /blog/:slug'ye taşındı.

• Kaynak: /news/:slug
• Hedef: /blog/:slug
• Tür: 301 Kalıcı

API Yolunu Sessizce Proxy Etme

/api/v1/*'nin, değişikliği ortaya çıkarmadan farklı bir iç yoldan sunulmasını istiyorsunuz.

• Kaynak: /api/v1/:path*
• Hedef: /api/internal/:path*
• Tür: Yeniden yazma

Geçici Bir Tutucu Sayfası

• Kaynak: /checkout
• Hedef: /maintenance
• Tür: 302 Geçici

Trafiği Başka Bir Alan Adına Göndermek

Hedef, mutlak bir URL olabilir, bu nedenle bir kural tamamen farklı bir siteye işaret edebilir.

• Kaynak: /shop/:rest*
• Hedef: https://shop.example.com/:rest*
• Tür: 301 Kalıcı

kaps.json ile Kod Olarak Yapılandırma

Kurallar, panel yerine deponuzda bulunabilir. Bir kaps.json dosyası ekleyin ve derlemenizin bunu çıktı dizinine kopyaladığından emin olun, çünkü Orbit bunu depo kökünden değil, oluşturulan yapının kökünden okur.

{
  "redirects": [
    { "source": "/about-us", "destination": "/about", "permanent": true },
    { "source": "/news/:slug", "destination": "/blog/:slug", "permanent": true },
    { "source": "/promo", "destination": "/spring-sale", "permanent": false }
  ],
  "rewrites": [
    { "source": "/api/v1/:path*", "destination": "/api/internal/:path*" }
  ],
  "headers": [
    {
      "source": "/*",
      "headers": [
        { "key": "X-Frame-Options", "value": "DENY" },
        { "key": "X-Content-Type-Options", "value": "nosniff" }
      ]
    }
  ]
}

permanent: true 301 üretir ve permanent: false 302 üretir. Atlama 301 verir.

Sınırlar

• Ortam başına 100 yeniden yönlendirme ve yeniden yazma kuralları ve bir kaps.json'de 100.
• Ortam başına 200 özel başlık kuralları.

Sınırın ötesindeki kurallar sessizce düşürülür, bir hata oluşturmaz, bu nedenle bunun çok altında kalın.

Özel Yanıt Başlıkları

Yeniden yönlendirmelerin yanında, her ortamın Ayarlar'da eşleşen yollar üzerinde HTTP başlıkları enjekte etmek için bir yanıt başlıkları bölümü vardır. Aynı yol örüntüsü söz dizimini kullanır ve HSTS, CSP, no-embed, no-sniff, referrer politikası ve CORS için hızlı ekleme ön ayarları vardır.

Yeniden yönlendirmelerin aksine, tüm eşleşen başlık kuralları uygulanır, yalnızca ilki değil ve sonraki bir kural aynı başlığı ayarladığında önceki birinin üzerine yazar. Content-Length, Transfer-Encoding ve Connection engellenmiştir, çünkü bunları ayarlamak yanıtı bozacaktır.

Buna Güvenmeden Önce Bilmek Değer Davranış

• Kurallar yalnızca yolla eşleşir. Parçalar (#section) hiçbir zaman sunucuya ulaşmaz; tarayıcı yeniden yönlendirmeden sonra bunları yeniden iliştirir.
• Var olmayan bir yola yeniden yazma, 404 üretir, orijinal yola sessizce geri düşmek yerine. Yeniden yazma hedefleri, derleme çıktısında bulunmalıdır.
• Kurallar projenizin bir şey istenmeden önce çalışır, bu nedenle statik dosyalar ve sunucu modu istekleri için geçerli olur.
• Her ortam bağımsızdır. Üretim kuralları hazırlamaya veya önizlemelere uygulanmaz. Bunları kasıtlı olarak kopyalayın.

Bir Kuralı Silme

Kural satırında çöp simgesine tıklayın, ardından değişikliği uygulamak için Kuralları kaydet'e tıklayın. Bir kural eklemenin aksine, değişiklik sonraki dağıtımdan itibaren yürürlüğe girer.

Bunun Yerine Bir Edge İşlevini Ne Zaman Kullanacağınız

Yeniden yönlendirme motoru yol-yol kurallarını işler. Kural motorunun ifade edemediği mantık gerektiğinde bir edge işlevini kullanın: başlık veya tanımlama bilgisinde dallanma, sorgu parametrelerini koruma veya yeniden yazma, ağırlıklı A/B yönlendirmesi veya herhangi bir koşullu.

İlgili Okuma

• Edge İşlevleri
• Projenize Özel Alan Adı Ekleme
• Projenizi Dağıtma