URL ayrıştırıcı

URL ayrıştırıcı, bir web adresini şema, yol ve sorgu dizesi bileşenlerine ayıran ücretsiz bir araçtır.

URL ayrıştırıcı hangi bilgileri çıkarır?

URL ayrıştırıcı, metni elle bölmene gerek kalmadan bir web adresinin yapısal bileşenlerini belirler. Araç, PHP'nin parse_url işleviyle oluşturulan üç alan döndürür.

• Şema, https veya http gibi protokolü ya da adresleme şemasını belirtir.
• Yol, /account/orders/42 gibi yol bileşenini belirtir.
• Sorgu, sorgu bileşenini başlatan soru işaretinden sonra ve kodlanmamış bir diyez işaretinden önce bulunan metni içerir. Örneğin page=2&sort=date.

Ayrıştırma, API isteklerini, geri çağırma URL'lerini, uygulama günlüklerini veya üçüncü taraf verilerini incelerken kullanışlıdır. Adreste hata ayıklamadan, adresi günlüğe kaydetmeden veya dönüştürmeden önce yönlendirme bilgilerini sorgu parametrelerinden ayırmanı sağlar.

Döndürülen alanlarda ana makine adı, bağlantı noktası veya parça ayrı ayrı yer almaz. Bu bileşenlere ihtiyacın varsa uygulamanda daha kapsamlı bir URL ayrıştırma kitaplığı kullan.

URL ayrıştırıcı nasıl kullanılır?

Tam veya kısmi URL'yi gir, ardından aracın döndürdüğü şema, yol ve sorgu değerlerini incele. Eksiksiz bir mutlak URL, şemayı açıkça belirttiği için genellikle en anlaşılır sonucu verir.

1. URL'yi tarayıcıdan, API yanıtından, webhook kaydından veya sunucu günlüğünden kopyala.
2. Parametre adlarını ya da değerlerini incelemen gerekiyorsa sorgu dizesini ekle.
3. Döndürülen yolu uygulamanın beklediği rota ile karşılaştır.
4. Entegrasyonun gerektirdiği yerlerde şema ve sorgunun bulunup bulunmadığını kontrol et.

İşlem sunucuda gerçekleştirilir. Girdiğin veri HTTPS üzerinden sunucuya iletilir ve saklanmaz. Yine de aynı soruyu hassas bilgiler çıkarılmış bir örnekle yanıtlayabiliyorsan etkin erişim belirteçlerini, imzalı indirme bağlantılarını, oturum tanımlayıcılarını veya diğer kimlik bilgilerini gönderme.

Örnekler ve sonuçların yorumlanması

Ayrıştırıcı, mutlak bir API URL'sinde protokolü rota ve ham sorgu dizesinden ayırır.

Girdi https://api.example.co.uk/v1/orders/42?expand=items&currency=GBP

Şema https

Yol /v1/orders/42

Sorgu expand=items&currency=GBP

Sorgu tek bir bileşen olarak döndürülür. Yaygın form/sorgu dizesi kuralına göre ve işareti alanları ayırır. Her alandaki ilk eşittir işareti ise alan adını değerinden ayırır. URL'nin ayrıştırılması, expand veya currency öğelerinin API tarafından tanınan parametreler olduğunu tek başına doğrulamaz.

Göreli bir başvuru, şema belirtmeden de yol ve sorgu içerebilir.

Girdi /search?q=red%20shoes&page=2

Şema no scheme component

Yol /search

Sorgu q=red%20shoes&page=2

Aynı web sitesi içinde oluşturulan bağlantılarda şemanın bulunmaması çoğu zaman beklenen bir durumdur. Ancak mutlak geri çağırma URL'leri içermesi gereken verilerde aynı sonuç, eksik bir https:// önekini ortaya çıkarabilir.

Bu araç bir URL doğrulayıcı değildir. Eksik şema, beklenmeyen yol veya yanlış yerdeki sorgu metni gibi şüpheli yapıları ortaya çıkarmaya yardımcı olabilir. Ancak URL'nin ayrıştırılabilmesi, adresin var olduğunu, DNS üzerinden çözümlendiğini veya başarılı bir HTTP yanıtı döndürdüğünü kanıtlamaz.

Boşluklar, noktalama işaretleri ve sıra dışı girdiler nasıl işlenir?

Ayrılmış karakterler URL'nin nasıl bölündüğünü etkiler. Kodlanmış karakterler ise genellikle bulundukları bileşenin parçası olarak kalır. Ayrıştırıcı, bileşenlerin içeriğini çözmek veya normalleştirmek yerine onları birbirinden ayırır.

