Строка %D0%BF%D1%80%D0%B8%D0%B2%D0%B5%D1%82 и строка 0L/RgNC40LLQtdGC — это одно и то же слово «привет», закодированное двумя разными способами. Первый нужен, чтобы передать текст в адресе. Второй — чтобы упаковать произвольные байты в текст. Взаимозаменяемыми они не являются, и путаница приводит к битым ссылкам.

Три разные задачи

Полезно держать в голове, что кодирований несколько и каждое отвечает за своё:

  • percent-encoding — экранирование недопустимых символов в URL;
  • Base64 — представление бинарных данных текстом;
  • HTML-сущности — экранирование при вставке в разметку.

Ошибка новичка — прогнать параметр через base64_encode() и вставить в URL. Работать будет не всегда: в стандартном алфавите есть +, / и =, а они в адресе имеют собственный смысл.

Percent-encoding: %20 и плюс

В адресе нельзя использовать пробел, кириллицу и часть служебных символов. Они заменяются на % и две шестнадцатеричные цифры. В PHP есть две похожие функции:

echo urlencode('привет мир');    // %D0%BF%D1%80%D0%B8%D0%B2%D0%B5%D1%82+%D0%BC%D0%B8%D1%80
echo rawurlencode('привет мир'); // %D0%BF%D1%80%D0%B8%D0%B2%D0%B5%D1%82%20%D0%BC%D0%B8%D1%80

urlencode() кодирует пробел как + — это формат application/x-www-form-urlencoded, он подходит для тела формы. Для пути и параметров адреса используйте rawurlencode(): + в пути означает буквально плюс, а не пробел.

В JavaScript аналоги — encodeURIComponent() и encodeURI(). Первый кодирует всё, включая / и ?, и подходит для отдельных значений. Второй оставляет служебные символы адреса и нужен, только когда кодируется адрес целиком.

Правило: кодируйте значения по отдельности, а не собранный URL. Иначе ? и & внутри параметра превратятся в разделители.

Base64 — это не шифрование

Base64 переводит каждые три байта в четыре символа. В результате данные становятся примерно на треть длиннее, зато состоят из печатных символов и переживают пересылку в JSON, XML и письмах. Восстановить исходные байты может кто угодно — ключа нет.

Отсюда два следствия. Первое: Base64 не защищает секреты, его нельзя использовать вместо хеширования или шифрования. Второе: в JWT и Data URI полезная нагрузка не скрыта, а только упакована.

$raw = base64_decode($encoded, true);

if ($raw === false) {
    // строка не является корректным Base64
}

Второй аргумент true включает строгий режим: функция отвергает посторонние символы. Без него PHP молча выбрасывает всё непонятное, и ошибка в данных проходит незамеченной.

Base64URL и padding

Для адресов и имён файлов придумали вариант Base64URL: + заменяется на -, / на _, а знаки = в конце часто убирают. Так строка безопасна в URL и не требует дополнительного экранирования. Именно этот вариант используется в JWT.

Если вы декодируете JWT вручную, помните: перед вызовом base64_decode() нужно вернуть + и /, а также дополнить строку до длины, кратной четырём. Иначе получите false или мусор.

Для сборки строки запроса в PHP есть http_build_query(): она сама кодирует значения и корректно обрабатывает массивы. При ручной конкатенации легко забыть про экранирование и получить в значении символ &, который разорвёт параметр на два.

Где ломается на практике

  • Двойное кодирование. Значение прошло через urlencode() дважды — на выходе %25D0…, сервер видит буквальный процент.
  • Кириллица в пути. Браузер покажет её красиво, но в логах и при копировании появятся проценты. Для слагов лучше транслит.
  • Base64 в query-параметре без экранирования. Символ + превратится в пробел при разборе строки запроса.
  • Обрезанный padding. Строка без нужного числа = не декодируется строгим режимом.
  • Кодирование уже закодированного. Перед повторным вызовом проверяйте, не является ли входной текст результатом предыдущего шага.

Как проверить

Быстрый способ разобраться, что перед вами — прогнать строку через декодер: он определяет URL-кодирование, Unicode-escape, HTML-сущности, Base64 и перекодировку CP1251. Инструмент работает в браузере, данные никуда не отправляются.

Если строка пришла из JSON и выглядит как \u043f\u0440\u0438\u0432\u0435\u0442, это третий формат — escape-последовательности Unicode. О типичных ошибках разбора JSON есть отдельная статья: JSON в PHP: ошибки и безопасная обработка.

Коротко

  • percent-encoding — для адресов, Base64 — для байтов;
  • в пути используйте rawurlencode(), а не urlencode();
  • Base64 не шифрует данные;
  • в URL и JWT применяется Base64URL без =;
  • строгий режим декодирования ловит повреждённые данные.