Строка %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 без
=; - строгий режим декодирования ловит повреждённые данные.