Pengurai URL

Pengurai URL adalah alat gratis yang memisahkan alamat web menjadi skema, path, dan string kueri.

Apa saja yang diambil oleh pengurai URL?

Pengurai URL mengenali komponen struktural alamat web tanpa mengharuskan kamu memisahkan teksnya secara manual. Alat ini menampilkan tiga bidang yang dihasilkan melalui fungsi parse_url milik PHP.

• Skema menunjukkan protokol atau skema pengalamatan, seperti https atau http.
• Jalur menunjukkan komponen path, seperti /account/orders/42.
• Kueri berisi teks setelah tanda tanya yang mengawali komponen kueri dan sebelum tanda pagar yang tidak dikodekan, seperti page=2&sort=date.

Penguraian berguna saat memeriksa permintaan API, URL callback, log aplikasi, atau data dari pihak ketiga. Kamu dapat membedakan informasi perutean dari parameter kueri sebelum men-debug, mencatat, atau mengubah alamat tersebut.

Hasilnya tidak menyediakan nama host, port, atau fragmen sebagai bidang terpisah. Jika memerlukan komponen tersebut, gunakan pustaka penguraian URL yang lebih lengkap dalam aplikasimu.

Bagaimana cara menggunakan Pengurai URL?

Masukkan URL lengkap atau sebagian, lalu periksa nilai skema, path, dan kueri yang ditampilkan alat ini. URL absolut yang lengkap biasanya memberikan hasil paling jelas karena menyebutkan skemanya secara eksplisit.

1. Salin URL dari browser, respons API, catatan webhook, atau log server.
2. Sertakan string kueri jika kamu perlu memeriksa nama atau nilai parameter.
3. Bandingkan path yang ditampilkan dengan rute yang seharusnya digunakan oleh aplikasimu.
4. Pastikan skema dan kueri tersedia jika integrasimu memerlukannya.

Proses penguraian berlangsung di server. Input dikirim ke server melalui HTTPS dan tidak disimpan. Meski demikian, hindari memasukkan token akses yang masih aktif, tautan unduhan bertanda tangan, pengenal sesi, atau kredensial lain jika contoh yang sudah disamarkan cukup untuk menjawab pertanyaan yang sama.

Contoh penggunaan dan cara membaca hasil

Untuk URL API absolut, pengurai memisahkan protokol dari rute dan string kueri mentah.

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

Skema https

Path /v1/orders/42

Kueri expand=items&currency=GBP

Kueri ditampilkan sebagai satu komponen. Dalam konvensi umum formulir atau string kueri, tanda ampersan memisahkan bidang, sedangkan tanda sama dengan pertama di setiap bidang memisahkan nama dari nilainya. Mengurai URL saja tidak memastikan bahwa expand atau currency merupakan parameter yang dikenali oleh API.

Referensi relatif juga dapat memuat path dan kueri tanpa mencantumkan skema.

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

Skema no scheme component

Path /search

Kueri q=red%20shoes&page=2

Tidak adanya skema sering kali memang wajar untuk tautan yang dibuat di dalam satu situs web. Namun, pada data yang seharusnya berisi URL callback absolut, hasil yang sama dapat menunjukkan bahwa awalan https:// hilang.

Pengurai ini bukan validator URL. Alat ini dapat membantu menemukan struktur yang mencurigakan, seperti skema yang hilang, path yang tidak semestinya, atau teks kueri yang berada di tempat yang salah. Namun, hasil penguraian tidak membuktikan bahwa alamat tersebut ada, dapat di-resolve melalui DNS, atau menghasilkan respons HTTP yang berhasil.

Apa yang terjadi pada spasi, tanda baca, dan input yang tidak biasa?

Karakter khusus memengaruhi cara URL dipisahkan, sedangkan karakter yang dikodekan umumnya tetap menjadi bagian dari komponen tempatnya berada. Pengurai memisahkan komponen, bukan mendekode atau menormalkan isinya.

