1.6 KiB

Raw Blame History

currentMenu
guide-sessions

Sessions

Sessions help you store information about a user between requests. As long as the client supports cookies, sessions are easy to create.

Middleware

Enable sessions on your Droplet by adding an instance of SessionMiddleware.

import Sessions

let memory = MemorySessions()
let sessions = SessionsMiddleware(sessions: memory)

Then add to the Droplet.

let drop = Droplet(availableMiddleware: ["sessions": sessions])

Once you've added the SessionsMiddleware to the available middleware dictionary, make sure to enable it in your middleware.json configuration file.

Request

After SessionMiddleware has been enabled, you can access the req.sessions() method to get access to session data.

let data = try req.session().data

Example

Let's create an example that remembers the user's name.

Store

drop.post("remember") { req in
    guard let name = req.data["name"]?.string else {
        throw Abort.badRequest
    }

    try req.session().data["name"] = Node.string(name)

    return "Remebered name."
}

On POST /remember, fetch a name from the request input, then store this name into the session data.

Fetch

On GET /remember, fetch the name from the session data and return it.

drop.get("remember") { req in
    guard let name = try req.session().data["name"]?.string else {
        return throw Abort.custom(status: .badRequest, message: "Please POST the name first.")
    }

    return name
}

The session will be stored using the vapor-session cookie.

1.6 KiB Raw Blame History