Struct VhostMatcher 

pub struct VhostMatcher { /* private fields */ }

Virtual host matcher with O(1) exact matching and wildcard fallback.

Security features:

• Limits wildcard complexity (max 3 wildcards, 253 char limit)
• Sanitizes host headers (rejects null bytes, invalid chars)
• Case-insensitive matching via pre-normalization

Performance features (Phase 1):

• Uses Ascii<String> for case-insensitive keys (zero-allocation lookups)
• Uses ahash::RandomState for 2-3x faster HashMap operations

Implementations

impl VhostMatcher

pub fn new(sites: Vec<SiteConfig>) -> Result<Self, VhostError>

Creates a new VhostMatcher from site configurations.

Errors

Returns an error if:

• A wildcard pattern has too many wildcards
• A hostname exceeds the maximum length
• A wildcard pattern fails to compile

pub fn empty() -> Self

Create an empty matcher with no sites.

pub fn sanitize_host(host: &str) -> Result<String, VhostError>

Sanitizes and validates a host header value.

Security

• Rejects null bytes
• Rejects non-ASCII characters
• Strips port numbers
• Normalizes to lowercase

pub fn match_host(&self, host: &str) -> Option<&SiteConfig>

Matches a host header to a site configuration.

Arguments

• host - The raw Host header value

Returns

The matching site configuration, or None if no match found.

Performance

Uses Ascii::new() for zero-allocation case-insensitive lookup (PERF-P0-1)

pub fn sites(&self) -> &[SiteConfig]

Returns all configured sites.

pub fn site_count(&self) -> usize

Returns the number of configured sites.

Trait Implementations

impl Debug for VhostMatcher

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.