apache_note

(PHP 4, PHP 5, PHP 7)

apache_noteSetzt und liest Apache Request Notes

Beschreibung

apache_note ( string $note_name ) : string
apache_note ( 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.

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

<?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

Siehe auch

  • virtual() - Führt eine Apache-Unteranfrage durch