Управление URL-адресами на языке PHP

Расширенные примеры обработки URL

Объединение относительного URL с базовым

Часто требуется преобразовать относительный адрес в абсолютный, используя базовый URL. Реализация учитывает все компоненты.

function resolveUrl($base, $relative) {
    $baseParts = parse_url($base);
    $relativeParts = parse_url($relative);
    
    if (isset($relativeParts['scheme'])) {
        return $relative;
    }
    
    $result = $baseParts['scheme'] . '://' . $baseParts['host'];
    if (isset($baseParts['port'])) {
        $result .= ':' . $baseParts['port'];
    }
    
    if ($relative[0] === '/') {
        $result .= $relative;
    } else {
        $basePath = dirname($baseParts['path'] ?? '/');
        if ($basePath === '\\') $basePath = '/';
        $result .= $basePath . '/' . $relative;
    }
    
    if (isset($relativeParts['query'])) {
        $result .= '?' . $relativeParts['query'];
    }
    if (isset($relativeParts['fragment'])) {
        $result .= '#' . $relativeParts['fragment'];
    }
    
    return $result;
}

echo resolveUrl('https://example.com/dir/page.php?x=1', 'sub/file.html#top');
echo "\n";
echo resolveUrl('https://example.com/dir/page.php', '/new/path');
echo "\n";
echo resolveUrl('https://example.com/dir/page.php', '//other.com/path');

https://example.com/dir/sub/file.html#top
https://example.com/new/path
https://other.com/path

Парсинг строки запроса с поддержкой множественных значений

Стандартный parse_str() корректно обрабатывает массивы параметров, но если нужно сохранить порядок или обработать повторяющиеся ключи, можно использовать пользовательскую функцию.

function parseQueryCustom($queryString) {
    $result = [];
    foreach (explode('&', $queryString) as $pair) {
        $parts = explode('=', $pair, 2);
        $key = urldecode($parts[0]);
        $value = isset($parts[1]) ? urldecode($parts[1]) : '';
        if (isset($result[$key])) {
            $result[$key] = is_array($result[$key]) ? $result[$key] : [$result[$key]];
            $result[$key][] = $value;
        } else {
            $result[$key] = $value;
        }
    }
    return $result;
}

$query = 'key1=a&key2=b&key1=c';
print_r(parseQueryCustom($query));

Array
(
    [key1] => Array
        (
            [0] => a
            [1] => c
        )
    [key2] => b
)

Кодирование и декодирование с учётом разных схем

При работе с путями URL важно использовать rawurlencode(), чтобы пробелы кодировались как %20, а не +. Пример создания полного URL из частей.

function buildUrl($scheme, $host, $port = null, $path = '', $query = [], $fragment = '') {
    $url = $scheme . '://' . $host;
    if ($port) $url .= ':' . $port;
    $url .= '/' . ltrim(rawurlencode($path), '/');
    if ($query) $url .= '?' . http_build_query($query, '', '&', PHP_QUERY_RFC3986);
    if ($fragment) $url .= '#' . rawurlencode($fragment);
    return $url;
}

echo buildUrl('https', 'example.com', 8080, 'путь/к странице', ['ключ' => 'значение'], 'якорь');

https://example.com:8080/%D0%BF%D1%83%D1%82%D1%8C/%D0%BA%20%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D0%B5?%D0%BA%D0%BB%D1%8E%D1%87=%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

Проверка доступности URL с помощью cURL

Хотя тема статьи не про cURL, в разделе "Взаимодействие с HTTP" уместно показать, как убедиться, что URL действительно отвечает (например, код 200).

function urlExists($url) {
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_NOBODY => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 10
    ]);
    curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    return $httpCode === 200;
}

echo urlExists('https://httpstat.us/200') ? 'Существует' : 'Не найдено';
echo "\n";
echo urlExists('https://httpstat.us/404') ? 'Существует' : 'Не найдено';

Существует
Не найдено

Безопасное получение содержимого удалённого URL с проверкой ошибок

При загрузке контента по URL нужно обрабатывать ошибки соединения, таймауты и некорректные ответы. Пример с file_get_contents() и контекстом.

function fetchUrl($url) {
    $options = [
        'http' => [
            'method' => 'GET',
            'timeout' => 5,
            'ignore_errors' => true
        ]
    ];
    $context = stream_context_create($options);
    $result = @file_get_contents($url, false, $context);
    if ($result === false) {
        $error = error_get_last();
        return "Ошибка: " . ($error['message'] ?? 'Неизвестная ошибка');
    }
    return $result;
}

echo fetchUrl('https://example.com');