output_add_rewrite_var 函数

适用 PHP 版本

PHP 5.3.0 及以上版本

函数说明

output_add_rewrite_var 函数用于向所有由输出缓冲机制生成的 URL 中自动添加指定的 GET 参数。这对于在整个页面的所有 URL 中统一添加参数（例如会话 ID）非常有用，无需手动修改每个链接。

函数语法

bool output_add_rewrite_var ( string $name , string $value )

参数

• $name：要添加的 GET 参数名称。
• $value：要添加的 GET 参数值。

返回值

成功时返回 TRUE，失败时返回 FALSE。

示例

<?php
// 启动输出缓冲
ob_start();
<p>// 添加 URL 参数 "sessionid=12345" 到输出的所有链接中<br>
output_add_rewrite_var('sessionid', '12345');</p>
<p>echo '<a href="page.php">链接到页面</a>';</p>
<p>// 发送输出并关闭缓冲<br>
ob_end_flush();<br>
?><br>

示例代码的说明

该示例中，调用 output_add_rewrite_var 后，所有由输出缓冲生成的 URL 都会自动附加上 sessionid=12345 这个 GET 参数。因此输出的链接实际为：

链接到页面

无需手动修改 HTML 代码中的链接，方便对整个页面进行统一的 URL 参数注入。