Skip to content

Latest commit

 

History

History
107 lines (83 loc) · 3.19 KB

index.md

File metadata and controls

107 lines (83 loc) · 3.19 KB

Examples

Documentation · Directives · API · Execution model · Security · Examples · Compatibility

Deployable RSS + NGINX snippets. Replace every /absolute/path/to/... placeholder before nginx -t.

Example Phase What it shows
Shared-dict fixed-window rate limiter access Typed SharedSafeStoreResult / incr, fail-closed 429
HMAC API-key authentication access ngx::hmac_sha1, header stripping, secret include
Async I/O → HTTP → SQLite → shared-dict → JSON content Policy grants, one HTTP allow pair, SQLite root, typed store result

Source files:

Minimal scripts

Import-free access script (runs to Halted, then the content phase):

let x = 1 + 2;

One sleep, then the content phase:

use ngx;
ngx::sleep(0.03);

Millisecond sleep for integer delays:

use ngx;
ngx::sleep_ms(30);

Read a request body in content_by_rss_file (nullary like OpenResty; get_post_args still takes an explicit argument for the max-args adaptation):

use ngx;
ngx::req::read_body();
let data = ngx::req::get_body_data().unwrap_or("");
ngx::say(data);

Replace the request body in content_by_rss_file (memory; set_body_file / builder APIs are in the request API):

use ngx;
ngx::req::read_body();
ngx::req::set_body_data("replacement");
ngx::say(ngx::req::get_body_data().unwrap_or(""));

Two sequential sleeps:

use ngx;
ngx::sleep(0.01);
ngx::sleep_ms(10);

UDP echo to a connected peer:

use ngx;
let sock = ngx::socket::udp();
ngx::socket::udp::settimeout(sock, 1000);
ngx::socket::udp::setpeername(sock, "127.0.0.1", 53);
ngx::socket::udp::send(sock, "ping");
ngx::socket::udp::receive(sock, ());
ngx::socket::udp::close(sock);

TCP echo to a connected peer:

use ngx;
let sock = ngx::socket::tcp();
ngx::socket::tcp::settimeout(sock, 1000);
ngx::socket::tcp::connect(sock, "127.0.0.1", 8080);
ngx::socket::tcp::send(sock, "ping");
ngx::socket::tcp::receive(sock, 4);
ngx::socket::tcp::close(sock);

TCP keepalive (worker-local pool) and TLS handshake (Tokio/rustls):

use ngx;
let sock = ngx::socket::tcp();
ngx::socket::tcp::settimeout(sock, 1000);
ngx::socket::tcp::connect(sock, "127.0.0.1", 8080);
let store = ngx::socket::tcp::trustedstore(ca_pem);
ngx::socket::tcp::settrustedstore(sock, store);
ngx::socket::tcp::sslhandshake(sock, (), "localhost", true, ());
ngx::socket::tcp::send(sock, "ping");
ngx::socket::tcp::receive(sock, 4);
ngx::socket::tcp::setkeepalive(sock, 60000, 30);