---
createdAt: 2026-01-21
updatedAt: 2026-01-21
title: وثائق حزمة fastify-intlayer
description: مُكون إضافي لـ Fastify لـ Intlayer يوفر دوال ترجمة واكتشاف اللغة.
keywords:
  - fastify-intlayer
  - fastify
  - plugin
  - internationalization
  - i18n
slugs:
  - doc
  - packages
  - fastify-intlayer
  - exports
history:
  - version: 8.0.0
    date: 2026-01-21
    changes: توثيق موحّد لجميع الصادرات
---

# حزمة fastify-intlayer

توفر حزمة `fastify-intlayer` ملحقًا لتطبيقات Fastify للتعامل مع التدويل (internationalization). تقوم باكتشاف الـ locale الخاص بالمستخدم وتزيّن كائن الطلب (request) بخصائص متعلقة بالتدويل.

## التثبيت

```bash
npm install fastify-intlayer
```

## الصادرات

### الملحق

استيراد:

```tsx
import "fastify-intlayer";
```

| الدالة     | الوصف                                                                                                                                                                                                                                                        | الوثيقة ذات الصلة                                                                                               |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
| `intlayer` | مكوّن Fastify يدمج Intlayer في تطبيق Fastify الخاص بك. يتولى اكتشاف اللغة من التخزين (الكوكيز، الرؤوس)، ويزيّن كائن الطلب ببيانات `intlayer` التي تحتوي على `t` و`getIntlayer` و`getDictionary`، ويعد مساحة أسماء CLS للوصول البرنامجي خلال دورة حياة الطلب. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/fastify-intlayer/intlayer.md) |

### الوظائف

استيراد:

```tsx
import "fastify-intlayer";
```

| الدالة          | الوصف                                                                                                                                                                                                                                                | الوثيقة ذات الصلة                                                                                      |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `t`             | دالة ترجمة عامة تسترجع المحتوى للّوكيل (locale) الحالي في Fastify. تستخدم CLS (التخزين المحلي غير المتزامن - Async Local Storage) ويجب استخدامها ضمن سياق الطلب الذي يديره المكوّن الإضافي `intlayer`. يمكن الوصول إليها أيضًا عبر `req.intlayer.t`. | [translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/translation.md) |
| `getIntlayer`   | تسترجع قاموسًا بناءً على مفتاحه من التصريح المولد وتُعيد محتواه للّوكيل المحدد. نسخة محسّنة من `getDictionary`. تستخدم CLS للوصول إلى سياق الطلب. يمكن الوصول إليها أيضًا عبر `req.intlayer.getIntlayer`.                                            | -                                                                                                      |
| `getDictionary` | يعالج كائنات القواميس ويُعيد المحتوى للـ locale المحدد. يعالج ترجمات `t()`، وenumerations، وMarkdown، وHTML، وما إلى ذلك. يستخدم CLS للوصول إلى سياق الطلب. يمكن الوصول إليه أيضاً عبر `req.intlayer.getDictionary`.                                 | -                                                                                                      |
