Actix web is a simple, pragmatic and extremely fast web framework for Rust.
- Supported HTTP/1.x and HTTP/2.0 protocols
- Streaming and pipelining
- Keep-alive and slow requests handling
- Client/server WebSockets support
- Transparent content compression/decompression (br, gzip, deflate)
- Configurable request routing
- Graceful server shutdown
- Multipart streams
- Static assets
- SSL support with OpenSSL or
native-tls
- Middlewares (Logger, Session, Redis sessions, DefaultHeaders, CORS, CSRF)
- Built on top of Actix actor framework
- User Guide
- API Documentation (Development)
- API Documentation (Releases)
- Chat on gitter
- Cargo package: actix-web
- Minimum supported Rust version: 1.21 or later
At the moment all examples are based on the actix-web master
branch.
[dependencies]
actix = "0.5"
actix-web = { git="https://github.com/actix/actix-web.git" }
extern crate actix_web;
use actix_web::{server, App, Path};
fn index(info: Path<(String, u32)>) -> String {
format!("Hello {}! id:{}", info.0, info.1)
}
fn main() {
server::new(
|| App::new()
.resource("/{name}/{id}/index.html", |r| r.with(index)))
.bind("127.0.0.1:8080").unwrap()
.run();
}
- Basics
- Stateful
- Protobuf support
- Multipart streams
- Simple websocket session
- Tera templates
- Diesel integration
- SSL / HTTP/2.0
- Tcp/Websocket chat
- Json
You may consider checking out this directory for more examples.
-
Some basic benchmarks could be found in this repository.
This project is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution to the actix-web crate is organized under the terms of the Contributor Covenant, the maintainer of actix-web, @fafhrd91, promises to intervene to uphold that code of conduct.