Struct MiddlewareBuilder 

pub struct MiddlewareBuilder { /* private fields */ }

中间件链构建器

持有 MiddlewareChain（顺序定义）+ 5 个 Option<Config>（各中间件配置）， 通过 apply() 方法一次性应用到 axum::Router。

字段说明

字段	类型	说明
chain	MiddlewareChain	中间件顺序定义（业务期望顺序，首元素最先执行）
cors	Option<CorsLayer>	CORS Layer（基于 tower-http::cors，可直接应用）
log	Option<LogConfig>	Log 中间件配置
auth	Option<AuthConfig>	Auth 中间件配置
rate_limit	Option<RateLimitConfig>	RateLimit 中间件配置
trace	Option<TraceConfig>	Trace 中间件配置

Implementations

impl MiddlewareBuilder

pub fn new() -> Self

创建空构建器（无中间件，无 Config）

pub fn default_builder() -> Self

创建默认构建器（使用 DEFAULT_ORDER，但所有 Config 为 None）

调用方需通过 with_xxx() 方法显式设置 Config，否则 apply() 会跳过该中间件。

pub fn php_global_builder() -> Self

创建 PHP 全局构建器（使用 PHP_GLOBAL_ORDER，对齐 app/middleware.php）

包含 Trace + Cors 两个中间件，对齐 PHP app/middleware.php 返回的全局中间件顺序。 默认设置 cors 字段为 Some(cors_layer())，调用方可通过 with_cors() 覆盖。

pub fn with_chain(self, chain: MiddlewareChain) -> Self

设置中间件链（替换现有链）

pub fn with_cors(self, layer: CorsLayer) -> Self

设置 CORS Layer

pub fn with_log(self, config: LogConfig) -> Self

设置 Log 配置

pub fn with_auth(self, config: AuthConfig) -> Self

设置 Auth 配置

pub fn with_rate_limit(self, config: RateLimitConfig) -> Self

设置 RateLimit 配置

pub fn with_trace(self, config: TraceConfig) -> Self

设置 Trace 配置

pub fn remove_kind(&mut self, kind: MiddlewareKind) -> usize

从链中移除所有指定类型的中间件（同时清除对应 Config）

返回被移除的中间件数量（仅链中数量，不包括 Config）。

pub fn remove_from(&mut self, kind: MiddlewareKind) -> usize

从链中移除指定类型及之后的所有中间件（含指定类型）

用于「公开 API 跳过 Auth 及之后中间件」场景。 返回被移除的中间件数量；若 kind 不存在则不移除任何中间件，返回 0。

pub fn chain(&self) -> &MiddlewareChain

返回中间件链引用

pub fn cors(&self) -> Option<&CorsLayer>

返回 CORS Layer 引用

pub fn log(&self) -> Option<&LogConfig>

返回 Log 配置引用

pub fn auth(&self) -> Option<&AuthConfig>

返回 Auth 配置引用

pub fn rate_limit(&self) -> Option<&RateLimitConfig>

返回 RateLimit 配置引用

pub fn trace(&self) -> Option<&TraceConfig>

返回 Trace 配置引用

pub fn is_enabled(&self, kind: MiddlewareKind) -> bool

判断指定中间件是否已启用（链中包含且 Config 已设置）

注意：Cors 的 Config 是 CorsLayer（必为 Some 才视为已启用）。

pub fn apply(self, router: Router) -> Router

应用所有中间件到 axum::Router

按 chain.service_builder_order()（业务期望顺序的逆序）遍历调用 Router::layer， 保证业务期望顺序（chain.order()）与实际执行顺序一致（Router::layer 后注册先执行）。

链中包含但 Config 未设置的中间件会被跳过（不应用）。

消耗语义

此方法消耗 self（取出 Config 的所有权），返回应用了中间件的 Router。

Trait Implementations

impl Clone for MiddlewareBuilder

fn clone(&self) -> MiddlewareBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MiddlewareBuilder

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

Formats the value using the given formatter.

impl Default for MiddlewareBuilder

fn default() -> Self

Returns the “default value” for a type.

impl Display for MiddlewareBuilder

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

Formats the value using the given formatter.