2022-02-01 01:30:41 +01:00
< div align = "center" >
< h1 > Actix Web< / h1 >
< p >
< strong > Actix Web is a powerful, pragmatic, and extremely fast web framework for Rust< / strong >
< / p >
< p >
[](https://crates.io/crates/actix-web)
2022-02-08 10:31:48 +01:00
[](https://docs.rs/actix-web/4.0.0-rc.3)
2022-02-01 01:30:41 +01:00
2022-02-08 10:31:48 +01:00
[](https://deps.rs/crate/actix-web/4.0.0-rc.3)
2022-02-01 01:30:41 +01:00
< br / >
[](https://github.com/actix/actix-web/actions/workflows/ci.yml)
[](https://codecov.io/gh/actix/actix-web)
[](https://discord.gg/NWpN5mmg3x)
< / p >
< / div >
## Features
- Supports _HTTP/1.x_ and _HTTP/2_
- Streaming and pipelining
- Powerful [request routing ](https://actix.rs/docs/url-dispatch/ ) with optional macros
- Full [Tokio ](https://tokio.rs ) compatibility
- Keep-alive and slow requests handling
- Client/server [WebSockets ](https://actix.rs/docs/websockets/ ) support
- Transparent content compression/decompression (br, gzip, deflate, zstd)
- Multipart streams
- Static assets
- SSL support using OpenSSL or Rustls
- Middlewares ([Logger, Session, CORS, etc](https://actix.rs/docs/middleware/))
2022-02-08 11:21:47 +01:00
- Integrates with the [`awc` HTTP client ](https://docs.rs/awc/ )
2022-02-01 01:30:41 +01:00
- Runs on stable Rust 1.54+
## Documentation
- [Website & User Guide ](https://actix.rs )
- [Examples Repository ](https://github.com/actix/examples )
- [API Documentation ](https://docs.rs/actix-web )
- [API Documentation (master branch) ](https://actix.rs/actix-web/actix_web )
## Example
Dependencies:
```toml
[dependencies]
actix-web = "4.0.0-rc.1"
```
Code:
```rust
use actix_web::{get, web, App, HttpServer, Responder};
#[get("/{id}/{name}/index.html")]
async fn index(params: web::Path< (u32, String)>) -> impl Responder {
let (id, name) = params.into_inner();
format!("Hello {}! id:{}", name, id)
}
#[actix_web::main] // or #[tokio::main]
async fn main() -> std::io::Result< ()> {
HttpServer::new(|| App::new().service(index))
.bind(("127.0.0.1", 8080))?
.run()
.await
}
```
2022-02-18 04:41:10 +01:00
### More Examples
- [Hello World ](https://github.com/actix/examples/tree/master/basics/hello-world )
- [Basic Setup ](https://github.com/actix/examples/tree/master/basics/basics )
- [Application State ](https://github.com/actix/examples/tree/master/basics/state )
- [JSON Handling ](https://github.com/actix/examples/tree/master/json/json )
- [Multipart Streams ](https://github.com/actix/examples/tree/master/forms/multipart )
- [Diesel Integration ](https://github.com/actix/examples/tree/master/databases/diesel )
- [SQLite Integration ](https://github.com/actix/examples/tree/master/databases/sqlite )
- [Postgres Integration ](https://github.com/actix/examples/tree/master/databases/postgres )
- [Tera Templates ](https://github.com/actix/examples/tree/master/templating/tera )
- [Askama Templates ](https://github.com/actix/examples/tree/master/templating/askama )
- [HTTPS using Rustls ](https://github.com/actix/examples/tree/master/https-tls/rustls )
- [HTTPS using OpenSSL ](https://github.com/actix/examples/tree/master/https-tls/openssl )
- [Simple WebSocket ](https://github.com/actix/examples/tree/master/websockets )
- [WebSocket Chat ](https://github.com/actix/examples/tree/master/websockets/chat )
You may consider checking out [this directory ](https://github.com/actix/examples/tree/master ) for more examples.
2022-02-01 01:30:41 +01:00
## Benchmarks
One of the fastest web frameworks available according to the [TechEmpower Framework Benchmark ](https://www.techempower.com/benchmarks/#section=data-r20&test=composite ).
## License
This project is licensed under either of the following licenses, at your option:
- Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or [http://www.apache.org/licenses/LICENSE-2.0])
- MIT license ([LICENSE-MIT](LICENSE-MIT) or [http://opensource.org/licenses/MIT])
## Code of Conduct
2022-02-18 04:41:10 +01:00
Contribution to the actix-web repo is organized under the terms of the Contributor Covenant. The Actix team promises to intervene to uphold that code of conduct.
