skill

الكائنات الدائمة

بناء، تصحيح، أو مراجعة كود Cloudflare Durable Objects للحالة المستمرة والتنسيق.

cloudflare115,057+ تثبيتموثوق

نبذة

# Durable Objects

أنشئ تطبيقات منسقة وذات حالة على حافة Cloudflare باستخدام Durable Objects.

## مصادر الاسترجاع

قد تكون معرفتك بواجهات برمجة تطبيقات Durable Objects وتكوينها قديمة. **فضل الاسترجاع على التدريب المسبق** لأي مهمة تتعلق ب Durable Objects.

| المورد | URL | |----------|-----| | الوثائق | https://developers.cloudflare.com/durable-objects/index.md | | مرجع API | https://developers.cloudflare.com/durable-objects/api/index.md | | أفضل الممارسات | https://developers.cloudflare.com/durable-objects/best-practices/index.md | | الأمثلة | https://developers.cloudflare.com/durable-objects/examples/index.md | | الأدوار والصلاحيات | https://developers.cloudflare.com/workers/authorization/durable-objects/index.md |

احضر صفحة الوثائق ذات الصلة عند تنفيذ الميزات.

## متى تستخدم

- إنشاء فئات Durable Object جديدة للتنسيق ذي الحالة - تنفيذ أساليب RPC، أو التنبيهات (alarms)، أو معالجات WebSocket - مراجعة كود DO الحالي لأفضل الممارسات - تكوين wrangler.jsonc/toml لربط DO والترحيلات - كتابة الاختبارات باستخدام تكامل Vitest من Cloudflare - تصميم استراتيجيات التجزئة (sharding) والعلاقات بين الأصل والفرع

## وثائق المرجع

- `./references/rules.md` - القواعد الأساسية، التخزين، التزامن، RPC، التنبيهات - [مرجع الاختبار](./references/testing.md) - وثائق Vitest الحالية، خيارات الترحيل، واختيار الاختبار - [مرجع Workers](./references/workers.md) - معالجات Workers، الأنواع، التكوين، التتبع، والتصحيح المحلي

بحث: `blockConcurrencyWhile`, `idFromName`, `getByName`, `setAlarm`, `sql.exec`

## المبادئ الأساسية

### استخدم Durable Objects من أجل

| الحاجة | مثال | |------|---------| | التنسيق | غرف الدردشة، الألعاب متعددة اللاعبين، المستندات التعاونية | | الاتساق القوي | المخزون، أنظمة الحجز، الألعاب القائمة على الأدوار | | التخزين لكل كيان | SaaS متعدد المستأجرين، بيانات لكل مستخدم | | الاتصالات المستمرة | WebSockets، إشعارات الوقت الفعلي | | العمل المجدول لكل كيان | تجديد الاشتراكات، مهل الألعاب |

### لا تستخدم من أجل

- معالجة الطلبات عديمة الحالة (استخدم Workers العاديين) - أقصى احتياجات التوزيع العالمي - طلبات مستقلة ذات تفرع عال

## مرجع سريع

### تكوين Wrangler

```jsonc // wrangler.jsonc { "durable_objects": { "bindings": [{ "name": "MY_DO", "class_name": "MyDurableObject" }] }, "migrations": [{ "tag": "v1", "new_sqlite_classes": ["MyDurableObject"] }] } ```

### نمط Durable Object الأساسي

```typescript import { DurableObject } from "cloudflare:workers";

export interface Env { MY_DO: DurableObjectNamespace<MyDurableObject>; }

export class MyDurableObject extends DurableObject<Env> { constructor(ctx: DurableObjectState, env: Env) { super(ctx, env); ctx.blockConcurrencyWhile(async () => { this.ctx.storage.sql.exec(` CREATE TABLE IF NOT EXISTS items ( id INTEGER PRIMARY KEY AUTOINCREMENT, data TEXT NOT NULL ) `); }); }

async addItem(data: string): Promise<number> { const result = this.ctx.storage.sql.exec<{ id: number }>( "INSERT INTO items (data) VALUES (?) RETURNING id", data ); return result.one().id; } }

export default { async fetch(request: Request, env: Env): Promise<Response> { const stub = env.MY_DO.getByName("my-instance"); const id = await stub.addItem("hello"); return Response.json({ id }); }, }; ```

## قواعد حرجة

