Struct FastCgiRequest 

pub struct FastCgiRequest {
    pub request_id: u16,
    pub role: Role,
    pub keep_conn: bool,
    pub params: Vec<(Bytes, Bytes)>,
    pub stdin: FastCgiBody,
    pub data: FastCgiBody,
}

Available on crate feature fastcgi only.

A complete FastCGI request received from a web server.

The FastCgiServer assembles this from the FCGI_BEGIN_REQUEST, FCGI_PARAMS, FCGI_STDIN, and (for Role::Filter) FCGI_DATA records before passing it to the inner service.

Roles

• Role::Responder: params contains the CGI environment, stdin contains the request body. data is empty.
• Role::Authorizer: params contains the CGI environment. stdin and data are empty. The inner service decides allow/deny via the HTTP status code in its FastCgiResponse stdout — 200 means allowed; any other status is returned to the client as the denial response.
• Role::Filter: params contains the CGI environment (including FCGI_DATA_LAST_MOD and FCGI_DATA_LENGTH), stdin contains the request body, and data contains the raw file data to be filtered.

Fields

request_id: u16

Request ID assigned by the web server (1–65535).

role: Role

Role the web server expects the application to fulfil.

keep_conn: bool

If true, the web server wants to reuse the connection for further requests.

params: Vec<(Bytes, Bytes)>

CGI environment variables received via FCGI_PARAMS records.

Each entry is a (name, value) pair decoded from the FastCGI name-value encoding.

stdin: FastCgiBody

Streaming body data from FCGI_STDIN records.

Read via [AsyncRead][tokio::io::AsyncRead]. For the Authorizer role this stream is empty.

data: FastCgiBody

Streaming file data from FCGI_DATA records (Filter role only).

Empty for Responder and Authorizer roles.

Implementations

impl FastCgiRequest

pub fn param(&self, name: &[u8]) -> Option<&[u8]>

Return the value of the CGI parameter named name, if present.

Trait Implementations

impl Debug for FastCgiRequest

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

Formats the value using the given formatter.

impl<S> Service<FastCgiRequest> for FastCgiHttpService<S>

where S: Service<Request, Output = Response>, <S as Service<Request>>::Error: Into<Box<dyn Error + Send + Sync>>,

type Output = FastCgiResponse

The type of the output returned by the service.

type Error = Box<dyn Error + Send + Sync>

The type of error returned by the service.

async fn serve( &self, req: FastCgiRequest, ) -> Result<<FastCgiHttpService<S> as Service<FastCgiRequest>>::Output, <FastCgiHttpService<S> as Service<FastCgiRequest>>::Error>

Serve an output or an error for the given input

fn boxed(self) -> BoxService<Input, Self::Output, Self::Error>

Box this service to allow for dynamic dispatch.