محلل URL

محلل URL أداة مجانية تفصل عنوان الويب إلى المخطط والمسار وسلسلة الاستعلام.

ما المكونات التي يستخرجها محلل URL؟

يتعرف محلل URL على المكونات البنيوية لعنوان الويب، من دون أن تضطر إلى تقسيم النص يدويا. تعرض الأداة ثلاثة حقول تنتجها دالة parse_url في PHP.

• المخطط يحدد البروتوكول أو نظام العنونة، مثل https أو http.
• المسار يحدد مكوّن المسار، مثل /account/orders/42.
• الاستعلام يتضمن النص الواقع بعد علامة الاستفهام التي تبدأ مكوّن الاستعلام، وقبل أي علامة رقم غير مرمّزة، مثل page=2&sort=date.

يفيد تحليل URL عند فحص طلبات API أو عناوين رد الاتصال أو سجلات التطبيقات أو البيانات الواردة من جهات خارجية. فهو يساعدك على تمييز معلومات التوجيه من معلمات الاستعلام قبل تصحيح الأخطاء أو تسجيل العنوان أو تحويله.

لا تتضمن الحقول المعروضة اسم المضيف أو المنفذ أو الجزء بشكل منفصل. إذا كنت تحتاج إلى هذه المكونات، فاستخدم مكتبة أشمل لتحليل URL داخل تطبيقك.

كيف أستخدم محلل URL؟

أدخل عنوان URL كاملا أو جزئيا، ثم افحص قيم المخطط والمسار والاستعلام التي تعرضها الأداة. عادة ما يعطي عنوان URL المطلق والكامل أوضح نتيجة، لأنه يذكر المخطط صراحة.

1. انسخ عنوان URL من المتصفح أو استجابة API أو سجل webhook أو سجل الخادم.
2. ضمّن سلسلة الاستعلام إذا أردت فحص أسماء المعلمات أو قيمها.
3. قارن المسار المعروض بالمسار الذي يتوقعه تطبيقك.
4. تحقق من وجود المخطط والاستعلام إذا كان التكامل لديك يتطلبهما.

تجري المعالجة على الخادم. تُرسل مدخلاتك إلى الخادم عبر HTTPS ولا تُخزّن. ومع ذلك، تجنب إدخال رموز وصول نشطة أو روابط تنزيل موقّعة أو معرّفات جلسات أو أي بيانات اعتماد أخرى، متى كان مثال منقّح كافيا للإجابة عن السؤال نفسه.

أمثلة عملية وكيفية فهم النتائج

عند تحليل عنوان API مطلق، تفصل الأداة البروتوكول عن المسار وسلسلة الاستعلام الخام.

الإدخال https://api.example.co.uk/v1/orders/42?expand=items&currency=GBP

المخطط https

المسار /v1/orders/42

الاستعلام expand=items&currency=GBP

يُعرض الاستعلام كمكوّن واحد. وفقا للصيغة الشائعة للنماذج وسلاسل الاستعلام، تفصل علامة العطف بين الحقول، بينما تفصل أول علامة مساواة في كل حقل بين اسمه وقيمته. لكن تحليل عنوان URL وحده لا يؤكد أن expand أو currency معلمة تتعرف عليها API.

يمكن أيضا لمرجع نسبي أن يتضمن مسارا واستعلاما من دون تحديد مخطط.

الإدخال /search?q=red%20shoes&page=2

المخطط no scheme component

المسار /search

الاستعلام q=red%20shoes&page=2

غالبا ما يكون غياب المخطط متوقعا في الروابط المنشأة داخل موقع واحد. أما في البيانات التي يفترض أن تحتوي على عناوين رد اتصال مطلقة، فقد تكشف النتيجة نفسها عن غياب البادئة https://.

هذا المحلل ليس أداة للتحقق من صحة عناوين URL. يمكنه مساعدتك على اكتشاف بنية مريبة، مثل غياب المخطط أو وجود مسار غير متوقع أو نص استعلام في موضع خاطئ. لكن نجاح التحليل لا يثبت أن العنوان موجود أو أن DNS قادر على حله أو أنه يعيد استجابة HTTP ناجحة.

ماذا يحدث مع المسافات وعلامات الترقيم والمدخلات غير المعتادة؟

تؤثر المحارف المحجوزة في كيفية تقسيم عنوان URL، بينما تبقى المحارف المرمّزة عادة ضمن المكوّن الذي ظهرت فيه. يفصل المحلل بين المكونات، لكنه لا يفك ترميز محتواها ولا يوحّد صيغته.

