array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.apache-note.php', 1 => 'apache_note', 2 => 'Muestra o asigna la tabla de notas de Apache', ), 'up' => array ( 0 => 'ref.apache.php', 1 => 'Funciones de Apache', ), 'prev' => array ( 0 => 'function.apache-lookup-uri.php', 1 => 'apache_lookup_uri', ), 'next' => array ( 0 => 'function.apache-request-headers.php', 1 => 'apache_request_headers', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/apache/functions/apache-note.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

apache_note

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

apache_note — Muestra o asigna la tabla de notas de Apache

Descripción

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

Esta función es una abstracción de los comandos table_get y table_set de Apache. Edita la tabla de notas que existe durante una petición. El propósito de esta tabla es permitir que los módulos de Apache se comuniquen.

La utilidad de la función apache_note() es pasar información de un módulo a otro, durante la misma petición.

Parámetros

note_name

El nombre de la nota.

note_value

El valor de la nota.

Valores devueltos

Si note_value es omitido o null, devuelve el valor actual de la variable note_name. De lo contrario, asigna a la nota note_name el valor note_value y devolverá el valor anterior de la variable note_name. Si la nota no puede ser recuperada, false es devuelto.

Historial de cambios

Versión Descripción
8.0.0 note_value ahora es nullable.

Ejemplos

Ejemplo #1 Pasaje de información entre PHP y Perl

<?php

apache_note('name', 'Fredrik Ekengren');

// Llamada al script Perl
virtual("/perl/some_script.pl");

$result = apache_note("resultdata");
?>
# Recuperación del objeto de petición Apache
my $r = Apache->request()->main();

# Recuperación de los datos pasados
my $name = $r->notes('name');

# Procesamiento

# Envío del resultado hacia PHP
$r->notes('resultdata', $result);

Ejemplo #2 Valores de identificación en el archivo access.log

<?php

apache_note('sessionID', session_id());

?>
# "%{sessionID}n" puede ser utilizado en la directiva LogFormat

Ver también