core: Neue FFI-basierte API für lua-nginx-module

Installation

Wenn Sie das RPM-Repository-Abonnement noch nicht eingerichtet haben, melden Sie sich an. Dann können Sie mit den folgenden Schritten fortfahren.

CentOS/RHEL 7 oder 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-core

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

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

Um diese Lua-Bibliothek mit NGINX zu verwenden, stellen Sie sicher, dass nginx-module-lua installiert ist.

Dieses Dokument beschreibt lua-resty-core v0.1.32.post1, das am 13. Dezember 2025 veröffentlicht wurde.

Diese Bibliothek wird standardmäßig seit OpenResty 1.15.8.1 automatisch geladen. Dieses Verhalten kann über die lua_load_resty_core Direktive deaktiviert werden, aber beachten Sie, dass die Verwendung dieser Bibliothek dringend empfohlen wird, da ihre FFI-Implementierung sowohl schneller, sicherer als auch vollständiger ist als die Lua C API des ngx_lua Moduls.

Wenn Sie eine ältere Version von OpenResty verwenden, müssen Sie diese Bibliothek wie folgt laden:

    # nginx.conf

    http {
        # Sie müssen die folgende Zeile NICHT konfigurieren, wenn Sie
        # das OpenResty-Paket 1.4.3.9+ verwenden.
        init_by_lua_block {
            require "resty.core"
            collectgarbage("collect")  -- nur um Müll zu sammeln
        }

        ...
    }

Beschreibung

Diese reine Lua-Bibliothek implementiert einen Teil der ngx_lua Moduls Nginx API für Lua mit LuaJIT FFI und installiert die neue FFI-basierte Lua API in die ngx. und ndk. Namensräume, die vom ngx_lua Modul verwendet werden.

Darüber hinaus implementiert diese Lua-Bibliothek alle wesentlichen neuen Lua APIs des ngx_lua Moduls als ordnungsgemäße Lua-Module, wie ngx.semaphore und ngx.balancer.

Die FFI-basierte Lua API kann mit dem JIT-Compiler von LuaJIT arbeiten. Die Standard-API von ngx_lua basiert auf der standardmäßigen Lua C API, die niemals JIT kompiliert wird, und der Benutzer-Lua-Code wird immer interpretiert (langsam).

Die Unterstützung für das neue ngx_stream_lua_module hat ebenfalls begonnen.

Diese Bibliothek wird standardmäßig mit dem OpenResty-Paket ausgeliefert. Sie müssen sich also wirklich keine Sorgen um die Abhängigkeiten und Anforderungen machen.

Voraussetzungen

WARNUNG Diese Bibliothek ist in jeder OpenResty-Version enthalten. Sie sollten die gebündelte Version dieser Bibliothek in der speziellen OpenResty-Version verwenden, die Sie verwenden. Andernfalls können Sie auf ernsthafte Kompatibilitätsprobleme stoßen.

LuaJIT 2.1 (vorerst ist es der v2.1 Git-Zweig im offiziellen luajit-2.0 Git-Repository: http://luajit.org/download.html)
ngx_http_lua_module v0.10.25.
ngx_stream_lua_module v0.0.13.
lua-resty-lrucache

Implementierte API

resty.core.hash

resty.core.base64

resty.core.uri

resty.core.regex

resty.core.exit

ngx.exit

resty.core.shdict

resty.core.var

ngx.var.VARIABLE

resty.core.ctx

ngx.ctx

get_ctx_table

syntax: ctx = resty.core.ctx.get_ctx_table(ctx?)

Ähnlich wie ngx.ctx, aber es akzeptiert ein optionales ctx Argument. Es wird das ctx vom Aufrufer verwenden, anstatt eine neue Tabelle zu erstellen, wenn die ctx Tabelle nicht existiert.

Hinweis: Die ctx Tabelle wird im gesamten Lebenszyklus der aktuellen Anfrage verwendet. Bitte seien Sie sehr vorsichtig, wenn Sie versuchen, die ctx Tabelle wiederzuverwenden. Sie müssen sicherstellen, dass kein Lua-Code die ctx Tabelle in der aktuellen Anfrage verwendet oder verwenden wird, bevor Sie die ctx Tabelle an anderer Stelle wiederverwenden.

resty.core.request

resty.core.response

ngx.header.HEADER

resty.core.misc

resty.core.time

resty.core.worker

resty.core.phase

ngx.get_phase

resty.core.ndk

ndk.set_var

resty.core.socket

resty.core.param

ngx.arg (nur Getter)

ngx.semaphore

Dieses Lua-Modul implementiert eine Semaphore-API für eine effiziente "Light-Thread"-Synchronisation, die über verschiedene Anfragen hinweg funktionieren kann (aber nicht über nginx-Worker-Prozesse hinweg).