PHP Manual
Output Control 函数
添加URL重写器的值（Add URL rewriter values）

output_add_rewrite_var

(PHP 4 >= 4.3.0, PHP 5, PHP 7)

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(http://example.com/..)不能被重写。

此函数的行为由url_rewriter.tags php.ini 参数控制。

Note: 如果还没有活跃的输出缓冲区，调用此函数将隐式地开启它。

参数

name: 变量名。
value: 变量值。

返回值

成功时返回 TRUE，或者在失败时返回 FALSE。

范例

Example #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() - 列出所有使用中的输出处理程序。