(PHP 4, PHP 5, PHP 7)
apache_note — Setzt und liest Apache Request Notes
$note_name
) : string$note_name
, string $note_value
) : string
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.
note_nameDer Name der Note.
note_valueDer 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