apache_note
(PHP 4, PHP 5, PHP 7, PHP 8)
apache_note — Obtêm e configura notas de requisição
Descriçã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.
Parâmetros
note_name-
O nome da nota.
note_value-
O valor da nota.
Valor Retornado
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.
Registro de Alterações
| Versão | Descrição |
|---|---|
| 8.0.0 |
note_value agora permite null.
|
Exemplos
Example #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);
Example #2 Logar valores no access.log
<?php
apache_note('sessionID', session_id());
?># "%{sessionID}n" pode ser utilizado numa diretiva LogFormat