Struct FastCgiTcpConnector 

pub struct FastCgiTcpConnector { /* private fields */ }

Available on crate feature fastcgi only.

Open a TCP connection to a FastCGI backend (typically php-fpm at 127.0.0.1:9000).

Stages any with_param / with_script_filename / with_document_root values onto the FastCgiClientRequest::params vec just before forwarding to the inner HTTP-→-FastCGI conversion. The connector itself owns no per-request state, so it is cheap to clone.

See the module-level docs for usage examples and the Self::php_fpm preset.

Implementations

impl FastCgiTcpConnector

pub fn new(target: HostWithPort, exec: Executor) -> FastCgiTcpConnector

Available on crate feature transport only.

Create a bare TCP connector — no CGI params injected.

Use Self::php_fpm if you want SCRIPT_FILENAME and DOCUMENT_ROOT set automatically (the 90% case).

pub fn php_fpm( target: HostWithPort, exec: Executor, script: impl AsRef<Path>, ) -> FastCgiTcpConnector

Available on crate feature transport only.

Convenience constructor for the php-fpm common case: opens a TCP connection to target and injects SCRIPT_FILENAME = script plus DOCUMENT_ROOT = <parent dir of script>. Both params are required for php-fpm to route the request to the right script.

pub fn with_param( self, name: impl Into<Bytes>, value: impl Into<Bytes>, ) -> FastCgiTcpConnector

Available on crate feature transport only.

Push an arbitrary CGI param onto every request handled by this connector.

Use the cgi constants for spec-defined names:

use rama_fastcgi::client::transport::FastCgiTcpConnector;
use rama_fastcgi::proto::cgi;
let c = FastCgiTcpConnector::new(addr, exec)
    .with_param(cgi::SCRIPT_FILENAME, "/srv/app.php")
    .with_param(cgi::REDIRECT_STATUS, "200");

pub fn with_script_filename(self, path: impl AsRef<Path>) -> FastCgiTcpConnector

Available on crate feature transport only.

Stage SCRIPT_FILENAME for every request. See cgi::SCRIPT_FILENAME.

pub fn with_document_root(self, path: impl AsRef<Path>) -> FastCgiTcpConnector

Available on crate feature transport only.

Stage DOCUMENT_ROOT for every request. See cgi::DOCUMENT_ROOT.

Trait Implementations

impl Clone for FastCgiTcpConnector

fn clone(&self) -> FastCgiTcpConnector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FastCgiTcpConnector

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

Formats the value using the given formatter.

impl Service<FastCgiClientRequest> for FastCgiTcpConnector

type Output = EstablishedClientConnection<TcpStream, FastCgiClientRequest>

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, input: FastCgiClientRequest, ) -> Result<<FastCgiTcpConnector as Service<FastCgiClientRequest>>::Output, <FastCgiTcpConnector as Service<FastCgiClientRequest>>::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.