apache_note
(PHP 4, PHP 5, PHP 7)
apache_note — Возвращает и устанавливает уведомления к запросу Apache
Описание
$note_name
, string|null $note_value = null
) : string|false
Эта функция является оберткой для table_get и
table_set. С её помощью можно редактировать таблицу уведомлений
(apache notes table), которая создаётся во время передачи запроса.
Таблица уведомлений позволяет модулям Apache обмениваться данными.
Основное назначение apache_note() - передавать информацию из одного модуля в другой внутри одного запроса.
Список параметров
-
note_name -
Название уведомления.
-
note_value -
Значение уведомления.
Возвращаемые значения
Если note_value опущен или null, функция возвращает текущее значение
уведомления note_name. В противном случае,
она устанавливает значение уведомления
note_name в note_value
и возвращает предыдущее значение note_name.
Если значение уведомления не может быть получено, будет возвращено false.
Список изменений
| Версия | Описание |
|---|---|
| 8.0.0 |
note_value теперь допускает значение null.
|
Примеры
Пример #1 Пример передачи информации между PHP и Perl
<?php
apache_note('name', 'Fredrik Ekengren');
// Вызов perl-скрипта
virtual("/perl/some_script.pl");
$result = apache_note("resultdata");
?>
# Получаем объект запроса Apache
my $r = Apache->request()->main();
# Получаем переданные данные
my $name = $r->notes('name');
# Некоторые действия с данными
# Передача результата назад в PHP
$r->notes('resultdata', $result);
Пример #2 Пример записи значений в access.log
<?php
apache_note('sessionID', session_id());
?>
# "%{sessionID}n" может быть использован в директиве LogFormat