PHP и мобильные URL: от обнаружения до редиректа

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

Пример 1: Полноценный класс для редиректа с сессией и исключениями

<?php
namespace App\Mobile;

use Detection\MobileDetect;

class MobileRedirector
{
    private $detect;
    private $mobilePathPrefix = '/mobile';
    private $excludedPaths = ['/admin', '/api'];

    public function __construct()
    {
        $this->detect = new MobileDetect();
    }

    public function handle()
    {
        session_start();

        // Если уже был редирект в этой сессии – пропускаем
        if (!empty($_SESSION['mobile_redirect_done'])) {
            return;
        }

        // Исключаем определённые пути
        foreach ($this->excludedPaths as $path) {
            if (strpos($_SERVER['REQUEST_URI'], $path) === 0) {
                return;
            }
        }

        // Если устройство мобильное (не планшет) и ещё не на мобильной версии
        if ($this->detect->isMobile() && !$this->detect->isTablet()) {
            if (strpos($_SERVER['REQUEST_URI'], $this->mobilePathPrefix) !== 0) {
                $_SESSION['mobile_redirect_done'] = true;
                $redirectUrl = $this->mobilePathPrefix . $_SERVER['REQUEST_URI'];
                header('Location: ' . $redirectUrl, true, 302);
                exit;
            }
        }
    }
}

$redirector = new MobileRedirector();
$redirector->handle();
?>

// Результат: при заходе с мобильного телефона происходит однократный редирект на /mobile/...
// Администраторы и API не затрагиваются.

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

Пример 2: Генерация deep link с поддержкой Universal Links и App Links

<?php
function generateDeepLink($path, $params = [], $iosAppId = null, $androidPackage = null)
{
    $deepLink = [
        'ios_scheme' => 'myapp://' . ltrim($path, '/'),
        'android_scheme' => 'myapp://' . ltrim($path, '/')
    ];

    // Добавляем параметры
    $query = http_build_query($params);
    if ($query) {
        $deepLink['ios_scheme'] .= '?' . $query;
        $deepLink['android_scheme'] .= '?' . $query;
    }

    // Для Universal Links (iOS) – https://example.com/path
    // Для App Links (Android) – https://example.com/path (аналогично)
    if ($iosAppId) {
        $deepLink['ios_universal'] = 'https://example.com/' . $path . ($query ? '?' . $query : '');
    }
    if ($androidPackage) {
        $deepLink['android_applinks'] = 'https://example.com/' . $path . ($query ? '?' . $query : '');
    }

    // Fallback – обычная веб-ссылка
    $deepLink['fallback'] = 'https://example.com/' . $path . ($query ? '?' . $query : '');

    return $deepLink;
}

$result = generateDeepLink('product/42', ['ref' => 'push'], 'com.example.app', 'com.example.app');
echo json_encode($result, JSON_PRETTY_PRINT);
?>

{
    "ios_scheme": "myapp://product/42?ref=push",
    "android_scheme": "myapp://product/42?ref=push",
    "ios_universal": "https://example.com/product/42?ref=push",
    "android_applinks": "https://example.com/product/42?ref=push",
    "fallback": "https://example.com/product/42?ref=push"
}

Пояснение: функция возвращает массив ссылок, которые можно использовать в HTML-метатегах или JavaScript для умного редиректа. Кастомные схемы используются, если приложение установлено; в противном случае – открывается веб-версия.

Пример 3: Параметр мобильной версии с валидацией и куками

<?php
class MobileViewSelector
{
    private $mobileParam = 'mobile';
    private $cookieName = 'mobile_selection';
    private $cookieLifetime = 30; // дней

    public function getCurrentView()
    {
        // Определяем, какой вид показывать
        $mobileView = null;

        // Проверяем GET-параметр
        if (isset($_GET[$this->mobileParam])) {
            $mobileView = filter_var($_GET[$this->mobileParam], FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE);
            if ($mobileView !== null) {
                // Сохраняем выбор в куки
                $this->setCookie($mobileView);
            }
        }

        // Если параметра не было – проверяем куки
        if ($mobileView === null && isset($_COOKIE[$this->cookieName])) {
            $mobileView = ($_COOKIE[$this->cookieName] === '1');
        }

        // По умолчанию – определяем через User-Agent
        if ($mobileView === null) {
            $detect = new MobileDetect();
            $mobileView = $detect->isMobile() && !$detect->isTablet();
        }

        return $mobileView;
    }

    private function setCookie($value)
    {
        $val = $value ? '1' : '0';
        setcookie($this->cookieName, $val, time() + 86400 * $this->cookieLifetime, '/');
    }
}

$selector = new MobileViewSelector();
$isMobile = $selector->getCurrentView();
// Далее используется $isMobile для выбора шаблона
if ($isMobile) {
    echo 'Показываем мобильную версию';
} else {
    echo 'Показываем десктопную версию';
}
?>

// При первом посещении с мобильного – мобильная версия.
// После добавления ?mobile=0 в URL – сохраняется куки и показывается десктопная версия.

Пояснение: класс управляет логикой выбора версии, при этом GET-параметр имеет наивысший приоритет, затем – куки, затем – автоматическое определение. Валидация через FILTER_VALIDATE_BOOLEAN предотвращает инъекции.

Пример 4: Фильтрация и обработка входящего URL для мобильного приложения

<?php
// Предположим, приложение отправляет запрос на сервер с deep link параметрами
// Необходимо безопасно извлечь данные и проверить подпись

function processIncomingMobileUrl($rawData)
{
    // Входные данные предположительно JSON
    $data = json_decode($rawData, true);
    if (json_last_error() !== JSON_ERROR_NONE) {
        return ['error' => 'Invalid JSON'];
    }

    // Валидация обязательных полей
    $required = ['path', 'user_id', 'timestamp'];
    foreach ($required as $field) {
        if (empty($data[$field])) {
            return ['error' => 'Missing required field: ' . $field];
        }
    }

    // Проверка подписи (например, HMAC)
    $secret = 'my_secret_key';
    $signature = hash_hmac('sha256', $data['path'] . $data['user_id'] . $data['timestamp'], $secret);
    if (!isset($data['signature']) || $data['signature'] !== $signature) {
        return ['error' => 'Invalid signature'];
    }

    // Дополнительная очистка пути (запрещаем ../)
    $cleanPath = preg_replace('/[^a-zA-Z0-9_\/\-]/', '', $data['path']);
    if (strpos($cleanPath, '..') !== false) {
        return ['error' => 'Invalid path'];
    }

    return ['success' => true, 'path' => $cleanPath, 'user_id' => (int)$data['user_id']];
}

$incoming = '{"path":"profile/1234","user_id":"42","timestamp":"1700000000","signature":"abc..."}';
$result = processIncomingMobileUrl($incoming);
print_r($result);
?>

Array
(
    [success] => 1
    [path] => profile/1234
    [user_id] => 42
)

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