output_add_rewrite_var
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
output_add_rewrite_var — Додає значення до обробника перезапису URL
Опис
output_add_rewrite_var(string $name, string $value): bool
Функція запускає обробник буфера виводу «URL-Rewriter»якщо він не активний, зберігає значення параметрів nameиvalue, і коли буфер скидається, перезаписує URL-адреси та форми на основі придатних ini-налаштувань. Чергові дзвінки функції зберігатимуть усі додаткові пари ім'я/значення доти, доки обробник не буде вимкнений.
Коли буфер виведення скидається (викликом функцій 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**в случае возникновения ошибки.
список змін
| Версия | Опис |
|---|---|
| 7.1.0 | Починаючи з PHP 7.1.0, функція використовує виділений буфер виводу, директива url_rewriter.tags враховується лише під час роботи з функціями виведення, а директива url_rewriter.hosts доступна. До PHP 7.1.0 змінні перезаписи, встановлені функціями output_add_rewrite_var(), використовували загальний буфер виводу за допомогою прозорого ідентифікатора сесії (див. опис директиви session.trans_sid_tags |
Приклади
Приклад #1 Приклад використання функції output_add_rewrite_var()****
Результат виконання наведеного прикладу:
<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
)
Дивіться також
- output_reset_rewrite_vars() - Скинути значення обробника URL
- ob_flush() - Скидає (відправляє) повернене активним обробником висновку значення
- ob_list_handlers() - Повертає список активних обробників виводу
- url_rewriter.tags
- url_rewriter.hosts