(PHP 4、PHP 5、PHP 7、PHP 8)
apache_note — 获取和设置 apache 请求备注
此函数是 Apache 的 table_get 和 table_set 的包装器。它编辑请求期间存在的备注表。该表的目的是允许 Apache 模块进行通信。
apache_note() 的主要用途是在同一个请求中将信息从一个模块传递到另一个模块。
note_name备注的名称。
note_value备注的值。
如果省略 note_value 或为 null，它将返回备注 note_name 的当前值。否则，它将备注 note_name 的值设置为 note_value，并返回备注 note_name 的先前值。如果无法检索备注，则返回 false。
| 版本 | 描述 |
|---|---|
| 8.0.0 |
note_value 现在可以为空。 |
示例 #1 在 PHP 和 Perl 之间传递信息
<?php
apache_note('name', 'Fredrik Ekengren');
// 调用 perl 脚本
virtual("/perl/some_script.pl");
$result = apache_note("resultdata");
?># Get Apache request object
my $r = Apache->request()->main();
# Get passed data
my $name = $r->notes('name');
# some processing
# Pass result back to PHP
$r->notes('resultdata', $result);
示例 #2 在 access.log 中记录值
<?php
apache_note('sessionID', session_id());
?># "%{sessionID}n" can be used in the LogFormat directive