Go to file
Bruno Oliveira 38ef6b73f5 feat: add support for the HTTP QUERY method (RFC 10008)
QUERY (RFC 10008, June 2026; registered in the IANA HTTP Method Registry) is
safe and idempotent like GET but carries a request body like POST. It is wired
through exactly like PATCH:

- actix-web: `guard::Query()`, `web::query()`, `Resource::query()`, and
  `TestRequest::query()`
- actix-web-codegen: `#[query]` routing macro (plus re-export from actix-web)

`http` 0.2 has no `Method::QUERY` constant, so the method is built with
`Method::from_bytes(b"QUERY").unwrap()`, with a TODO to switch to the constant
once the `http` dependency is bumped (#3384). No dependency changes.
`actix-http` needs no change (it uses `http::Method` directly).

Tests mirror the existing PATCH coverage and add a body-carrying QUERY test.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-07 19:05:40 -03:00
.github chore: bump actions (#4133) 2026-07-04 10:21:16 +09:00
actix-files fix(files): fix panic in `Files` containing `.` (#4083) 2026-05-28 07:33:25 +01:00
actix-http fix(http): fix sending responses for upgraded ones on WS (#4117) 2026-06-22 20:34:45 +09:00
actix-http-test build(deps): bump time from 0.3.45 to 0.3.46 (#3893) 2026-01-28 08:10:27 +00:00
actix-multipart test(multipart,derive): move trybuild tests (#4028) 2026-06-21 13:51:22 +09:00
actix-multipart-derive test(multipart,derive): move trybuild tests (#4028) 2026-06-21 13:51:22 +09:00
actix-router chore: upgrade `criterion` to 0.8 (#4045) 2026-04-25 20:08:11 +09:00
actix-test build(deps): bump time from 0.3.45 to 0.3.46 (#3893) 2026-01-28 08:10:27 +00:00
actix-web feat: add support for the HTTP QUERY method (RFC 10008) 2026-07-07 19:05:40 -03:00
actix-web-actors build(deps): bump time from 0.3.45 to 0.3.46 (#3893) 2026-01-28 08:10:27 +00:00
actix-web-codegen feat: add support for the HTTP QUERY method (RFC 10008) 2026-07-07 19:05:40 -03:00
awc fix(http): fix sending responses for upgraded ones on WS (#4117) 2026-06-22 20:34:45 +09:00
docs/graphs bump actix-codec to 0.5 2022-02-15 20:49:10 +00:00
scripts chore: add multi-crate publish script 2025-08-26 09:25:22 +01:00
.clippy.toml chore(actix-http): prepare release 3.11.1 2025-08-26 07:28:27 +01:00
.codecov.yml chore: move codecov file 2023-08-03 06:28:45 +01:00
.cspell.yml refactor: init hickory DNS using OnceCell 2025-09-09 09:03:09 +01:00
.gitignore chore: check in lockfile 2025-03-21 05:51:45 +00:00
.prettierrc.yml format project 2024-01-10 04:00:20 +00:00
.rustfmt.toml apply standard formatting 2023-07-17 02:38:12 +01:00
.taplo.toml chore(actix-http): prepare release 3.11.0 2025-05-10 06:18:25 +01:00
CHANGES.md prepare releases: actix-http 3.0.0 and actix-web 4.0.0 (#2663) 2022-02-25 18:46:35 +00:00
CODE_OF_CONDUCT.md use dash hyphenation in markdown 2021-12-22 08:21:30 +00:00
Cargo.lock build(deps): bump time from 0.3.49 to 0.3.51 (#4131) 2026-07-01 09:52:25 +00:00
Cargo.toml chore: drop actors from workspace (#3943) 2026-02-18 22:09:29 +00:00
LICENSE-APACHE the big three point oh (#1668) 2020-09-11 13:50:10 +01:00
LICENSE-MIT update year in MIT license (#2143) 2021-04-09 01:28:35 +01:00
README.md move actix-web to own dir 2022-02-01 00:30:41 +00:00
deny.toml chore: address deny warning (#4040) 2026-04-22 23:44:18 +09:00
justfile fix: exclude dependencies from doc tests (#3882) 2026-01-12 01:44:00 +00:00
zizmor.yml chore: use zizmor to harden GHA usage (#4054) 2026-04-29 14:52:36 +00:00

README.md

Actix Web

Actix Web is a powerful, pragmatic, and extremely fast web framework for Rust

crates.io Documentation MSRV MIT or Apache 2.0 licensed Dependency Status
CI codecov downloads Chat on Discord

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 awc HTTP 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.

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

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:

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.