• تبدأ علامة الاستفهام غير المرمّزة مكوّن الاستعلام. إذا كان المقصود من علامة استفهام حرفية أن تمثل بيانات خارج استعلام موجود، فينبغي ترميزها بالنسبة المئوية إن كانت ستعمل لولا ذلك فاصلا للاستعلام.
• تفصل علامة العطف عادة بين معلمات الاستعلام، لكن هذه الأداة تعرض سلسلة الاستعلام كاملة بدلا من تفسير كل معلمة على حدة.
• علامة الرقم غير المرمّزة (#) هي فاصل الجزء في الصيغة القياسية لعناوين URL. ولا تندرج بيانات الجزء ضمن الحقول المعروضة هنا.
• ينبغي عادة ترميز المسافات، وغالبا ما تُكتب بصيغة %20. وقد تمثل علامة الجمع مسافة في بيانات الاستعلام المرمّزة كنموذج، لكن هذا التفسير يخص فك ترميز الاستعلام لا تحليل URL.
• ينبغي استخدام ترميز UTF-8 بالنسبة المئوية للنصوص ذات العلامات النبرية أو المكتوبة بأحرف غير لاتينية داخل المسار أو الاستعلام، عندما يتطلب النظام المستقبِل ذلك. أما أسماء النطاقات المدوّلة فتستخدم صيغتها المتوافقة مع ASCII لضمان توافق واسع مع البروتوكولات.
• ليس للأرقام سلوك خاص أثناء التحليل. فهي تبقى محارف عادية ضمن المسار أو قيمة الاستعلام.

لا تحتوي المدخلات الفارغة على بنية مفيدة لعنوان URL يمكن فحصها. وقد تصطدم عناوين URL الطويلة جدا بقيود في مواضع أخرى، منها المتصفحات وخوادم الويب والخوادم الوكيلة وأطر عمل التطبيقات. لا تحدد هذه الأداة ما إذا كان نظام آخر سيقبل عنوان URL بطول معين.

متى يكون تحليل URL مفيدا؟

يكون التحليل مفيدا عندما تحتاج إلى تشخيص بنية عنوان قبل أن تتعامل معه الشيفرة أو البنية التحتية. من الحالات الشائعة فحص عناوين رد اتصال webhook قبل النشر، ومراجعة وجهات إعادة التوجيه، وفصل مسارات API عن عوامل التصفية، وقراءة عناوين URL المنسوخة من سجلات الوكيل العكسي.

غالبا لا تحتاج إليه إذا كان المستهلك الوحيد عنوان URL معروفا ومنظما مسبقا هو نظام آلي، وكان تطبيقك يستخدم بالفعل مكتبة لعناوين URL. كما أنه ليس الإجراء المناسب إذا أردت اختبار التوفر أو تتبع عمليات إعادة التوجيه أو فك ترميز كل معلمات الاستعلام أو التحقق من موثوقية نطاق.

في المهام المتكررة أو المؤتمتة، استخدم إمكانات URL المدمجة في بيئتك. توفر PHP الدالة parse_url، وتوفر JavaScript في المتصفح واجهة URL، وتوفر Node.js الفئة URL، بينما تتضمن Python الوحدة urllib.parse. عند معالجة ملف سجل يضم آلاف العناوين، يكون برنامج نصي صغير لسطر الأوامر أنسب من التحليل اليدوي.

لا تحلل عنوان URL لمجرد إعادة تنسيقه إذا كان بالفعل بالصيغة الدقيقة التي يتطلبها النظام المستقبِل. فقد يؤدي إعادة ترميز العناوين أو بنائها من جديد بلا سبب واضح إلى تغيير توقيعات الاستعلام أو المعلمات المكررة أو المحارف المحجوزة.

الأسئلة الشائعة

هل يمكنني تحليل URL من دون http أو https؟

نعم، تستطيع دالة parse_url في PHP تفسير المراجع النسبية وعناوين URL الجزئية، لكن لن تتوفر قيمة للمخطط إذا لم تُدخلها. انتبه إلى العناوين النسبية إلى المخطط التي تبدأ بشرطتين مائلتين، لأن معناها يعتمد على المستند أو التطبيق المحيط بها.

هل يحتفظ المحلل بمعلمات الاستعلام المكررة؟

يُعرض الاستعلام كمكوّن خام، لذلك يمكن أن تبقى الأسماء المكررة بترتيبها الأصلي. وتعتمد طريقة تحويل قيم مثل tag=red&tag=blue إلى مصفوفات أو قيم منفردة على محلل سلسلة الاستعلام المستخدم بعد ذلك.

هل لصق عنوان URL موقّع آمن؟

تُرسل المدخلات عبر HTTPS ولا تُخزّن، لكن عنوان URL الموقّع قد يظل يمنح حق الوصول إلى محتوى خاص ما دام توقيعه صالحا. احذف الرمز أو استبدل اسم المضيف والقيم بعناصر نائبة ممثلة للحالة كلما لم تكن بيانات الاعتماد الدقيقة ضرورية.

لماذا يتصرف عنوان URL الذي يبدو صالحا بشكل مختلف في تطبيقي؟

قد تنتج الاختلافات عن طريقة إطار العمل في فك ترميز الاستعلام وتوحيد Unicode. وقد تطبق التطبيقات أيضا قواعد إضافية بعد التحليل، منها قوائم أسماء المضيفين المسموح بها وقيود إعادة التوجيه. قارن وحدات البايت في عنوان URL الخام واحدة بواحدة، ثم تحقق مما يفك تطبيقك ترميزه أو يعيد كتابته قبل إرسال الطلب.