[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
[![crates.io](https://img.shields.io/crates/v/async-fcgi.svg)](https://crates.io/crates/async-fcgi)
[![Released API docs](https://docs.rs/async-fcgi/badge.svg)](https://docs.rs/async-fcgi)
[![GitHub](https://img.shields.io/github/license/User65k/async-fcgi)](./LICENSE)
![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/User65k/async-fcgi/rust.yml)

FastCGI implementation in pure Rust.

The focus is on the webserver/client side, but the application/server side could be added in the future.

Developed for [FlashRust Webserver](https://github.com/User65k/flash_rust_ws)
with focus on
- Vectorized IO and Zero Copy
- async IO / tokio
- easy [HTTP](https://crates.io/crates/http) interfaces

Tested with:
- Flup (Python)
- PHP

`cargo run --example webserver --features="con_pool"`

# Features

- [x] Handle UnixStream and TCPStream transparently
- [x] reconnect to the FCGI App if a connection is closed
- [x] Start an FCGI server (exec + env)
- [x] Support Key-Value Pairs bigger than maximum record size
- [x] "Full Duplex" connection to the FCGI Server/App (e.g stream STDIN and OUT at the same time)
- [ ] `con_pool` should handle more than one connection :sweat_smile: and load balance
- [ ] A dropped `FCGIBody` should not block a RequestID and cancel the request
- [ ] `Connection` should handle overload error from FCGI app
- [ ] Parsing for FCGI application/server side

PullRequests are welcome BTW

# Other FCGI Crates

|Crate|Description|Difference to this
|---|---|---|
| [fastcgi-client](https://crates.io/crates/fastcgi-client) | Async (tokio) client | Different API
| [fastcgi](https://crates.io/crates/fastcgi) | Synchronous Server | Synchronous. Only Server/App Side
| [fastcgi-sdk](https://crates.io/crates/fastcgi-sdk) | Bindings to the FastCGI SDK | Bindings
| [gfcgi](https://crates.io/crates/gfcgi) | abandoned | Only Server/App Side
| [fcgi](https://crates.io/crates/fcgi) | Bindings | yanked