Benchmarking

ReqShield includes a PhpBench benchmark suite for validator throughput and latency profiles.

Run Benchmark

Use Composer:

composer ic:benchmark
composer ic:bench:quick

This runs the PhpBench suite in:

• benchmarks/ValidatorBench.php

• benchmarks/ResolverBench.php

What It Measures

Current benchmark scenarios:

• flat-fast-rules (flat payload, mostly cheap rules)

• nested-wildcard (nested payload with wildcard path expansion)

• db-heavy-batched (database-backed rules using batched execution)

• resolver-enum-resolve (BuiltinRule::resolve() token lookup)

• resolver-compiler-cached (cached compiler rule-class resolution)

• resolver-token-map-lookup (direct token-to-class map lookup)

Output Metrics

Each scenario reports:

• revs (revolutions per iteration)

• its (iterations)

• mem_peak

• mode (dominant execution time)

• rstdev (relative standard deviation)

Output Format

PhpBench prints aggregate timing and memory reports per benchmark subject.