---
createdAt: 2026-01-29
updatedAt: 2026-01-29
title: hono-intlayer 패키지 문서
description: 번역 함수와 로케일 감지를 제공하는 Intlayer용 Hono 미들웨어입니다.
keywords:
  - hono-intlayer
  - hono
  - 미들웨어
  - 국제화
  - i18n
slugs:
  - doc
  - packages
  - hono-intlayer
  - exports
history:
  - version: 8.0.0
    date: 2026-01-29
    changes: 모든 내보내기에 대한 통합 문서
---

# hono-intlayer 패키지

`hono-intlayer` 패키지는 국제화를 처리하기 위한 Hono 애플리케이션용 미들웨어를 제공합니다. 사용자의 로케일을 감지하고 컨텍스트 객체를 채웁니다.

## 설치

```bash
npm install hono-intlayer
```

## 내보내기

### 미들웨어

가져오기:

```tsx
import { intlayer } from "hono-intlayer";
```

| 함수       | 설명                                                                                                                                                                                                                                                      | 관련 문서                                                                                                    |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `intlayer` | Intlayer를 Hono 애플리케이션에 통합하는 Hono 미들웨어입니다. 스토리지(쿠키, 헤더)에서 로케일 감지를 처리하고, `t`, `getIntlayer`, `getDictionary`로 컨텍스트를 채우며, 요청 수명 주기 동안 프로그래밍 방식의 액세스를 위해 CLS 네임스페이스를 설정합니다. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/packages/hono-intlayer/intlayer.md) |

### 함수

가져오기:

```tsx
import { t, getIntlayer, getDictionary } from "hono-intlayer";
```

| 함수            | 설명                                                                                                                                                                                                                   | 관련 문서                                                                                              |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `t`             | Hono의 현재 로케일에 대한 콘텐츠를 검색하는 전역 번역 함수입니다. CLS(Async Local Storage)를 활용하며 `intlayer` 미들웨어에서 관리하는 요청 컨텍스트 내에서 사용해야 합니다. 컨텍스트를 통해서도 액세스할 수 있습니다. | [translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/translation.md) |
| `getIntlayer`   | 생성된 선언에서 키로 딕셔너리를 검색하고 지정된 로케일에 대한 콘텐츠를 반환합니다. `getDictionary`의 최적화된 버전입니다. 요청 컨텍스트에 액세스하기 위해 CLS를 사용합니다. 컨텍스트를 통해서도 액세스할 수 있습니다.  | -                                                                                                      |
| `getDictionary` | 딕셔너리 객체를 처리하고 지정된 로케일에 대한 콘텐츠를 반환합니다. `t()` 번역, 열거형, 마크다운, HTML 등을 처리합니다. 요청 컨텍스트에 액세스하기 위해 CLS를 사용합니다. 컨텍스트를 통해서도 액세스할 수 있습니다.     | -                                                                                                      |
