Output reset rewrite vars: примеры (PHP)

Примеры использования

Добавление и последующий сброс переменных перезаписи:

<?php
// Включение буферизации вывода
ob_start();

// Добавление переменных перезаписи
output_add_rewrite_var('lang', 'ru');
output_add_rewrite_var('theme', 'dark');

// Генерация ссылки с автоматическим добавлением параметров
echo '<a href="/page.php">Ссылка</a>';

// Сброс всех переменных перезаписи
output_reset_rewrite_vars();

// Теперь ссылка будет без добавленных параметров
echo '<a href="/another.php">Другая ссылка</a>';

ob_end_flush();
?>

<a href="/page.php?lang=ru&theme=dark">Ссылка</a>
<a href="/another.php">Другая ссылка</a>

<?php
ob_start();
output_add_rewrite_var('test', 'value');
$result = output_reset_rewrite_vars();
if ($result) {
    echo 'Переменные перезаписи успешно сброшены';
} else {
    echo 'Сброс не удался';
}
ob_end_flush();
?>

Переменные перезаписи успешно сброшены

Похожие функции в PHP

Добавляет пару ключ-значение для автоматической вставки в относительные URL. Работает в паре с output_reset_rewrite_vars().

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

Использование функций типа http_build_query() и конкатенации строк предоставляет полный контроль над параметрами URL, но требует большего объёма кода.

Аналоги в других языках

В JavaScript нет прямой аналогии, но управление параметрами URL осуществляется через объект URLSearchParams:

// Добавление параметров к URL
let url = new URL('https://example.com/page');
url.searchParams.set('lang', 'ru');
url.searchParams.set('theme', 'dark');
console.log(url.toString());

// Сброс параметров
url.search = '';
console.log(url.toString());

https://example.com/page?lang=ru&theme=dark
https://example.com/page

В Python для аналогичных задач используется модуль urllib.parse:

from urllib.parse import urlencode, urlparse, urlunparse

# Добавление параметров
params = {'lang': 'ru', 'theme': 'dark'}
query_string = urlencode(params)
url = 'http://example.com/page?' + query_string
print(url)

# Сброс параметров
parsed = urlparse(url)
cleaned_url = urlunparse(parsed._replace(query=''))
print(cleaned_url)

http://example.com/page?lang=ru&theme=dark
http://example.com/page

В SQL-запросах параметры URL обычно не модифицируются, так как это задача серверного языка программирования.

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

Функция требует активного буфера вывода для корректной работы:

<?php
// Буферизация не включена
output_add_rewrite_var('key', 'value'); // Не сработает
$result = output_reset_rewrite_vars();
var_dump($result);
?>

bool(false)

Попытка сброса переменных для конкретного URL вместо всех:

<?php
ob_start();
output_add_rewrite_var('global', 'param');
// Неверно: функция сбрасывает ВСЕ переменные, а не выборочно
echo '<a href="/page1.php">Ссылка 1</a>';
output_reset_rewrite_vars();
// После этого все последующие ссылки не получат параметров
echo '<a href="/page2.php">Ссылка 2</a>';
ob_end_flush();
?>

Изменения в версиях PHP

Функция output_reset_rewrite_vars() была добавлена в PHP 5.1.0. Значительных изменений в её работе не происходило, но в PHP 7.1.0 было исправлено несколько ошибок, связанных с обработкой специальных символов в параметрах.

В PHP 8.0 и 8.1 функция сохранила обратную совместимость, без изменений сигнатуры или поведения.

Расширенные примеры

Автоматическое добавление и очистка идентификатора сессии для определённых групп ссылок:

<?php
ob_start();
session_start();

// Добавляем ID сессии только для административных ссылок
if (isset($_SESSION['admin'])) {
    output_add_rewrite_var('sid', session_id());
}

// Административные ссылки получат параметр
echo '<a href="/admin.php">Панель управления</a>';

// Сбрасываем для пользовательской части сайта
output_reset_rewrite_vars();

// Обычные ссылки без параметра сессии
echo '<a href="/catalog.php">Каталог</a>';
ob_end_flush();
?>

Использование в шаблонизаторе для изоляции параметров разных модулей:

<?php
ob_start();

// Модуль корзины добавляет свой параметр
output_add_rewrite_var('cart_id', 'ABC123');
include 'cart_template.php';

// Сброс перед обработкой модуля пользователя
output_reset_rewrite_vars();
output_add_rewrite_var('user_id', '42');
include 'user_profile_template.php';

ob_end_flush();
?>

Временное добавление токена безопасности для динамически загружаемого контента:

<?php
ob_start();

if ($isAjaxRequest) {
    output_add_rewrite_var('csrf_token', $_SESSION['token']);
    // Генерация контента с защищёнными ссылками
    echo '<a href="/load_data.php">Загрузить данные</a>';
    // Сброс после генерации блока
    output_reset_rewrite_vars();
}

ob_end_flush();
?>