Практические приёмы работы с URL в сценариях PHP

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

Пример 1. Извлечение доменного имени из произвольного URL с обработкой ошибок

Функция parse_url() возвращает false для некорректных строк. Данный пример демонстрирует безопасное извлечение хоста и проверку входящего адреса.

function extractHost(string $url): ?string {
    $parts = parse_url($url);
    if ($parts === false) {
        return null; // невалидный URL
    }
    return $parts['host'] ?? null;
}

$testUrls = [
    'https://www.example.com/path',
    'invalid url without scheme',
    'ftp://files.server.org:21'
];

foreach ($testUrls as $url) {
    $host = extractHost($url);
    echo 'URL: ' . $url . '  =>  Host: ' . ($host ?? 'null') . PHP_EOL;
}

URL: https://www.example.com/path  =>  Host: www.example.com
URL: invalid url without scheme  =>  Host: null
URL: ftp://files.server.org:21  =>  Host: files.server.org

Пример 2. Преобразование относительного URL в абсолютный с учётом базового

Для относительных ссылок (начинающихся с '/' или без схемы) необходимо объединить их с базовым URL. Реализация учитывает разные случаи: полный относительный путь, только путь, запрос или фрагмент.

function resolveUrl(string $base, string $relative): string {
    if (parse_url($relative, PHP_URL_SCHEME) !== null) {
        return $relative; // уже абсолютный
    }

    $baseParts = parse_url($base);
    if ($baseParts === false) {
        throw new InvalidArgumentException('Base URL is malformed');
    }

    $scheme = $baseParts['scheme'] ?? 'http';
    $host = $baseParts['host'] ?? '';
    $port = isset($baseParts['port']) ? ':' . $baseParts['port'] : '';
    $path = $baseParts['path'] ?? '/';
    $query = $baseParts['query'] ?? '';
    $fragment = $baseParts['fragment'] ?? '';

    // Если относительный начинается с '//' (protocol-relative)
    if (strpos($relative, '//') === 0) {
        return $scheme . ':' . $relative;
    }

    // Если относительный начинается с '/'
    if (strpos($relative, '/') === 0) {
        return $scheme . '://' . $host . $port . $relative;
    }

    // Обработка ссылок вида '?query=1' или '#frag'
    if ($relative[0] === '?') {
        return $scheme . '://' . $host . $port . $path . $relative;
    }
    if ($relative[0] === '#') {
        return $scheme . '://' . $host . $port . $path . ($query ? '?' . $query : '') . $relative;
    }

    // Иначе базовая директория + относительный путь
    $baseDir = dirname($path);
    if ($baseDir === '\\' || $baseDir === '.') {
        $baseDir = '/';
    }
    $normalizedDir = rtrim($baseDir, '/') . '/';
    return $scheme . '://' . $host . $port . $normalizedDir . $relative;
}

$base = 'https://example.com/sub/page?ref=1';
echo resolveUrl($base, 'newpage') . PHP_EOL;
echo resolveUrl($base, '/absolute/path') . PHP_EOL;
echo resolveUrl($base, '?lang=en') . PHP_EOL;
echo resolveUrl($base, '#anchor') . PHP_EOL;
echo resolveUrl($base, '//cdn.example.com/file.js') . PHP_EOL;

https://example.com/sub/newpage
https://example.com/absolute/path
https://example.com/sub/page?lang=en
https://example.com/sub/page?ref=1#anchor
https://cdn.example.com/file.js

Пример 3. Формирование URL с авторизацией и нестандартным портом

Комбинирование всех частей URL с использованием http_build_url() (имитация, т.к. встроенной нет). Показана ручная сборка с кодированием логина и пароля.

function buildUserUrl(string $scheme, string $host, int $port, string $user, string $pass, string $path, array $params, ?string $frag): string {
    $auth = rawurlencode($user) . ':' . rawurlencode($pass) . '@';
    $query = $params ? '?' . http_build_query($params) : '';
    $fragment = $frag ? '#' . rawurlencode($frag) : '';
    return $scheme . '://' . $auth . $host . ':' . $port . $path . $query . $fragment;
}

$url = buildUserUrl('https', 'api.example.com', 8443, 'myUser', 'p@s$word', '/v2/data', ['type' => 'json', 'limit' => 10], 'result');
echo $url;

https://myUser:p%40s%24word@api.example.com:8443/v2/data?type=json&limit=10#result

Пример 4. Работа с фрагментом (hash) без перезагрузки страницы

Фрагмент URL (часть после '#') не отправляется на сервер, но доступен на клиенте через JavaScript. Однако в PHP его можно получить при формировании ссылки или при использовании $_SERVER['REQUEST_URI'] (если фрагмент не отбрасывается браузером). Пример извлечения фрагмента из вручную переданного URL.

function getFragment(string $url): ?string {
    $parts = parse_url($url);
    return $parts['fragment'] ?? null;
}

$url = 'https://example.com/page#section2';
echo 'Fragment: ' . getFragment($url);

Fragment: section2

Пример 5. Использование rawurlencode для безопасного построения пути REST API

При создании URL для API часто требуется встраивать идентификаторы, содержащие слэши или другие спецсимволы. rawurlencode() гарантирует корректное кодирование сегмента пути.

function buildResourceUri(string $baseApi, string $resource, string $id): string {
    $encodedId = rawurlencode($id);
    return rtrim($baseApi, '/') . '/' . rawurlencode($resource) . '/' . $encodedId;
}

$api = 'https://api.example.com/v1';
echo buildResourceUri($api, 'users', 'user@example.com') . PHP_EOL;
echo buildResourceUri($api, 'files', 'path/to/file.txt');

https://api.example.com/v1/users/user%40example.com
https://api.example.com/v1/files/path%2Fto%2Ffile.txt