output_add_rewrite_var
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
output_add_rewrite_var — Добавляет значения в обработчик перезаписи URL-адресов
Описание
Когда буфер вывода сбрасывается
(вызовом функций ob_flush(), ob_end_flush(),
ob_get_flush() или в конце работы скрипта),
обработчик 'URL-Rewriter'
добавляет в атрибуты HTML-тегов пары из имени и значения
как параметры запроса для URL-адресов
и скрытые поля на основе значений директив конфигурации
url_rewriter.tags
и url_rewriter.hosts в формы.
Каждая пара имени и значения, которую добавили в обработчик 'URL-Rewriter'
,
добавится в URL-адреса и (или) формы,
даже если это задублирует URL-параметры запроса
или элементы с одинаковыми названиями атрибутов.
Замечание:
После отключения обработчика 'URL-Rewriter'
его невозможно
запустить снова.
Список параметров
name
-
Имя параметра.
value
-
Значение параметра.
Возвращаемые значения
Функция возвращает true
, если выполнилась успешно, или false
, если возникла ошибка.
Примеры
Пример #1 Пример добавления значения в обработчик перезаписи URL-адресов функцией output_add_rewrite_var()
<?php
ini_set('url_rewriter.tags', 'a=href,form=');
output_add_rewrite_var('var', 'value');
// несколько ссылок
echo '<a href="file.php">ссылка</a>
<a href="http://example.com">ссылка2</a>';
// форма
echo '<form action="script.php" method="post">
<input type="text" name="var2" />
</form>';
print_r(ob_list_handlers());
?>
Результат выполнения приведённого примера:
<a href="file.php?var=value">ссылка</a>
<a href="http://example.com">ссылка2</a>
<form action="script.php" method="post">
<input type="hidden" name="var" value="value" />
<input type="text" name="var2" />
</form>
Array
(
[0] => URL-Rewriter
)