Status
This library is under construction.
Description
A Nginx module which tries to implement proxy wasm ABI in Nginx.
Install dependencies
- Download the wasmtime C API package, see https://docs.wasmtime.dev/c-api/. Then rename it to
wasmtime-c-api/. Remember to add thewasmtime-c-api/libto the library search path when you build Nginx, for instance,
export wasm_prefix=/path/to/wasm-nginx-module/wasmtime-c-api
./configure ... \
--with-ld-opt="-Wl,-rpath,${wasm_prefix}/lib" \
Methods
load
syntax: plugin, err = proxy_wasm.load(path)
Load a .wasm file from the filesystem and return a WASM plugin.
local plugin, err = proxy_wasm.load("t/testdata/plugin_lifecycle/main.go.wasm")
on_configure
syntax: plugin_ctx, err = proxy_wasm.on_configure(plugin, conf)
Create a plugin ctx with the given plugin and conf.
local plugin, err = proxy_wasm.load("t/testdata/plugin_lifecycle/main.go.wasm")
if not plugin then
ngx.log(ngx.ERR, "failed to load wasm ", err)
return
end
local ctx, err = wasm.on_configure(plugin, '{"body":512}')
if not ctx then
ngx.log(ngx.ERR, "failed to create plugin ctx ", err)
return
end
proxy-wasm ABI
Implemented proxy-wasm ABI can be found in proxy_wasm_abi.
1.3k Jan 4, 2023
1.4k Dec 31, 2022
2 Dec 11, 2021
784 Jan 6, 2023
538 Dec 23, 2022
43 Mar 1, 2022
12 Oct 27, 2022
26 Nov 25, 2022
8 Nov 3, 2022
9 Dec 8, 2022
1.3k Dec 26, 2022
85 Nov 25, 2022
1 Nov 12, 2022
888 Dec 30, 2022
227 Jan 5, 2023
1 May 28, 2022
143 Dec 8, 2022
133 Dec 29, 2022