PHP Dokumentation: Function apache-note
12. Januar 2010 von werner
apache_note
(PHP 4, PHP 5)
apache_note — Setzt und liest Apache Request Notes
Beschreibung
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.
Parameter-Liste
- note_name
Der Name der Note.
- note_value
Der Wert der Note.
Rückgabewerte
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.
Beispiele
Beispiel #1 Übergeben von Informationen zwischen PHP und Perl
<?phpapache_note
('name', 'Fredrik Ekengren');// Perl-Skript aufrufen
virtual("/perl/some_script.pl");$result = apache_note("resultdata");
?># Hole das Apache Request Objektmy $r = Apache->request()->main();# Hole die übergebenen Datenmy $name = $r->notes('name');# beliebige Verarbeitung# Reiche das Ergebnis an PHP zurück$r->notes('resultdata', $result);Beispiel #2 Werte in access.log loggen
<?phpapache_note
('sessionID', session_id());?># "%{sessionID}n" kann in der LogFormat-Direktive verwendet werdenSiehe auch
- virtual() – Führt eine Apache-Unteranfrage durch