Способы создания URL в PHP: от основ к продвинутым приёмам

Раздел: Веб-разработка -> Работа с URL в PHP

Создание ссылки в PHP: общие принципы и методы

Создание ссылки (URL) в PHP требуется при построении навигации, передаче данных через параметры запроса, формировании ссылок для API или безопасных переходов. Основная задача - корректно собрать строку URL из компонентов (схема, хост, путь, параметры, якорь) и закодировать специальные символы.

Наиболее эффективное решение: использование http_build_query() в сочетании с проверенными функциями кодирования

Этот подход автоматически обрабатывает кодирование параметров, избегая ручной обработки и ошибок с двойным кодированием. Пример:

$baseUrl = 'https://example.com/search';
$params = ['query' => 'PHP & MySQL', 'page' => 2, 'filter' => ['price' => 100]];
$fullUrl = $baseUrl . '?' . http_build_query($params);
echo htmlspecialchars($fullUrl, ENT_QUOTES, 'UTF-8');

Php создание ссылки (создание ссылки в php)

https://example.com/search?query=PHP+%26+MySQL&page=2&filter%5Bprice%5D=100

Php текущая url (текущая url в php)

Функция http_build_query() корректно обрабатывает вложенные массивы, кодирует пробелы как + (или %20 при использовании параметра PHP_QUERY_RFC3986). Для вывода в HTML обязательно экранирование htmlspecialchars() для предотвращения XSS.

Для создания абсолютной ссылки с указанием протокола и хоста можно воспользоваться компонентом http_build_url() из расширения pecl_http или реализовать собственную обёртку:

function buildUrl(string $scheme, string $host, string $path, array $params = [], ?string $fragment = null): string {
    $url = $scheme . '://' . $host . '/' . ltrim($path, '/');
    if ($params) {
        $url .= '?' . http_build_query($params);
    }
    if ($fragment) {
        $url .= '#' . urlencode($fragment);
    }
    return $url;
}
echo htmlspecialchars(buildUrl('https', 'example.com', '/page', ['id' => 1], 'section2'));

Mobile php url (мобильный url в php)

https://example.com/page?id=1#section2

Php open url (открытие url в php)

Проблемы: если параметры уже содержат URL-кодированные значения, повторный вызов http_build_query() приведёт к двойному кодированию. Решение - использовать сырые данные без предварительного кодирования.

Варианты решения задачи

Как сделать простую ссылку с одним параметром, не подключая библиотеки?

$url = 'https://example.com/page.php?id=' . urlencode('123&abc');
echo $url;

Js php url (javascript и php url)

https://example.com/page.php?id=123%26abc

Php строка url (строка url в php)

Вариант удобен для быстрых скриптов, но при увеличении числа параметров код становится громоздким и подвержен ошибкам.

Как создать ссылку с якорем (фрагментом)?

$base = 'https://example.com/doc#intro';
// или динамически
$url = 'https://example.com/page.php?section=2#' . urlencode('part3');
echo htmlspecialchars($url);

Url class php (класс url в php)

Якорь всегда должен быть после строки запроса; функция urlencode() применяется только к значению якоря, чтобы избежать конфликта с символами # в других частях URL.

Как сформировать ссылку для редиректа или передачи через заголовки?

$redirectUrl = 'https://example.com/new-path?token=' . rawurlencode($token);
header('Location: ' . $redirectUrl);
exit;

Php url query (url-запрос (query string) в php)

Для заголовка Location не требуется экранирование HTML, но необходимо использовать rawurlencode() для соответствия RFC 3986.

Как создать ссылку с подмассивами параметров (например, для фильтров)?

$params = ['filter' => ['category' => 5, 'price_min' => 100, 'price_max' => 500]];
$query = http_build_query($params, '', '&', PHP_QUERY_RFC3986);
$url = 'https://example.com/search?' . $query;
echo htmlspecialchars($url);

Include php url (включение url через include в php)

https://example.com/search?filter%5Bcategory%5D=5&filter%5Bprice_min%5D=100&filter%5Bprice_max%5D=500

Engine php url (движок url в php)

Параметр PHP_QUERY_RFC3986 обеспечивает кодирование пробелов как %20 вместо +.

Как избежать проблем с кодировкой кириллицы и спецсимволов в URL?

$name = 'Иван Петров';
$encodedName = rawurlencode($name); // %D0%98%D0%B2%D0%B0%D0%BD%20%D0%9F%D0%B5%D1%82%D1%80%D0%BE%D0%B2
$url = "https://example.com/profile?name=$encodedName";

