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.
(PHP 4, PHP 5, PHP 7, PHP 8)
apache_note — Affiche ou affecte la table des notes d'Apache
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
requête. 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 requête.
note_name
Le nom de la note.
note_value
La valeur de la note.
Si note_value
est omis ou null
, elle renvoie
la valeur courante de la variable note_name
. Sinon,
elle affecte à la note note_name
la valeur note_value
et elle
retournera la valeur précédente de la variable note_name
.
Si la note ne peut être récupérée, false
est retourné.
Version | Description |
---|---|
8.0.0 |
note_value est désormais nullable.
|
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
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.