2018-05-22 23:15:08 +02:00
|
|
|
---
|
|
|
|
title: What is Actix
|
|
|
|
menu: docs_intro
|
|
|
|
weight: 100
|
|
|
|
---
|
|
|
|
|
2021-01-17 17:58:25 +01:00
|
|
|
# Actix is an Ecosystem of Crates
|
2020-09-12 17:21:54 +02:00
|
|
|
|
2021-01-17 17:58:25 +01:00
|
|
|
Long ago, `actix-web` was built on top of `actix`, a powerful and fast actor system.
|
|
|
|
Now, `actix-web` is largely unrelated to the actor framework and is built using a different system.
|
2021-02-26 18:25:30 +01:00
|
|
|
Though `actix` is still maintained, its usefulness as a general tool is diminishing as the
|
2021-03-31 15:54:44 +02:00
|
|
|
futures and async/await ecosystem matures. At this time, the use of `actix` is only required for
|
2021-01-17 17:58:25 +01:00
|
|
|
WebSocket endpoints.
|
2020-09-12 17:21:54 +02:00
|
|
|
|
2021-01-17 17:58:25 +01:00
|
|
|
We call `actix-web` a powerful and pragmatic framework. For all intents and purposes it's a
|
2020-09-12 17:21:54 +02:00
|
|
|
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.
|
|
|
|
|
2021-01-17 17:58:25 +01:00
|
|
|
<!-- TODO -->
|
|
|
|
<!-- actix-extras -->
|
|
|
|
|
2020-09-12 17:21:54 +02: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
|
2021-01-17 17:58:25 +01:00
|
|
|
production.
|
2018-05-22 23:15:08 +02:00
|
|
|
|
2020-09-12 17:21:54 +02:00
|
|
|
Most importantly: `actix-web` runs on Rust {{< rust-version "actix-web" >}} or later and it works
|
|
|
|
with stable releases.
|
|
|
|
|
|
|
|
<!-- TODO -->
|
|
|
|
<!-- which is built upon the fantastic [Tokio][tokio] asynchronous I/O system -->
|
|
|
|
|
|
|
|
<!-- LINKS -->
|
|
|
|
|
|
|
|
[tokio]: https://tokio.rs
|