官方地址:https://actix.rs/docs/

介绍

欢迎来到Actix
Actix是您使用Rust开发Web服务的大门,本文档将指导您。

本文档目前主要涵盖actix-web部分,它是构建在actix actor框架和Tokio异步IO系统之上的高级Web框架。 这是从API稳定性角度来看最稳定的部分。

如果您还没有使用过actix,那么最好从入门指南开始。 如果您已经了解自己的方法并且需要特定信息,则可能需要阅读actix-web API文档(或更低级别的actix API文档)。

什么是Actix

Actix是一些东西。 它的基础是Rust的强大的actor系统,在其上构建了actix-web系统。 这是您最有可能使用的内容。 actix-web为您提供的是一个有趣且非常快速的Web开发框架。

我们称actix-web是一个小而实用的框架。 对于所有意图和目的,它是一个微框架,有一些曲折。 如果您已经是Rust程序员,您可能会很快找到自己的家,但即使您使用其他编程语言,您也应该找到易于上传的actix-web。

使用actix-web开发的应用程序将公开本机可执行文件中包含的HTTP服务器。 您可以将其置于另一个HTTP服务器(如nginx)之后,或按原样提供服务。 即使完全没有其他HTTP服务器,actix-web也足以提供HTTP 1和HTTP 2支持以及SSL / TLS。 这使得它可用于构建准备分发的小型服务。

最重要的是:actix-web在Rust 1.26或更高版本上运行,它适用于稳定版本。

安装

安装Rust

由于actix-web是一个Rust框架,因此您需要Rust才能开始使用它。 如果您还没有,我们建议您使用rustup来管理Rust安装。 官方rust指南有一个很棒的部分开始。

我们目前至少需要Rust 1.24,因此请确保运行rustup update以获得最新和最好的Rust版本。 特别是本指南假设您实际运行Rust 1.26或更高版本。

安装actix-web

感谢Rust的cargo包管理员,您无需明确安装actix-web。 只要依靠它,你就准备好了。 对于您想要使用actix-web开发版本的不太可能的情况,您可以直接依赖于git存储库。

发布版本:

[dependencies]
actix-web = "0.7"

开发版本:

[dependencies]
actix-web = { git = "https://github.com/actix/actix-web" }

尝试

你可以在这里走两条路。 您可以按照指南进行操作,或者如果您非常不耐烦,可能需要查看我们的扩展示例存储库并运行包含的示例。 例如,您运行包含的基础示例的方式如下:

git clone https://github.com/actix/examples
cd examples/basics
cargo run