Nginx, bir vekil sunucu olarak işlev gördüğünde, istemcilerden gelen HTTP isteklerini arka uç sunucularına (örneğin, uygulama sunucuları veya başka web sunucuları) ileterek yanıtları alır ve bu yanıtları istemcilere iletir. Bu süreçte, arka uç sunucularından gelen durum kodları, istemcinin alacağı sonucu etkileyen önemli unsurlardır. Nginx, bu durum kodlarını yönetmek için birkaç önemli direktif sunmaktadır. Bu direktifler arasında `proxy_intercept_errors` ve `error_page` direktifleri öne çıkar.
`proxy_intercept_errors` Direktifi
`proxy_intercept_errors`, Nginx’in arka uç sunuculardan aldığı yanıtların durum kodlarını kontrol etmesini sağlayan bir direktiftir. Bu direktif, belirli HTTP durum kodları (örneğin 4xx veya 5xx) alındığında Nginx’in bu yanıtları istemcilere iletip iletmeyeceğini belirler. Eğer bu direktif `on` olarak ayarlandığında, Nginx belirli bir durum kodu aldığında, bu kodu kontrol ederek özel hata sayfaları veya alternatif işlemler düzenleyebilir.
Örneğin, `proxy_intercept_errors` direktifi `on` olarak ayarlandığında, arka uç sunuculardan dönülen 404 veya 500 gibi hata kodları için hata sayfaları tanımlamak mümkündür. Bu durumda Nginx, istemciye arka uç sunucusunun gönderdiği hata yanıtını değil, Nginx’in yapılandırmasında belirtilen `error_page` direktiflerinde tanımlı olan sayfaları gönderir.
Aşağıdaki örnekte, `proxy_intercept_errors` direktifinin kullanımı gösterilmektedir:
“`nginx
location / {
proxy_pass http://backend-server;
proxy_intercept_errors on;
error_page 404 /custom_404.html;
error_page 500 /custom_500.html;
}
“`
Bu yapılandırmada, bir 404 veya 500 hata kodu alındığında; Nginx, arka uç sunucusundan gelen yanıtı istemciye iletmek yerine, belirtilen özel hata sayfalarını döndürür.
`error_page` Direktifi
`error_page`, Nginx üzerinden işlenen HTTP yanıtları için özel hata sayfaları tanımlamak amacıyla kullanılan bir direktiftir. Bu direktifle, belirli bir durum kodu alındığında hangi sayfanın gösterileceği belirlenir. `error_page` direktifi genellikle `location` blokları içinde kullanılır.
Bu direktif ile, kullanıcı deneyimi artırılabilir ve sistem hataları veya başka problemlerle ilgili daha dostane hata mesajları sağlanabilir. Örneğin, bir 404 hatası alındığında, kullanıcılara özel bir tasarıma sahip bir hata sayfası gösterilebilir. `error_page` direktifi, sadece belirli durum kodları için değil; aynı zamanda kullanıcıya özel bir yönlendirme de sağlayabilir.
Bir örnek göstermek gerekirse:
“`nginx
error_page 404 /404.html;
error_page 500 502 503 504 /50x.html;
“`
Bu yapılandırmada, 404, 500, 502, 503 veya 504 durum kodları alındığında Nginx’in kullanılacak sayfalar tanımlıdır.
Birlikte Kullanım
`proxy_intercept_errors` ve `error_page` direktifleri birlikte kullanıldığında, Nginx’in hata yönetimi açısından sağladığı esneklik artar. `proxy_intercept_errors` direktifi aktifleştirildiğinde, belirli hatalar için tanımlanan sayfaların kullanılması sağlanabilir. Böylece, kullanıcılar arka uç sunucusundan gelen hatalardan etkilenmeden daha iyi bir deneyim yaşayabilir.
Örneğin, aşağıdaki yapılandırmada, hem `proxy_intercept_errors` hem de `error_page` birlikte kullanılarak hata yönetimi gerçekleştirilmiştir:
“`nginx
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend-server;
proxy_intercept_errors on;
error_page 404 /404.html;
error_page 500 /500.html;
}
location = /404.html {
internal;
}
location = /500.html {
internal;
}
}
“`
Bu yapılandırmada, `proxy_intercept_errors` olayı aktif hale getirildiği için, yalnızca `backend-server` tarafından üretilen 404 ve 500 hataları için özel sayfalar sunmaktadır. Ayrıca, özel hata sayfalarının erişiminin sadece sunucu içinde yapılabilmesi için `internal` direktifi de kullanılmıştır.
Sonuç
Nginx, bir vekil sunucu olarak durum kodlarını etkili bir şekilde yönetmeye olanak tanır. `proxy_intercept_errors` ve `error_page` direktifleri, Nginx’in hata yanıtlama ve özel hata sayfası gösterme süreçlerini geliştirmek amacıyla etkin şekilde kullanılabilir. Bu direktiflerin kombinasyonu, arka uç sunuculardan gelen hataların kontrolünü ve yönetimini kolay hale getirirken, kullanıcı deneyimini de iyileştirmeye yardımcı olur.
