apache_note

(PHP 4, PHP 5, PHP 7, PHP 8)

apache_noteAffiche ou affecte la table des notes d'Apache

Description

apache_note(string $note_name, ?string $note_value = null): string|false

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.

Liste de paramètres

note_name

Le nom de la note.

note_value

La valeur de la note.

Valeurs de retour

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é.

Historique

Version Description
8.0.0 note_value est désormais nullable.

Exemples

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

Voir aussi

  • virtual() - Effectue une sous-requête Apache

add a note add a note

User Contributed Notes 1 note

up
0
ckm at NOSPAM dot crust dot net
23 years ago
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.
To Top