Pular para conteúdo

ctxdump: Armazene e aplique o antigo ngx.ctx para evitar que seja destruído após a redireção interna do NGINX

Instalação

Se você ainda não configurou a assinatura do repositório RPM, inscreva-se. Em seguida, você pode prosseguir com os seguintes passos.

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

Para usar esta biblioteca Lua com o NGINX, certifique-se de que o nginx-module-lua está instalado.

Este documento descreve lua-resty-ctxdump v0.1 lançado em 07 de janeiro de 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étodos

stash_ngx_ctx

sintaxe: ref = stash_ngx_ctx()
fase: *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*

Referencie o ngx.ctx, retorna uma âncora (uma nova referência mantida pelo lua-resty-ctxdump).

Nota: stash_ngx_ctx e apply_ngx_ctx devem ser chamados em pares, caso contrário, ocorrerá um vazamento de memória! Veja apply_ngx_ctx.

apply_ngx_ctx

sintaxe: old_ngx_ctx = apply_ngx_ctx(ref)
fase: *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*

Recupera o antigo ngx.ctx com a âncora retornada de stash_ngx_ctx. Após isso, a âncora ficará fora de uso.

Nota: stash_ngx_ctx e apply_ngx_ctx devem ser chamados em pares, caso contrário, ocorrerá um vazamento de memória! Veja stash_ngx_ctx.

Veja Também

GitHub

Você pode encontrar dicas adicionais de configuração e documentação para este módulo no repositório do GitHub para nginx-module-ctxdump.