Url form php (url формы в php)

Использование rawurlencode() обязательно для не-ASCII символов. При ручной конкатенации легко забыть кодирование - это типичная ошибка.

Как создать ссылку с использованием PSR-7 объектов (для проектов с Composer)?

use GuzzleHttp\Psr7\Uri;
use GuzzleHttp\Psr7\Query;

$uri = (new Uri('https://example.com'))
    ->withPath('/search')
    ->withQuery(Query::build(['q' => 'php', 'page' => 1]));
echo (string) $uri; // https://example.com/search?q=php&page=1

Подход рекомендуется в крупных приложениях, использующих современные стандарты. Проблема: требует установки библиотеки.

Типичные ошибки и их решение

1. Двойное кодирование: если параметры уже содержат urlencode-строки, повторное применение http_build_query() или urlencode() приводит к некорректному URL. Решение - передавать сырые данные.

2. Отсутствие экранирования для HTML: вставка URL напрямую в атрибут href без htmlspecialchars() может открыть XSS-уязвимость. Всегда экранируйте.

3. Неправильный порядок параметров и якоря: якорь (#) должен идти после всей строки запроса, иначе он станет частью параметра.

4. Использование urlencode() вместо rawurlencode(): первая кодирует пробелы как + (для application/x-www-form-urlencoded), тогда как вторая - как %20 (для URI). Для большинства случаев в URL предпочтительнее rawurlencode().

5. Игнорирование относительных путей: если ссылка ведёт на тот же сайт, следует использовать относительный путь, чтобы срабатывали редиректы и не ломалась структура при смене домена.

- Php параметр url (параметры url в php)

- Php parse url (парсинг url в php)

- Php url (url в php)

Расширенные примеры создания ссылок в PHP

Примеры демонстрируют нестандартные ситуации и углублённое использование функций.

Генерация ссылки с авторизационными данными (user:password@host)

Пример

$url = sprintf('ftp://%s:%s@ftp.example.com/files/', rawurlencode('user'), rawurlencode('p@ss:word'));
echo $url;

ftp://user:p%40ss%3Aword@ftp.example.com/files/

Важно экранировать логин и пароль отдельно, чтобы не нарушить парсинг.

Ссылка с несколькими якорями (через комбинирование)

Пример

$base = 'https://example.com/page';
$params = ['tab' => 'info', 'lang' => 'ru'];
$fragment = 'section-1';
$url = $base . '?' . http_build_query($params) . '#' . rawurlencode($fragment);
echo htmlspecialchars($url);

https://example.com/page?tab=info&lang=ru#section-1

Преобразование массива в URL с помощью цикла и проверки на пустые значения

Пример

function arrayToUrl(string $base, array $params): string {
    $filtered = array_filter($params, fn($v) => $v !== null && $v !== '');
    $query = http_build_query($filtered, '', '&', PHP_QUERY_RFC3986);
    return $base . ($query ? '?' . $query : '');
}
echo arrayToUrl('https://example.com/filter', ['cat' => 5, 'subcat' => '', 'sort' => 'price']);

https://example.com/filter?cat=5&sort=price

Создание ссылки с помощью регулярного выражения (замена плейсхолдеров)

Пример

$pattern = '/profile/{id}/edit';
$id = 42;
$url = str_replace('{id}', rawurlencode((string)$id), $pattern);
echo $url; // /profile/42/edit

Подходит для шаблонов маршрутов, но не защищает от инъекций в других частях.

Использование PSR-7 UriInterface для разбора и сборки

Пример

use Laminas\Diactoros\Uri;

$uri = new Uri('https://user@example.com:8080/path?q=1#frag');
$uri = $uri->withQuery('q=' . rawurlencode('php & mysql'));
echo (string) $uri; // https://user@example.com:8080/path?q=php+%26+mysql#frag

Класс автоматически корректно экранирует порт, хост и прочие компоненты.

Генерация ссылки с подписью (HMAC) для защиты от подделки

Пример

$secret = 'my-secret-key';
$params = ['action' => 'delete', 'id' => 7];
$query = http_build_query($params);
$signature = hash_hmac('sha256', $query, $secret);
$url = 'https://example.com/api?' . $query . '&sign=' . $signature;
echo htmlspecialchars($url);

Позволяет проверять целостность параметров на стороне сервера.

Создание ссылки в PHP - comments

Php создание ссылки (php)