1. **النمذجة حول ذرات التنسيق** - Durable Object واحد لكل غرفة دردشة/لعبة/مستخدم، وليس Durable Object عالمي واحد 2. **استخدم `getByName()` للتوجيه الحتمي** - نفس المدخلات = نفس مثيل Durable Object 3. **استخدم تخزين SQLite** - قم بتكوين `new_sqlite_classes` في الترحيلات 4. **التهيئة في المنشئ (constructor)** - استخدم `blockConcurrencyWhile()` لإعداد المخطط فقط 5. **استخدم أساليب RPC** - وليس معالج fetch() (تاريخ التوافق >= 2024-04-03) 6. **الاستمرارية أولا، التخزين المؤقت ثانيا** - اكتب دائما إلى التخزين قبل تحديث الحالة في الذاكرة 7. **تنبيه واحد لكل Durable Object** - `setAlarm()` يستبدل أي تنبيه موجود

## التفويض

لا تحتوي Durable Objects على أدوار أو صلاحيات منفصلة؛ يتبع الوصول العامل (Worker) الذي ينفذها. استرجع [إرشادات تفويض Durable Objects](https://developers.cloudflare.com/workers/authorization/durable-objects/index.md) الحالية قبل منح إمكانية المراقبة أو الوصول إلى Data Studio، وحدد نطاق دور Workers للعامل المقصود أو منتج Workers.

## أنماط خاطئة (ممنوع أبدا)

- Durable Object عالمي واحد يتعامل مع جميع الطلبات (نقطة اختناق) - استخدام `blockConcurrencyWhile()` في كل طلب (يقتل الإنتاجية) - تخزين الحالة الحرجة في الذاكرة فقط (تفقد عند الإخلاء/التعطل) - استخدام `await` بين عمليات الكتابة ذات الصلة في التخزين (يكسر الذرية) - الاحتفاظ ب `blockConcurrencyWhile()` عبر `fetch()` أو الإدخال/الإخراج الخارجي

## إنشاء Stub

```typescript // حتمي - مفضل لمعظم الحالات const stub = env.MY_DO.getByName("room-123");

// من سلسلة ID موجودة const id = env.MY_DO.idFromString(storedIdString); const stub = env.MY_DO.get(id);

// ID فريد جديد - قم بالتخزين ```

التثبيت

شغل هذا الأمر

npx skills add cloudflare/skills

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `npx skills add cloudflare/skills`، أو استنسخ المستودع وانسخ مجلد `skills/durable-objects` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة الكائنات الدائمة؟

بناء، تصحيح، أو مراجعة كود Cloudflare Durable Objects للحالة المستمرة والتنسيق.

كيف أثبت الكائنات الدائمة؟

شغل هذا الأمر في الطرفية:

npx skills add cloudflare/skills
مع أي أدوات ذكاء اصطناعي تعمل الكائنات الدائمة؟

تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.

من طور الكائنات الدائمة؟

طورها cloudflare.

هل الكائنات الدائمة مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في التطوير والبرمجة.

كل بدائل الكائنات الدائمة ←
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
واجهة برمجة تطبيقات Claude
مرجع ل Claude API / Anthropic SDK — معرفات النماذج، التسعير، المعاملات (params)، البث (streaming)، استخدام الأدوات، MCP، الوكلاء (agents)، التخزين الم…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
واجهة سطر الأوامر Hyperframes
واجهة سطر الأوامر (CLI) ل HyperFrames من job - لإنشاء الهياكل، والتحقق من الإطارات، وعرضها، وتعديل الجدول الزمني، والمعاينة، والتصيير محليا أو سحابيا،…1,214,920+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تطوير مدفوع بالاختبار
التطوير الموجه بالاختبار. يستخدم عندما يرغب المستخدم في بناء ميزات أو إصلاح أخطاء بأسلوب "الاختبار أولا"، أو يذكر "red-green-refactor"، أو يريد اختبار…1,046,962+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء
استجوب المستخدم بلا هوادة حول خطة أو قرار أو فكرة. استخدمها عندما يرغب المستخدم في اختبار مدى متانة تفكيره، أو يستخدم أي عبارات تحفيزية مثل "استجواب".869,010+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تشخيص الأخطاء
حلقة تشخيص للأخطاء الصعبة وتراجعات الأداء. تستخدم عندما يقول المستخدم "شخص/صحح هذا"، أو يبلغ عن شيء معطل/يصدر أخطاء/فاشل/بطيء.746,030+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
مراجعة الكود
راجع التغييرات منذ نقطة ثابتة (التزام، فرع، وسم، أو قاعدة دمج) على محورين: المعايير (هل يتبع الكود معايير الترميز الموثقة لهذا المستودع؟) والمواصفات (…696,572+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في التطوير والبرمجة