PHP: apache_note - Manual

downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

apache_request_headers apache_lookup_uri

Last updated: Fri, 26 Jan 2007

view this page in

# apache_note

(PHP 3 >= 3.0.2, PHP 4, PHP 5)

apache_note -- Установить и получить аннотации к запросу Apache

## Описание

string apache_note ( string note_name [, string note_value] )

Функция apache_note() является специфичной для сервера Apache, которая получает и устанавливает значения в таблице `notes` запроса.

## Список параметров

`note_name`

  Название аннотации.

`note_value`

  Значение аннотации.

## Возвращаемые значения

Если функция вызывается с одним аргументом, она возвращает текущее значение аннотации `note_name`. Если функция вызывается с двумя аргументами, она устанавливает значение аннотации `note_name` в `note_value` и возвращает предыдущее значение аннотации `note_name`. Если значение аннотации не может быть получено, будет возвращено `FALSE`.

add a note User Contributed Notes
apache_note
ckm at NOSPAM dot crust dot net
16-Oct-2001 01:52
`apache_note() does not work on requests to a symlink, only on actual files. Eg. if index.php is symlinked to login.php, then any apache_note() in login.php will not be available to other apache modules such as logging.`
nathan at thelinuxcommunity dot org
06-Sep-2001 12:25
`Used this with mod_layout... very handy. :) Used my PHP code in my header to check session variables and validate the session. If the session is not valid, I use apache_note to tell mod_layout not to display the content page or the footer, just the error page I generate in the header page.
Note: successive calls to apache_note with the same KEY overwrite the VALUE. Ie:
apache_note("LAYOUT","originoff");
apache_note("LAYOUT","footeroff");
Will only send the last note. You need to do something like:
apache_note("LAYOUT","originoff");
apache_note("LAYOUT-2","footeroff");
To get both variables through. How you retrieve this is obviously up to the module receiving notes, of course...
--Nathan`
fredrik dot ekengren at mandarinen dot se
24-Jul-2001 04:45
`In a project I was involved in, we needed to pass data from mod_php4 to mod_perl. We used apache_note() to do the work for us.
It took a little while to figure it out, but here's some sample code that could help anyone with the same problem.
From PHP file:
<?
apache_note("name", $HTTP_COOKIE_VARS["User"]);
// Put all post variables into apache notes
while (list($key,$value) = each($HTTP_POST_VARS))
apache_note($key, $value);
// Call perl script
virtual("/perl/some_script.pl");
$result = apache_note("resultdata");
?>
From Perl file:
# Get Apache request object
my $r = Apache->request()->main();
# Get passed data
my $name = $r->notes('name');
my $more_data = $r->notes('more_data');
# some processing
# Pass result back to PHP
$r->notes('resultdata', $result);
// Fredrik`
leon at leonatkinson dot com
11-Sep-1999 03:48
`This function is a wrapper for Apache's table_get and table_set. It
edits the table of notes that exists during a request. The table's
purpose is to allow Apache modules to communicate. Here are some
further details I found in the mailing list archives:
<P>
Rasmus wrote:
<P>
The main use for apache_note() is to pass information
from one module to another within the same request. I haven`t seen an
actual implementation that uses this yet, but it is quite possible for
someone to write a module which performs some sort of action at one of the
other stages of the request and stores some information in the Apache note
table which will then be available to PHP when the request reaches the
content-handling stage. Or, one could have a logging module that reads
something from the Apache Note table set by PHP.
<P>
David Sklar wrote:
<P>You can use it to facilitate communication between modules that act on the
request at different stages. I use it to record userids in logfiles. In
some PHP that gets auto_prepend-ed, I do a
<P>
apache_note(`sessionID`,$sessionID);
<P>
(where $sessionID has been slurped out of a cookie and processed)
<P>
and then, in my httpd.conf, part of my LogFormat is
<P>
"%{sessionID}n"
<P>
so that sessionID gets written to the logfile.
<P>
If you have other modules that process the request before or after PHP
does (authentication, fixups, whatever..) you can have them talk to PHP or
PHP talk to them through the notes table.`
add a note
apache_request_headers apache_lookup_uri

Last updated: Fri, 26 Jan 2007
show source | credits | stats | sitemap | contact | advertising | mirror sites
Copyright © 2001-2007 The PHP Group
All rights reserved.
This mirror generously provided by: Yahoo! Inc.
Last updated: Sat Mar 10 09:32:46 2007 PST