(PHP 4, PHP 5)
apache_note — Affiche ou affecte le paramètre "apache request notes"
Cette fonction est une abstraction des commandes table_get et table_set d'Apache. Elle édite la table des notes qui existe lors d'une demande. Le but de cette table est de permettre aux modules Apache de communiquer.
L'utilité de la fonction apache_note() est de passer des informations d'un module vers un autre, durant la même demande.
Le nom de la note.
La valeur de la note.
Si la fonction est appelée avec un argument, elle renvoie la valeur courante de la variable note_name. Si apache_note() est appelée avec deux arguments, apache_note() affecte à la note note_name la valeur note_value et apache_note() retournera la valeur précédente de la variable note_name . Si la note ne peut être récupérée, FALSE est retourné.
Exemple #1 Passage d'informations entre PHP et Perl
<?php
apache_note('name', 'Fredrik Ekengren');
// Appel du script Perl
virtual("/perl/some_script.pl");
$result = apache_note("resultdata");
?>
# Récupération de l'objet de demande Apache
my $r = Apache->request()->main();
# Récupération des données passées
my $name = $r->notes('name');
# Des traitements
# Envoi du résultat vers PHP
$r->notes('resultdata', $result);
Exemple #2 Valeurs d'identification dans le fichier access.log
<?php
apache_note('sessionID', session_id());
?>
# "%{sessionID}n" peut être utilisé dans la directive LogFormat