1
0
mirror of https://github.com/actix/actix-website synced 2024-11-30 11:12:57 +01:00
actix-website/docs/whatis.md

27 lines
1.5 KiB
Markdown
Raw Normal View History

2018-05-22 23:15:08 +02:00
---
2022-02-26 05:50:39 +01:00
title: What is Actix Web
2018-05-22 23:15:08 +02:00
---
import { rustVersion } from "@site/vars";
2018-05-22 23:15:08 +02:00
2022-02-26 05:50:39 +01:00
# Actix Web is part of an Ecosystem of Crates
2020-09-12 17:21:54 +02:00
2022-02-26 05:44:58 +01:00
Long ago, Actix Web was built on top of the `actix` actor framework. Now, Actix Web is largely unrelated to the actor framework and is built using a different system. Though `actix` is still maintained, its usefulness as a general tool is diminishing as the futures and async/await ecosystem matures. At this time, the use of `actix` is only required for WebSocket endpoints.
2020-09-12 17:21:54 +02:00
2022-02-26 05:44:58 +01:00
We call Actix Web a powerful and pragmatic framework. For all intents and purposes it's a micro-framework with a few twists. If you are already a Rust programmer you will probably find yourself at home quickly, but even if you are coming from another programming language you should find Actix Web easy to pick up.
2020-09-12 17:21:54 +02:00
2021-01-17 17:58:25 +01:00
<!-- TODO -->
<!-- actix-extras -->
2022-02-26 05:44:58 +01:00
An application developed with Actix Web will expose an HTTP server contained within a native executable. You can either put this behind another HTTP server like nginx or serve it up as-is. Even in the complete absence of another HTTP server Actix Web is powerful enough to provide HTTP/1 and HTTP/2 support as well as TLS (HTTPS). This makes it useful for building small services ready for production.
2018-05-22 23:15:08 +02:00
<p>
Most importantly: Actix Web runs on Rust { rustVersion } or later and it works with stable releases.
</p>
2020-09-12 17:21:54 +02:00
<!-- TODO -->
<!-- which is built upon the fantastic [Tokio][tokio] asynchronous I/O system -->
<!-- LINKS -->
[tokio]: https://tokio.rs