세션(Sessions)#

세션을 사용하면 여러 요청 사이에서 사용자의 데이터를 유지할 수 있습니다. 세션은 새로운 세션이 초기화될 때 HTTP 응답과 함께 고유한 쿠키를 생성하여 반환하는 방식으로 동작합니다. 브라우저는 이 쿠키를 자동으로 감지하여 이후 요청에 포함시킵니다. 이를 통해 Vapor는 요청 핸들러에서 특정 사용자의 세션을 자동으로 복원할 수 있습니다.

세션은 HTML을 웹 브라우저에 직접 제공하는, Vapor로 만든 프런트엔드 웹 애플리케이션에 매우 유용합니다. API의 경우, 요청 간에 사용자 데이터를 유지하기 위해 상태를 갖지 않는(stateless) 토큰 기반 인증을 사용하는 것을 권장합니다.

설정#

라우트에서 세션을 사용하려면 요청이 SessionsMiddleware를 거쳐야 합니다. 이를 구현하는 가장 쉬운 방법은 이 미들웨어를 전역으로 추가하는 것입니다. 쿠키 팩토리를 선언한 이후에 이 미들웨어를 추가하는 것이 좋습니다. Sessions는 구조체이므로 참조 타입이 아니라 값 타입이기 때문입니다. 값 타입이므로 SessionsMiddleware를 사용하기 전에 값을 설정해야 합니다.

app.middleware.use(app.sessions.middleware)

일부 라우트에서만 세션을 사용하는 경우, 대신 라우트 그룹에 SessionsMiddleware를 추가할 수 있습니다.

let sessions = app.grouped(app.sessions.middleware)

세션에 의해 생성되는 HTTP 쿠키는 app.sessions.configuration을 사용하여 설정할 수 있습니다. 쿠키 이름을 변경하거나 쿠키 값을 생성하는 사용자 정의 함수를 선언할 수 있습니다.

// 쿠키 이름을 "foo"로 변경합니다.
app.sessions.configuration.cookieName = "foo"

// 쿠키 값 생성을 설정합니다.
app.sessions.configuration.cookieFactory = { sessionID in
    .init(string: sessionID.string, isSecure: true)
}

app.middleware.use(app.sessions.middleware)

기본적으로 Vapor는 vapor_session을 쿠키 이름으로 사용합니다.

드라이버#

세션 드라이버는 식별자를 기준으로 세션 데이터를 저장하고 조회하는 역할을 담당합니다. SessionDriver 프로토콜을 준수하도록 만들어 사용자 정의 드라이버를 만들 수 있습니다.

인메모리(In-Memory)#

Vapor는 기본적으로 인메모리 세션을 사용합니다. 인메모리 세션은 별도의 설정이 필요 없으며 애플리케이션이 재실행되어도 유지되지 않기 때문에 테스트에 매우 유용합니다. 인메모리 세션을 수동으로 활성화하려면 .memory를 사용하십시오.

app.sessions.use(.memory)

프로덕션에서 사용하려면, 여러 애플리케이션 인스턴스 간에 세션을 유지하고 공유하기 위해 데이터베이스를 활용하는 다른 세션 드라이버를 살펴보십시오.

Fluent#

Fluent는 애플리케이션의 데이터베이스에 세션 데이터를 저장하는 기능을 지원합니다. 이 섹션에서는 여러분이 이미 Fluent를 설정했고 데이터베이스에 연결할 수 있다고 가정합니다. 첫 번째 단계는 Fluent 세션 드라이버를 활성화하는 것입니다.

import Fluent

app.sessions.use(.fluent)

이렇게 하면 애플리케이션의 기본 데이터베이스를 사용하도록 세션이 설정됩니다. 특정 데이터베이스를 지정하려면 해당 데이터베이스의 식별자를 전달하십시오.

app.sessions.use(.fluent(.sqlite))

마지막으로, SessionRecord의 마이그레이션을 데이터베이스의 마이그레이션 목록에 추가하십시오. 이렇게 하면 _fluent_sessions 스키마에 세션 데이터를 저장할 수 있도록 데이터베이스가 준비됩니다.

app.migrations.add(SessionRecord.migration)

새 마이그레이션을 추가한 후에는 애플리케이션의 마이그레이션을 반드시 실행하십시오. 이제 세션은 애플리케이션의 데이터베이스에 저장되어 재시작 후에도 유지되며 애플리케이션의 여러 인스턴스 간에 공유될 수 있습니다.

Redis#

Redis는 설정된 Redis 인스턴스에 세션 데이터를 저장하는 기능을 지원합니다. 이 섹션에서는 여러분이 이미 Redis를 설정했고 Redis 인스턴스에 명령을 보낼 수 있다고 가정합니다.

세션에 Redis를 사용하려면, 애플리케이션을 설정할 때 이를 선택하십시오.

import Redis

app.sessions.use(.redis)

이렇게 하면 기본 동작으로 Redis 세션 드라이버를 사용하도록 세션이 설정됩니다.

세션 데이터#

이제 세션이 설정되었으니, 요청 간에 데이터를 유지할 준비가 되었습니다. 새로운 세션은 req.session에 데이터가 추가될 때 자동으로 초기화됩니다. 아래 예제 라우트 핸들러는 동적 라우트 매개변수를 받아 그 값을 req.session.data에 추가합니다.

app.get("set", ":value") { req -> HTTPStatus in
    req.session.data["name"] = req.parameters.get("value")
    return .ok
}

다음 요청을 사용하여 이름이 vapor인 세션을 초기화하십시오.

GET /set/vapor HTTP/1.1
content-length: 0

다음과 유사한 응답을 받게 될 것입니다.

HTTP/1.1 200 OK
content-length: 0
set-cookie: vapor-session=123; Expires=Fri, 10 Apr 2020 21:08:09 GMT; Path=/

req.session에 데이터를 추가한 후 응답에 set-cookie 헤더가 자동으로 추가된 것을 확인하십시오. 이후 요청에 이 쿠키를 포함시키면 세션 데이터에 접근할 수 있습니다.

세션에서 name 값을 가져오는 다음 라우트 핸들러를 추가하십시오.

app.get("get") { req -> String in
    req.session.data["name"] ?? "n/a"
}

이전 응답에서 받은 쿠키 값을 반드시 전달하면서, 다음 요청을 사용하여 이 라우트에 접근하십시오.

GET /get HTTP/1.1
cookie: vapor-session=123

응답에서 이름 vapor가 반환되는 것을 볼 수 있습니다. 필요에 따라 세션에서 데이터를 추가하거나 제거할 수 있습니다. 세션 데이터는 HTTP 응답을 반환하기 전에 세션 드라이버와 자동으로 동기화됩니다.

세션을 종료하려면 req.session.destroy를 사용하십시오. 이렇게 하면 세션 드라이버에서 데이터를 삭제하고 세션 쿠키를 무효화합니다.

app.get("del") { req -> HTTPStatus in
    req.session.destroy()
    return .ok
}