apache_note

(PHP 4, PHP 5, PHP 7, PHP 8)

apache_note取得或設(shè)置 apache 請(qǐng)求記錄

說(shuō)明

apache_note(string $note_name, ?string $note_value = null): string|false

這個(gè)函數(shù)是 Apache table_gettable_set 的包裝。 它編輯了請(qǐng)求中存在的 notes 表。 這個(gè)表的目的是允許 Apache 模塊進(jìn)行通訊。

apache_note() 的主要用途是在同一個(gè)請(qǐng)求中,從一個(gè)模塊傳遞信息到另一個(gè)模塊。

參數(shù)

note_name

note 名。

note_value

note 值。

返回值

如果 note_value 被省略或者為 null,則返回記錄 note_name 的當(dāng)前值。否則將記錄 note_name 的值設(shè)為 note_value 并返回記錄 note_name 的前一個(gè)值。如果未能獲取記錄,則返回 false

更新日志

版本 說(shuō)明
8.0.0 現(xiàn)在 note_value 可為 null。

范例

示例 #1 在 PHP 與 Perl 之間傳遞信息

<?php

apache_note
('name''Fredrik Ekengren');

// 調(diào)用 perl 腳本
virtual("/perl/some_script.pl");

$result apache_note("resultdata");
?>
# 獲取 Apache 請(qǐng)求對(duì)象
my $r = Apache->request()->main();

# 獲取傳遞的數(shù)據(jù)
my $name = $r->notes('name');

# 一些處理

# 將結(jié)果返回給 PHP
$r->notes('resultdata', $result);

示例 #2 在 access.log 中記錄值

<?php

apache_note
('sessionID'session_id());

?>
# "%{sessionID}n" can be used in the LogFormat directive

參見(jiàn)

  • virtual() - 執(zhí)行 Apache 子請(qǐng)求