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 — Obtêm e configura notas de requisição
Esta função chama as funções table_get
e
table_set
do Apache. Edita as tabelas de notas que existem
durante uma requisição. O objetivo das tabelas é permitir que os módulos do Apache
se comuniquem entre entre si.
O principal uso da função apache_note() é passar informações de um módulo para outro dentro da mesma requisição.
note_name
O nome da nota.
note_value
O valor da nota.
Se note_value
for omitido ou null
, retorna o valor atual da nota
note_name
. Se chamado com dois argumentos,
define o valor da nota note_name
para o valor
note_value
e retorna o valor anterior da
nota note_name
.
Se a nota não puder ser retornada false
é retornado.
Versão | Descrição |
---|---|
8.0.0 |
note_value agora permite null.
|
Exemplo #1 Passando informações entre PHP e Perl
<?php
apache_note('name', 'Fredrik Ekengren');
// Chama o script perl
virtual("/perl/some_script.pl");
$result = apache_note("resultdata");
?>
# Obtém o objeto request do Apache my $r = Apache->request()->main(); # Obtém o dado repassado my $name = $r->notes('name'); # algum processamento # Devolce o resultado ao PHP $r->notes('resultdata', $result);
Exemplo #2 Logar valores no access.log
<?php
apache_note('sessionID', session_id());
?>
# "%{sessionID}n" pode ser utilizado numa diretiva 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.