mirror of
https://github.com/actix/actix-extras.git
synced 2024-11-27 17:22:57 +01:00
50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
# actix-redis
|
|
|
|
> Redis integration for Actix and session store for Actix Web.
|
|
|
|
[](https://crates.io/crates/actix-redis)
|
|
[](https://docs.rs/actix-redis/0.9.2)
|
|
|
|
[](https://deps.rs/crate/actix-redis/0.9.2)
|
|
|
|
## Documentation & Resources
|
|
|
|
- [API Documentation](https://docs.rs/actix-cors)
|
|
- [Example Project](https://github.com/actix/examples/tree/HEAD/session/redis-session)
|
|
- Minimum Supported Rust Version (MSRV): 1.42.0
|
|
|
|
## Redis Session Backend
|
|
|
|
Use redis as session storage.
|
|
|
|
You need to pass an address of the redis server and random value to the
|
|
constructor of `RedisSession`. This is private key for cookie session,
|
|
When this value is changed, all session data is lost.
|
|
|
|
Note that whatever you write into your session is visible by the user (but not modifiable).
|
|
|
|
Constructor panics if key length is less than 32 bytes.
|
|
|
|
```rust
|
|
use actix_web::{App, HttpServer, web, middleware};
|
|
use actix_web::middleware::session::SessionStorage;
|
|
use actix_redis::RedisSession;
|
|
|
|
#[actix_rt::main]
|
|
async fn main() -> std::io::Result {
|
|
HttpServer::new(|| App::new()
|
|
// enable logger
|
|
.middleware(middleware::Logger::default())
|
|
// cookie session middleware
|
|
.middleware(SessionStorage::new(
|
|
RedisSession::new("127.0.0.1:6379", &[0; 32])
|
|
))
|
|
// register simple route, handle all methods
|
|
.service(web::resource("/").to(index))
|
|
)
|
|
.bind("0.0.0.0:8080")?
|
|
.start()
|
|
.await
|
|
}
|
|
```
|