PHP8 output_add_rewrite_var — 添加URL重写器的值
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
output_add_rewrite_var — 添加URL重写器的值（Add URL rewriter values）
说明
output_add_rewrite_var(string $name, string $value): bool此函数给URL重写机制添加名/值对。 这种名值对将被添加到 URL（以 GET 参数的形式）和表单（以 input 隐藏域的形式），当透明 URL 重写用 session.use_trans_sid 开启时同样可以添加到 session ID。
此函数的行为受 url_rewriter.tags 和 url_rewriter.hosts php.ini 参数控制。
注意，每个请求最多可以成功调用此函数一次。
注意: 如果还没有活跃的输出缓冲区，调用此函数将隐式地开启它。
参数
name-
变量名。
value-
变量值。
返回值
成功时返回 true， 或者在失败时返回 false。
更新日志
| 版本 | 说明 |
|---|---|
| 7.1.0 | 在 PHP 7.1.0 之前，使用 output_add_rewrite_var() 设置重写变量使用相同的 Session 模块 trans sid 输出缓冲区。从 PHP 7.1.0 起，使用专用的输出缓冲区， url_rewriter.tags 仅用于输出函数，新增 url_rewriter.hosts。 |
示例
示例 #1 output_add_rewrite_var() example
<?php
output_add_rewrite_var('var', 'value');
// some links
echo '<a href="file.php">link</a>
<a href="http://example.com">link2</a>';
// a form
echo '<form action="script.php" method="post">
<input type="text" name="var2" />
</form>';
print_r(ob_list_handlers());
?>以上示例会输出：
<a href="file.php?var=value">link</a>
<a href="http://example.com">link2</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重写器的值（Reset URL rewriter values）
- ob_flush() - 冲刷出（送出）输出缓冲区中的内容
- ob_list_handlers() - 列出所有使用的输出处理程序
- url_rewriter.tags
- url_rewriter.hosts
- session.trans_sid_tags
- session.trans_sid_hosts