apache_note

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

apache_note — Obtê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

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.