• Tanda tanya yang tidak dikodekan mengawali komponen kueri. Tanda tanya literal yang dimaksudkan sebagai data di luar kueri yang sudah ada harus dikodekan dengan persen jika tanpa pengodean tanda tersebut akan berfungsi sebagai pemisah kueri.
• Tanda ampersan biasanya memisahkan parameter kueri, tetapi alat ini menampilkan string kueri lengkap, bukan menafsirkannya satu per satu berdasarkan parameter.
• Tanda pagar (#) yang tidak dikodekan merupakan pemisah fragmen dalam sintaks URL standar. Data fragmen bukan salah satu bidang yang ditampilkan di sini.
• Spasi biasanya harus dikodekan, umumnya sebagai %20. Tanda plus dapat mewakili spasi dalam data kueri berkode formulir, tetapi penafsiran tersebut merupakan bagian dari pendekodean kueri, bukan penguraian URL.
• Teks beraksen dan teks non-Latin pada path atau kueri harus menggunakan pengodean persen UTF-8 jika diwajibkan oleh sistem penerima. Nama domain internasional menggunakan bentuk yang kompatibel dengan ASCII agar dapat digunakan secara luas oleh berbagai protokol.
• Angka tidak memiliki perilaku penguraian khusus. Angka tetap diperlakukan sebagai karakter biasa dalam path atau nilai kueri.

Input kosong tidak memiliki struktur URL berguna yang dapat diperiksa. URL yang sangat panjang juga mungkin terkena batasan di tempat lain, termasuk pada browser, server web, proksi, dan framework aplikasi. Alat ini tidak menentukan apakah sistem lain akan menerima URL dengan panjang tertentu.

Kapan URL perlu diurai?

Penguraian berguna ketika kamu perlu mendiagnosis struktur alamat sebelum kode atau infrastruktur memprosesnya. Contoh umumnya adalah memeriksa alamat callback webhook sebelum deployment, meninjau tujuan pengalihan, memisahkan rute API dari filter, dan membaca URL yang disalin dari log proksi terbalik.

Penguraian biasanya tidak diperlukan jika URL yang sudah dikenal dan terstruktur hanya akan diproses oleh mesin, sementara aplikasimu telah menggunakan pustaka URL. Penguraian juga bukan pilihan yang tepat jika kamu perlu menguji ketersediaan, mengikuti pengalihan, mendekode setiap parameter kueri, atau memastikan bahwa suatu domain dapat dipercaya.

Untuk pekerjaan berulang atau otomatis, gunakan fasilitas URL bawaan lingkunganmu. PHP memiliki parse_url, JavaScript di browser memiliki antarmuka URL, Node.js menyediakan kelas URL, dan Python menyertakan urllib.parse. Skrip baris perintah sederhana lebih sesuai daripada penguraian manual saat memproses file log yang berisi ribuan alamat.

Jangan mengurai URL hanya untuk memformat ulang alamat yang sudah memiliki bentuk persis seperti yang dibutuhkan sistem penerima. Mengodekan ulang atau menyusun kembali alamat tanpa alasan yang jelas dapat mengubah tanda tangan kueri, parameter duplikat, atau karakter khusus.

Pertanyaan umum

Bisakah URL diurai tanpa http atau https?

Ya, fungsi parse_url milik PHP dapat menafsirkan referensi relatif dan URL sebagian, meskipun skema tidak akan tersedia jika memang tidak dicantumkan. Berhati-hatilah dengan alamat relatif terhadap skema yang diawali dua garis miring karena maknanya bergantung pada dokumen atau aplikasi tempat alamat tersebut digunakan.

Apakah parameter kueri yang berulang tetap dipertahankan?

Kueri ditampilkan sebagai komponen mentah, sehingga nama yang berulang dapat tetap muncul dalam urutan aslinya. Cara nilai seperti tag=red&tag=blue diubah menjadi larik atau nilai terpisah bergantung pada pengurai string kueri yang digunakan setelahnya.

Apakah aman menempelkan URL bertanda tangan?

Input dikirim melalui HTTPS dan tidak disimpan, tetapi URL bertanda tangan tetap dapat memberikan akses ke konten privat selama tanda tangannya masih berlaku. Samarkan token atau ganti nama host dan nilainya dengan placeholder yang mewakili data tersebut jika kredensial persisnya tidak diperlukan.

Mengapa URL yang tampak valid berperilaku berbeda di aplikasi saya?

Perbedaan dapat muncul akibat pendekodean kueri dan normalisasi Unicode yang khusus untuk framework tertentu. Aplikasi juga dapat menerapkan aturan tambahan setelah penguraian, termasuk daftar nama host yang diizinkan dan pembatasan pengalihan. Bandingkan byte URL mentah satu per satu, lalu periksa apa yang didekodekan atau ditulis ulang oleh aplikasimu sebelum permintaan dikirim.