Aller au contenu

ctxdump: Stasher et appliquer l'ancien ngx.ctx pour éviter d'être détruit après qu'une redirection interne NGINX se soit produite

Installation

Si vous n'avez pas configuré l'abonnement au dépôt RPM, inscrivez-vous. Ensuite, vous pouvez procéder avec les étapes suivantes.

CentOS/RHEL 7 ou Amazon Linux 2

yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install lua-resty-ctxdump

CentOS/RHEL 8+, Fedora Linux, Amazon Linux 2023

dnf -y install https://extras.getpagespeed.com/release-latest.rpm
dnf -y install lua5.1-resty-ctxdump

Pour utiliser cette bibliothèque Lua avec NGINX, assurez-vous que nginx-module-lua est installé.

Ce document décrit lua-resty-ctxdump v0.1 publié le 7 janvier 2021.

location /t1 {
    set $ctx_ref = "";
    content_by_lua_block {
         local ctxdump = require "resty.ctxdump"
         ngx.ctx = {
             Date = "Wed May  3 15:18:04 CST 2017",
             Site = "unknown"
        }
        ngx.var.ctx_ref = ctxdump.stash_ngx_ctx()
        ngx.exec("/t2")
    }
}

location /t2 {
    internal;
    content_by_lua_block {
         local ctxdump = require "resty.ctxdump"
         ngx.ctx = {
             Date = "Wed May  3 15:18:04 CST 2017",
             Site = "unknown"
        }
        ngx.ctx = ctxdump.apply_ngx_ctx(ngx.var.ctx_ref)
        ngx.say("Date: " .. ngx.ctx["Date"] .. " Site: " .. ngx.ctx["Site"])
    }
}

Méthodes

stash_ngx_ctx

syntax: ref = stash_ngx_ctx()
phase: *init_worker_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*

Référence le ngx.ctx, retourne une ancre (une nouvelle référence maintenue par lua-resty-ctxdump).

Note : stash_ngx_ctx et apply_ngx_ctx doivent être appelés par paires, sinon une fuite de mémoire se produira ! Voir apply_ngx_ctx.

apply_ngx_ctx

syntax: old_ngx_ctx = apply_ngx_ctx(ref)
phase: *init_worker_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*, balancer_by_lua*

Récupère l'ancien ngx.ctx avec l'ancre retournée par stash_ngx_ctx. Après cela, l'ancre ne sera plus fonctionnelle.

Note : stash_ngx_ctx et apply_ngx_ctx doivent être appelés par paires, sinon une fuite de mémoire se produira ! Voir stash_ngx_ctx.

Voir Aussi

GitHub

Vous pouvez trouver des conseils de configuration supplémentaires et de la documentation pour ce module dans le dépôt GitHub pour nginx-module-ctxdump.