• Kodlanmamış bir soru işareti sorgu bileşenini başlatır. Mevcut bir sorgunun dışında veri olarak kullanılması amaçlanan gerçek bir soru işareti, aksi durumda sorgu ayırıcı görevi görecekse yüzde kodlamasıyla kodlanmalıdır.
• Ve işareti genellikle sorgu parametrelerini birbirinden ayırır. Ancak bu araç, parametreleri tek tek yorumlamak yerine sorgu dizesinin tamamını döndürür.
• Standart URL söz diziminde kodlanmamış diyez işareti (#), parça ayırıcısıdır. Parça verileri burada döndürülen alanlardan biri değildir.
• Boşluklar normalde kodlanmalıdır ve bunun için yaygın olarak %20 kullanılır. Artı işareti, form kodlamalı sorgu verilerinde boşluğu temsil edebilir. Ancak bu yorum URL ayrıştırma işlemine değil, sorgu çözümleme işlemine aittir.
• Aksanlı ve Latin alfabesi dışındaki yol veya sorgu metinleri, alıcı sistem gerektiriyorsa UTF-8 yüzde kodlaması kullanmalıdır. Uluslararasılaştırılmış alan adlarında, protokollerle geniş uyumluluk için ASCII uyumlu biçim kullanılır.
• Sayılar için özel bir ayrıştırma davranışı yoktur. Yol veya sorgu değeri içinde sıradan karakterler olarak kalırlar.

Boş bir girdide incelenebilecek kullanışlı bir URL yapısı yoktur. Çok uzun URL'ler ayrıca tarayıcılar, web sunucuları, proxy'ler ve uygulama çerçeveleri gibi başka yerlerdeki sınırlara takılabilir. Bu araç, belirli bir URL uzunluğunun başka bir sistem tarafından kabul edilip edilmeyeceğini belirlemez.

Bir URL'yi ne zaman ayrıştırmak gerekir?

Bir adres kod veya altyapı tarafından işlenmeden önce yapısını teşhis etmen gerekiyorsa URL'yi ayrıştırmak yararlıdır. Dağıtımdan önce webhook geri çağırma adreslerini kontrol etmek, yönlendirme hedeflerini incelemek, API rotalarını filtrelerden ayırmak ve ters proxy günlüklerinden kopyalanan URL'leri okumak yaygın kullanım örnekleridir.

Bilinen ve zaten yapılandırılmış bir URL'yi yalnızca bir makine kullanacaksa ve uygulamanda hâlihazırda bir URL kitaplığı varsa ayrıştırma çoğunlukla gereksizdir. Kullanılabilirliği test etmek, yönlendirmeleri takip etmek, her sorgu parametresini çözmek veya bir alan adının güvenilirliğini doğrulamak istiyorsan da bu işlem uygun değildir.

Tekrarlanan veya otomatikleştirilmiş işlemlerde kullandığın ortamın yerleşik URL araçlarından yararlan. PHP'de parse_url, tarayıcı JavaScript'inde URL arayüzü, Node.js'de URL sınıfı, Python'da ise urllib.parse bulunur. Binlerce adres içeren bir günlük dosyasını işlerken küçük bir komut satırı betiği, elle ayrıştırmadan daha uygundur.

Alıcı sistemin tam olarak istediği biçime zaten sahip olan bir URL'yi sırf yeniden biçimlendirmek için ayrıştırma. Açık bir gerekçe olmadan adresleri yeniden kodlamak veya oluşturmak sorgu imzalarını, yinelenen parametreleri ya da ayrılmış karakterleri değiştirebilir.

Sık sorulan sorular

http veya https olmadan URL ayrıştırabilir miyim?

Evet. PHP'nin parse_url işlevi göreli başvuruları ve kısmi URL'leri yorumlayabilir, ancak şema belirtilmemişse sonuçta şema bulunmaz. İki eğik çizgiyle başlayan şema göreli adresleri kullanırken dikkatli ol. Bu adreslerin anlamı, içinde bulundukları belgeye veya uygulamaya bağlıdır.

Tekrarlanan sorgu parametreleri korunur mu?

Sorgu ham bir bileşen olarak döndürüldüğünden, tekrarlanan adlar özgün sıralarıyla korunabilir. tag=red&tag=blue gibi değerlerin dizilere veya ayrı değerlere nasıl dönüştürüleceği, daha sonra kullanılan sorgu dizesi ayrıştırıcısına bağlıdır.

İmzalı bir URL'yi buraya yapıştırmak güvenli mi?

Girdi HTTPS üzerinden gönderilir ve saklanmaz. Ancak imzalı bir URL, imzası geçerli olduğu sürece özel içeriğe erişim sağlayabilir. Tam kimlik bilgileri gerekli değilse belirteci gizle veya ana makine adını ve değerleri temsili yer tutucularla değiştir.

Geçerli görünen bir URL uygulamamda neden farklı davranıyor?

Farklılıklar, uygulama çerçevesine özgü sorgu çözümleme ve Unicode normalleştirmesinden kaynaklanabilir. Uygulamalar ayrıştırma sonrasında ana makine adı izin listeleri ve yönlendirme kısıtlamaları gibi ek kurallar da uygulayabilir. Önce ham URL'yi bayt bayt karşılaştır, ardından isteği göndermeden önce uygulamanın hangi bölümleri çözdüğünü veya yeniden yazdığını kontrol et.