Skip to content

Commit 63c97fa

Browse files
i18n(ko-KR): update sessions.mdx and configuration-reference.mdx (#13839)
Co-authored-by: Armand Philippot <59021693+ArmandPhilippot@users.noreply.github.com>
1 parent 79e9e49 commit 63c97fa

2 files changed

Lines changed: 96 additions & 15 deletions

File tree

src/content/docs/ko/guides/sessions.mdx

Lines changed: 67 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,9 @@ title: 세션
33
description: 요청 시 렌더링되는 페이지에 대한 요청 간에 데이터를 공유합니다.
44
i18nReady: true
55
---
6+
7+
import { Steps } from '@astrojs/starlight/components';
8+
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
69
import Since from '~/components/Since.astro';
710
import ReadMore from '~/components/ReadMore.astro';
811

@@ -34,17 +37,78 @@ import vercel from '@astrojs/vercel'
3437
export default defineConfig({
3538
adapter: vercel()
3639
session: {
37-
driver: sessionDrivers.redis({
38-
url: process.env.REDIS_URL
40+
driver: sessionDrivers.lruCache({
41+
max: 800,
3942
}),
4043
}
4144
})
4245
```
4346

4447
<ReadMore>
45-
스토리지 드라이버 설정 및 기타 구성 가능한 옵션에 대한 자세한 내용은 [`session` 구성 옵션](/ko/reference/configuration-reference/#세션-옵션)을 참조하세요.
48+
스토리지 드라이버 설정 및 기타 구성 가능한 옵션에 대한 자세한 내용은 [`session` 구성 옵션](/ko/reference/configuration-reference/#세션-옵션)을 참조하세요.
4649
</ReadMore>
4750

51+
### 런타임에 구성 재정의하기
52+
53+
기본적으로 세션 드라이버는 빌드 시점에 구성되며, 사용된 모든 [환경 변수](/ko/guides/environment-variables/)는 빌드 결과물에 포함됩니다. 즉, 런타임에는 구성을 재정의할 수 없습니다.
54+
55+
다른 구성이 필요한 경우 (예: 외부 서비스에 연결), 이를 별도의 파일에 정의하세요. 그런 다음 해당 파일을 [드라이버의 진입점](/ko/reference/session-driver-reference/#entrypoint)으로 사용하세요.
56+
57+
다음 예시는 [Unstorage 호환성](/ko/reference/session-driver-reference/#unstorage-호환성)을 활용하여 고유한 진입점에서 Redis 드라이버를 구성하는 방법을 보여줍니다.
58+
59+
<Steps>
60+
1. [`unstorage` 패키지](https://unstorage.unjs.io/guide)를 설치합니다.
61+
<PackageManagerTabs>
62+
<Fragment slot="npm">
63+
```sh
64+
npm install unstorage
65+
```
66+
</Fragment>
67+
<Fragment slot="pnpm">
68+
```sh
69+
pnpm add unstorage
70+
```
71+
</Fragment>
72+
<Fragment slot="yarn">
73+
```sh
74+
yarn add unstorage
75+
```
76+
</Fragment>
77+
</PackageManagerTabs>
78+
79+
2. 드라이버 구성을 위한 파일 (예: `src/session-driver.ts`)을 만들고 드라이버 인스턴스를 반환하는 기본 함수를 내보냅니다.
80+
```ts title="src/session-driver.ts"
81+
import type { SessionDriver } from "astro";
82+
import redisDriver from "unstorage/drivers/redis";
83+
import { REDIS_HOST, REDIS_PORT } from "astro:env";
84+
85+
export default function (): SessionDriver {
86+
return redisDriver({
87+
host: REDIS_HOST,
88+
port: REDIS_PORT,
89+
});
90+
}
91+
```
92+
93+
3. Astro 설정에서 이 파일을 드라이버의 진입점으로 사용합니다.
94+
```js title="astro.config.mjs" {11-13}
95+
import { defineConfig, envField, sessionDrivers } from "astro/config";
96+
import vercel from "@astrojs/vercel";
97+
98+
export default defineConfig({
99+
adapter: vercel(),
100+
env: {
101+
REDIS_HOST: envField.string({ context: "server", access: "public", default: "localhost" }),
102+
REDIS_PORT: envField.number({ context: "server", access: "public", default: 6379 }),
103+
},
104+
session: {
105+
driver: {
106+
entrypoint: new URL('./src/session-driver.ts', import.meta.url),
107+
}
108+
}
109+
});
110+
```
111+
</Steps>
48112
49113
## 세션 데이터와 상호작용
50114

src/content/docs/ko/reference/configuration-reference.mdx

Lines changed: 29 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1225,24 +1225,26 @@ Astro가 응답하도록 허용된 호스트 이름의 목록입니다. 값이 `
12251225
</p>
12261226

12271227
Astro 프로젝트의 세션 스토리지를 구성합니다. 이는 세션 데이터를 영구적인 방식으로 저장하여 여러 요청에 걸쳐 접근할 수 있도록 하는 데 사용됩니다.
1228-
일부 어댑터는 기본 세션 드라이버를 제공할 수 있지만, 사용자 정의 구성으로 이를 덮어쓸 수 있습니다.
12291228

1230-
더 자세한 내용은 [세션 가이드](/ko/guides/sessions/)를 참조하세요.
1229+
일부 어댑터는 기본 세션 드라이버를 제공할 수 있지만, 사용자 정의 구성으로 이를 덮어쓸 수 있습니다.
12311230

12321231
```js title="astro.config.mjs"
1233-
{
1234-
session: {
1235-
// Unstorage 드라이버의 이름
1236-
driver: 'redis',
1237-
// 드라이버에 따른 필수 옵션
1238-
options: {
1239-
url: process.env.REDIS_URL,
1240-
},
1241-
ttl: 3600, // 1시간
1242-
}
1232+
import { defineConfig, sessionDrivers } from 'astro/config';
1233+
1234+
export default defineConfig({
1235+
session: {
1236+
driver: sessionDrivers.redis({
1237+
// 옵션은 드라이버에 따라 다르며 일부는 필수일 수 있습니다.
1238+
url: process.env.REDIS_URL
1239+
}),
12431240
}
1241+
});
12441242
```
12451243

1244+
세션 드라이버는 빌드 시 구성됩니다. 즉, 드라이버 구성에 사용된 환경 변수가 인라인됩니다. [런타임에 구성을 재정의](/ko/guides/sessions/#런타임에-구성-재정의하기)하려면 고유한 드라이버 엔트리포인트를 만들어야 합니다.
1245+
1246+
자세한 내용은 [세션 가이드](/ko/guides/sessions/)를 참조하세요.
1247+
12461248
### session.driver
12471249

12481250
<p>
@@ -1600,6 +1602,19 @@ Astro의 내장 Sharp 이미지 서비스를 사용할 때 `sharp().png()`에
16001602
`compressionLevel`, `effort`, `palette` 또는 기본 `quality`와 같은 옵션에 사용할 수 있습니다.
16011603
`<Image />`, `<Picture />`, `getImage()`에서 설정한 이미지별 `quality` 값이 여전히 우선합니다.
16021604

1605+
### image.dangerouslyProcessSVG
1606+
1607+
<p>
1608+
1609+
**타입:** `boolean`<br />
1610+
**기본값:** `false`<br />
1611+
<Since v="6.3.0" />
1612+
</p>
1613+
1614+
SVG 소스 이미지가 이미지 최적화 파이프라인에서 처리되도록 허용합니다.
1615+
1616+
특별히 조작된 SVG는 처리 비용이 매우 많이 들 수 있으며, 악의적인 행위자가 서비스 거부 공격을 실행하는 데 사용할 수 있으므로 이 옵션은 기본적으로 비활성화되어 있습니다. SVG 이미지의 출처를 신뢰하고 처리 시 발생할 수 있는 위험을 이해하는 경우에만 이 옵션을 활성화하세요.
1617+
16031618
### image.domains
16041619

16051620
<p>
@@ -1664,6 +1679,8 @@ Astro의 내장 Sharp 이미지 서비스를 사용할 때 `sharp().png()`에
16641679
- `/**`로 끝나면 모든 하위 경로를 허용합니다 (`startsWith`와 유사).
16651680
- `/*`로 끝나면 1단계 하위 경로만 허용합니다.
16661681

1682+
이미지 URL이 원격 패턴과 일치하면 HTTP 리디렉션도 수행됩니다. 이미지를 로드하려면 최종 목적지 URL이 허용된 원격 패턴 중 하나여야 합니다.
1683+
16671684
### image.responsiveStyles
16681685

16691686
<p>

0 commit comments

Comments
 (0)