PHP Velho Oeste 2024

apache_note

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

apache_noteObtêm e configura notas de requisição

Descrição

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

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

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

Veja Também

  • virtual() - Realiza uma sub-requisição Apache

add a note add a note

User Contributed Notes 1 note

up
0
ckm at NOSPAM dot crust dot net
22 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