Разбор URL: методы, примеры и типичные ошибки

Пример 1. Разбор URL с авторизацией, портом и фрагментом

URL может содержать имя пользователя и пароль, порт, путь, query и фрагмент.

$url = 'ftp://user:password@ftp.example.com:2121/docs/file.txt?mode=ascii#download';
$parsed = parse_url($url);
print_r($parsed);

Array
(
    [scheme] => ftp
    [host] => ftp.example.com
    [port] => 2121
    [user] => user
    [pass] => password
    [path] => /docs/file.txt
    [query] => mode=ascii
    [fragment] => download
)

Функция корректно выделяет все компоненты. Для дальнейшей работы с query используется parse_str.

Пример 2. Разбор относительного URL (без схемы)

Если URL не содержит схему, parse_url может некорректно определить host. Например, для URL //example.com/path (протоколонезависимый) или /path?q=1 (относительный без домена).

$urls = [
    '//example.com/path',
    '/path/to/resource',
    '?query=string',
    '#fragment'
];
foreach ($urls as $url) {
    $parts = parse_url($url);
    if (!isset($parts['scheme']) && strpos($url, '//') === 0) {
        // Протоколонезависимый - можно добавить схему по умолчанию
        $fullUrl = 'https:' . $url;
        $parts = parse_url($fullUrl);
    } elseif (!isset($parts['host']) && !isset($parts['scheme'])) {
        // Относительный путь - восстановить по базовому URL
        $baseUrl = 'https://example.com';
        $fullUrl = $baseUrl . $url; // упрощенно
        $parts = parse_url($fullUrl);
    }
    print_r($parts);
}

Array ( [scheme] => https [host] => example.com [path] => /path )
Array ( [scheme] => https [host] => example.com [path] => /path/to/resource )
Array ( [scheme] => https [host] => example.com [path] => /page?query=string )
Array ( [scheme] => https [host] => example.com [path] => /page#fragment )

Для корректного восстановления относительных URL рекомендуется использовать библиотеку PSR-7 или строить на основе контекста.

Пример 3. Разбор query string c массивами

Параметры запроса могут иметь синтаксис массивов: a[]=1&a[]=2&b[key]=value. Функция parse_str обрабатывает их.

$query = 'filter[]=price&filter[]=brand&sort[field]=name&sort[order]=asc';
parse_str($query, $result);
print_r($result);

Array
(
    [filter] => Array
        (
            [0] => price
            [1] => brand
        )
    [sort] => Array
        (
            [field] => name
            [order] => asc
        )
)

Это удобно для обработки данных из форм или HTTP-запросов.

Пример 4. Сборка URL с использованием http_build_query

Функция http_build_query формирует строку запроса из массива, автоматически кодируя ключи и значения.

$params = [
    'name' => 'Алексей',
    'age' => 30,
    'tags' => ['php', 'url', 'parsing']
];
$queryString = http_build_query($params, '', '&', PHP_QUERY_RFC3986);
$url = 'https://example.com/search?' . $queryString;
echo $url;

https://example.com/search?name=%D0%90%D0%BB%D0%B5%D0%BA%D1%81%D0%B5%D0%B9&age=30&tags%5B0%5D=php&tags%5B1%5D=url&tags%5B2%5D=parsing

Параметр PHP_QUERY_RFC3986 обеспечивает кодирование в соответствии с RFC 3986.

Пример 5. Валидация, разбор и обработка ошибок

Перед разбором стоит проверить URL с помощью filter_var, а затем обработать отсутствующие компоненты.

function parseUrlSafe(string $url): ?array {
    if (!filter_var($url, FILTER_VALIDATE_URL)) {
        return null;
    }
    $parts = parse_url($url);
    // Дополнительная обработка: преобразование query в массив
    if (isset($parts['query'])) {
        parse_str($parts['query'], $parts['query_params']);
    } else {
        $parts['query_params'] = [];
    }
    return $parts;
}

$testUrls = [
    'https://example.com/test?foo=bar',
    'invalid-url',
    'ftp://user@host:21/path'
];
foreach ($testUrls as $u) {
    $result = parseUrlSafe($u);
    echo $result ? 'OK: ' . json_encode($result) : 'FAIL: ' . $u;
    echo "\n";
}

OK: {"scheme":"https","host":"example.com","path":"\/test","query":"foo=bar","query_params":{"foo":"bar"}}
FAIL: invalid-url
OK: {"scheme":"ftp","host":"host","port":21,"user":"user","path":"\/path","query_params":[]}

Функция возвращает null для невалидного URL, что позволяет избежать ошибок в дальнейшем коде.

Пример 6. Работа с кириллическими URL и кодированием

Если URL содержит кириллические символы, их необходимо кодировать. Функции urlencode и rawurlencode отличаются: последний кодирует пробелы как %20, а не +.

$url = 'https://example.com/путь до файла?имя=значение#якорь';
$encoded = rawurlencode($url); // кодирует весь URL (неправильно)
// Правильный подход: кодировать отдельные части
$path = '/путь до файла';
$query = 'имя=значение';
$fragment = 'якорь';
$urlEncoded = 'https://example.com' . rawurlencode($path) . '?' . rawurlencode($query) . '#' . rawurlencode($fragment);
echo $urlEncoded . "\n";
// Обратное декодирование
echo rawurldecode($urlEncoded);

https://example.com%2F%D0%BF%D1%83%D1%82%D1%8C%20%D0%B4%D0%BE%20%D1%84%D0%B0%D0%B9%D0%BB%D0%B0?%D0%B8%D0%BC%D1%8F%3D%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5#%D1%8F%D0%BA%D0%BE%D1%80%D1%8C
https://example.com/путь до файла?имя=значение#якорь

Для разбора URL с кириллицей применяются функции rawurlencode и rawurldecode.