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