کدگذار و رمزگشای URL

راهنمای کامل کدگذاری پیوند

پیوندها در دوران فقط ASCII طراحی شده بودند، اما وب مدرن پر از فاصله، متن اردو، ایموجی ها و نشانه هاست. کدگذاری درصدی شکاف را پر می کند: هر حرف غیر امن با نشانه جایگزین می شود % که پس از آن کد هگزادسیمال دو رقمی آن می آید. پس فاصله می شود %20، پس «hello world» می شود hello%20world — پیوندی که هر مرورگر و سروری می تواند با آن کنار بیاید.

هر دو حالت، با توضیح

حروف پیوند به دو گروه تقسیم می شوند. حروف رزرو شده (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) معنای ساختاری دارد — اینها پروتکل، هاست، مسیر و کوئری را جدا می کنند. در حالی که حروف غیر رزرو شده (حروف، ارقام و- _ . ~) همیشه امن اند. حالت پیوند کامل (مثل encodeURI در جاوا اسکریپت) فقط حروف غیر رزرو شده را کدگذاری می کند و ساختار را نگه می دارد — آن را برای پیوندهای کامل استفاده کنید. در حالی که حالت جزئی (مثل encodeURIComponent) حروف رزرو شده را هم کدگذاری می کند — آن را برای یک مقدار کوئری واحد استفاده کنید مثل ?q=hello world & friends، جایی که نباید خلط شود بین & درون مقدار و جداکننده پارامترها.

اشتباه های کلاسیکی که این از آنها جلوگیری می کند

• کدگذاری دوگانه: کدگذاری رشته از پیش کدگذاری شده تبدیل می کند %20 در %2520. اگر مطمئن نیستید نخست رمزگشایی کنید.
• رشته های کوئری شکسته: نشانه & در عبارت جستجو بدون کدگذاری آن را به دو پارامتر تقسیم می کند.
• پیوندهای غیر انگلیسی: مرورگرها پیوندهای غیر لاتین را زیبا نشان می دهند اما آنها را به صورت درصدی کدگذاری شده منتقل می کنند — برای API ها و تغییر مسیرها خودتان آنها را کدگذاری کنید.

در کد: در جاوا اسکریپت موجود است encodeURIComponent() به صورت داخلی؛ و در Python هست urllib.parse.quote(). اما برای کارهای فوری یک باره — درست کردن پیوند، آماده کردن تغییر مسیر، یا رمزگشایی پیوند به هم ریخته از ایمیل — این ابزار از باز کردن کنسول سریع تر است.

کدگذاری متن غیر انگلیسی

حروف Unicode نخست به بایت های UTF-8 تبدیل می شوند، سپس هر بایت به صورت درصدی کدگذاری می شود. پس کلمه اردوی اردو چنین رشته ای می شود %D8%A7%D8%B1%D8%AF%D9%88 — طولانی، اما برای کپی کردن کاملا امن. مرورگرهای مدرن شکل رمزگشایی شده را در نوار نشانی نشان می دهند در حالی که شکل کدگذاری شده را روی سیم می فرستند، به همین دلیل پیوندهای بین المللی برای کاربران «کار می کنند» اما در کد هنوز به کدگذاری درست نیاز است.

کدگذاری کجا بیشتر مهم است

• پیوندهای اشتراک گذاری: پیوندهای اشتراک گذاری از پیش پر شده WhatsApp یا Twitter با متن پیام باید فاصله ها و علائم نگارشی را کدگذاری کنند.
• پیوندهای تغییر مسیر: پارامتر next رشته کوئری خود را نگه می دارد که باید با حالت جزئی کاملا کدگذاری شود وگرنه می شکند.
• امضاهای API: OAuth و درگاه های پرداخت به کدگذاری دقیقا استاندارد نیاز دارند — یک حرف اشتباه امضا را باطل می کند.
• دانلودهای فایل: نام های فایل دارای فاصله یا نشانه در سربرگ ها Content-Disposition برای دانلود درست به کدگذاری نیاز دارند.