mirror of https://github.com/fafhrd91/actix-web
The existing docs stated middleware executes in 'opposite order as registration' without clarifying this only applies within a single level (App, Scope, or Resource). When middleware is registered at both the App level and a Scope level, App middleware *always* runs first because it structurally wraps the entire request router. Scope middleware cannot bypass or run before App middleware. Changes: - Qualify the 'opposite order' statement in middleware/mod.rs to note it applies within a single level only - Add a new 'Cross-Level Middleware Ordering' section with an ASCII diagram, explanation, and a code example showing the recommended per-scope pattern - Add a '# Middleware Ordering' note to App::wrap pointing to the new section Closes: https://github.com/actix/actix-web/issues/2993 |
||
|---|---|---|
| .github | ||
| actix-files | ||
| actix-http | ||
| actix-http-test | ||
| actix-multipart | ||
| actix-multipart-derive | ||
| actix-router | ||
| actix-test | ||
| actix-web | ||
| actix-web-actors | ||
| actix-web-codegen | ||
| awc | ||
| docs/graphs | ||
| scripts | ||
| .clippy.toml | ||
| .codecov.yml | ||
| .cspell.yml | ||
| .gitignore | ||
| .prettierrc.yml | ||
| .rustfmt.toml | ||
| .taplo.toml | ||
| CHANGES.md | ||
| CODE_OF_CONDUCT.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| LICENSE-APACHE | ||
| LICENSE-MIT | ||
| README.md | ||
| deny.toml | ||
| justfile | ||
README.md
Features
- Supports HTTP/1.x and HTTP/2
- Streaming and pipelining
- Powerful request routing with optional macros
- Full Tokio compatibility
- Keep-alive and slow requests handling
- Client/server 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)
- Integrates with the
awcHTTP client - Runs on stable Rust 1.88+
Experimental features
To enable faster release iterations, we mark some features as experimental.
These features are prefixed with experimental and a breaking change may happen at any release.
Please use them in a production environment at your own risk.
experimental-introspection: exposes route and method reporting helpers for local diagnostics and tooling. Seeexamples/introspection.rsandexamples/introspection_multi_servers.rs.
Documentation
Example
Dependencies:
[dependencies]
actix-web = "4"
Code:
use actix_web::{get, web, App, HttpServer, Responder};
#[get("/hello/{name}")]
async fn greet(name: web::Path<String>) -> impl Responder {
format!("Hello {name}!")
}
#[actix_web::main] // or #[tokio::main]
async fn main() -> std::io::Result<()> {
HttpServer::new(|| {
App::new().service(greet)
})
.bind(("127.0.0.1", 8080))?
.run()
.await
}
More Examples
- Hello World
- Basic Setup
- Application State
- JSON Handling
- Multipart Streams
- MongoDB Integration
- Diesel Integration
- SQLite Integration
- Postgres Integration
- Tera Templates
- Askama Templates
- HTTPS using Rustls
- HTTPS using OpenSSL
- Simple WebSocket
- WebSocket Chat
You may consider checking out this directory for more examples.
Benchmarks
One of the fastest web frameworks available according to the TechEmpower Framework Benchmark.
License
This project is licensed under either of the following licenses, at your option:
- 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])
Code of Conduct
Contribution to the actix/actix-web repo is organized under the terms of the Contributor Covenant. The Actix team promises to intervene to uphold that code of conduct.