Module transport 

Available on crate features fastcgi and transport only.

Turnkey FastCGI client transports.

These connectors implement Service<FastCgiClientRequest> and plug straight into FastCgiClient or FastCgiHttpClient — no custom connector wrapper required for the common cases.

Each connector also lets you stage CGI params (typically the php-fpm mandatory pair SCRIPT_FILENAME + DOCUMENT_ROOT) that get pushed onto the request’s params vec before it’s forwarded. There’s a php_fpm preset on each side that fills these for you.

Available behind the default-on transport feature.

Examples

Pointing rama at php-fpm over TCP:

use rama_fastcgi::client::transport::FastCgiTcpConnector;
use rama_fastcgi::FastCgiHttpClient;

let connector = FastCgiTcpConnector::php_fpm(
    "127.0.0.1:9000".parse().unwrap(),
    exec,
    "/var/www/index.php",
);
let client = FastCgiHttpClient::new(connector);

Over a Unix socket (Unix-family targets only):

use rama_fastcgi::client::transport::FastCgiUnixConnector;
use rama_fastcgi::FastCgiHttpClient;

let connector = FastCgiUnixConnector::php_fpm(
    "/run/php/php8.3-fpm.sock",
    "/var/www/index.php",
);
let client = FastCgiHttpClient::new(connector);

Advanced — explicit param injection (any backend, not just PHP):

use rama_fastcgi::client::transport::FastCgiTcpConnector;
use rama_fastcgi::proto::cgi;

let connector = FastCgiTcpConnector::new(addr, exec)
    .with_script_filename("/srv/app.py")
    .with_document_root("/srv")
    .with_param(cgi::REDIRECT_STATUS, "200");

Structs

FastCgiTcpConnector

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

FastCgiUnixConnector

Open a Unix-socket connection to a FastCGI backend (typically php-fpm at e.g. /run/php/php8.3-fpm.sock).