(PHP 4, PHP 5)
apache_note — Setzt und liest Apache Request Notes
Diese Funktion ist ein Wrapper für das table_get und table_set von Apache. Sie editiert die Notestabelle, die während eines Requests existiert. Der Sinn dieser Tabelle ist es, die Kommunikation zwischen Apachemodulen zu ermöglichen.
Der primäre Anwendungsfall für apache_note() ist die Übergabe von Informationen von einem Modul an ein anderes während der Abarbeitung eines bestimmten Requests.
Der Name der Note.
Der Wert der Note.
Wenn die Funktion mit einem Argument aufgerufen wird, gibt sie den aktuellen Wert der Note note_name zurück. Wird sie mit zwei Argumenten aufgerufen, setzt sie den Wert der Note note_name auf note_value und gibt den vorigen Wert der Note note_name zurück. Wenn die Note nicht angesprochen werden kann, wird FALSE zurückgegeben.
Beispiel #1 Übergeben von Informationen zwischen PHP und Perl
<?php
apache_note('name', 'Fredrik Ekengren');
// Perl-Skript aufrufen
virtual("/perl/some_script.pl");
$result = apache_note("resultdata");
?>
# Hole das Apache Request Objekt my $r = Apache->request()->main(); # Hole die übergebenen Daten my $name = $r->notes('name'); # beliebige Verarbeitung # Reiche das Ergebnis an PHP zurück $r->notes('resultdata', $result);
Beispiel #2 Werte in access.log loggen
<?php
apache_note('sessionID', session_id());
?>
# "%{sessionID}n" kann in der LogFormat-Direktive verwendet werden
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.