skill

ترقية Prisma V7

دليل الهجرة الكامل من Prisma ORM v6 إلى v7، ويغطي جميع التغييرات الجوهرية. استخدمه عند ترقية إصدارات Prisma، أو مواجهة أخطاء v7، أو ترحيل المشاريع الحالية. يتم تفعيله عند "upgrade to prisma 7"، "prisma 7 migration"، "prisma-client generator"، "driver adapter required".

prisma311,243+ تثبيتموثوق

نبذة

# الترقية إلى Prisma ORM 7

دليل كامل للترحيل من Prisma ORM v6 إلى v7. تقدم هذه الترقية تغييرات جذرية مهمة حول مولد `prisma-client` الجديد، ومحولات المشغلات (driver adapters)، و`prisma.config.ts`، والتحميل الصريح للبيئة، ونقاط دخول العميل المنشأة.

## متى يتم التطبيق

ارجع إلى هذه المهارة عند: - الترقية من Prisma v6 إلى v7 - التحديث إلى مولد `prisma-client` - إعداد محولات المشغلات (driver adapters) - تهيئة `prisma.config.ts` - إصلاح أخطاء الاستيراد بعد الترقية

## فئات القواعد حسب الأولوية

| الأولوية | الفئة | التأثير | البادئة | |----------|----------|--------|--------| | 1 | ترحيل المخطط | حرج | `schema-changes` | | 2 | اتصال قاعدة البيانات | حرج | `driver-adapters` | | 3 | نظام الوحدات | حرج | `esm-support` | | 4 | التهيئة والبيئة | عال | `prisma-config`, `env-variables` | | 5 | الميزات المزالة | عال | `removed-features` | | 6 | Accelerate | عال | `accelerate-users` |

## مرجع سريع

- `schema-changes` - ترحيل المولد، مسارات الإخراج المطلوبة، نقاط الدخول المنشأة، واستبدال `Prisma.validator` - `driver-adapters` - تثبيت المحول المطلوب لمزودي SQL، اختلافات التجمع، وخيارات محول Prisma Postgres - `esm-support` - إعداد ESM-first بالإضافة إلى CommonJS fallback مع `moduleFormat = "cjs"` - `prisma-config` - إنشاء واستخدام `prisma.config.ts` - `env-variables` - التحميل الصريح للبيئة - `removed-features` - إزالة middleware، والمقاييس، وسلوك CLI القديم - `accelerate-users` - ملاحظات الترحيل لمستخدمي Accelerate

## هل تستخدم MongoDB؟ هذا الدليل لا ينطبق

Prisma 7 لا يحتوي على موصل MongoDB. لا تطبق أي خطوة في هذا الدليل على مشروع يحتوي على `provider = "mongodb"` — راجع مهارة `prisma-mongodb-upgrade` للقرار الفعلي (البقاء على v6 عمدا مقابل الترحيل إلى Prisma 8).

## ملاحظات هامة

- **يجب أن تبقى مشاريع MongoDB على Prisma 6.x أو ترحيلها إلى Prisma 8** - لا ترحل تطبيقات MongoDB إلى مسار عميل SQL في Prisma 7 (راجع `prisma-mongodb-upgrade`) - **Node.js 20.19.0+** مطلوب - **TypeScript 5.4.0+** مطلوب - **أحدث إصدار مستقر من Prisma ORM**: `7.6.0`

## نظرة عامة على خطوات الترقية

1. تحديث الحزم إلى v7 2. اختر تنسيق الوحدة النمطية الخاص بك (`esm` افتراضيا، `cjs` إذا لزم الأمر) 3. تحديث تهيئة TypeScript 4. تحديث كتلة مولد المخطط 5. إنشاء `prisma.config.ts` 6. تثبيت وتهيئة محول مشغل لمزودي SQL 7. تحديث استيرادات Prisma Client 8. تحديث إنشاء مثيل العميل 9. استبدال أنماط المساعد المهملة مثل `Prisma.validator` 10. تشغيل `prisma generate` والاختبار

## أوامر الترقية السريعة

```bash # Update packages npm install @prisma/client@7 npm install -D prisma@7

# Install a driver adapter (PostgreSQL or Prisma Postgres via direct TCP) npm install @prisma/adapter-pg pg

# Install dotenv for env loading npm install dotenv

# Regenerate client npx prisma generate ```

## ملخص التغييرات الجذرية

| التغيير | v6 | v7 | |--------|----|----| | تنسيق الوحدة النمطية | ضمني / مختلط | ESM-first، `moduleFormat = "cjs"` مدعوم | | مزود المولد | `prisma-client-js` | `prisma-client` هو الافتراضي، بينما `prisma-client-js` لا يزال موجودا للإعدادات القديمة | | مسار الإخراج | تلقائي (node_modules) | مطلوب صريح | | محولات المشغلات | اختياري | مطلوب لمزودي SQL | | ملف التهيئة | `.env` + schema | `prisma.config.ts` | | تحميل البيئة | تلقائي | يدوي (dotenv) | | نقاط الدخول المنشأة | تصدير حزمة واحدة | نقاط دخول `client`, `browser`, `models`, `enums` | | أجزاء الاستعلام الآمنة من النوع | `Prisma.validator()` | TypeScript `satisfies` | | Middleware | `$use()` | Client Extensions | | المقاييس | ميزة معاينة | مزالة |

## ملفات القواعد

أدلة ترحيل مفصلة لكل تغيير جذري:

``` references/esm-support.md - تهيئة ESM و CommonJS references/schema-changes.md - المولد، الإخراج، الاستيرادات، ونقاط الدخول المنشأة references/driver-adapters.md - إعداد محول المشغل المطلوب references/prisma-config.md - ملف التهيئة الجديد references/env-variables.md - تحميل متغيرات البيئة references/removed-features.md - Middleware، المقاييس، وعلامات CLI references/accelerate-users.md - معالجة خاصة ل Accelerate ```

## الترحيل خطوة بخطوة

### 1. تحديث package.json للمشاريع التي تعتمد على ESM-first

```json { "type": "module" } ```

إذا كنت بحاجة إلى البقاء على CommonJS، فاحتفظ بتطبيقك ك CJS وقم بتعيين `moduleFormat = "cjs"` في كتلة المولد بدلا من فرض ESM.

### 2. تحديث tsconfig.json

```json { "compilerOptions": { "module": "ESNext", "moduleResolution": "bundler", "target": "ES2023", "strict": true, "esModuleInterop": true } } ```

### 3. تحديث schema.prisma

```prisma // قبل (v6) generator client { provider = "prisma-client-js" }

// بعد (v7) generator client { provider = "prisma-client" output = "../generated/prisma" // اختياري إذا كنت بحاجة إلى CommonJS: // moduleFormat = "cjs" } ```

### 4. إنشاء prisma.config.ts

```typescript import 'dotenv/config' import

التثبيت

شغل هذا الأمر

npx skills add prisma/skills

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

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

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

عرض المصدر
الرخصة: MITبواسطة prisma

أسئلة شائعة

ما هي مهارة ترقية Prisma V7؟

دليل الهجرة الكامل من Prisma ORM v6 إلى v7، ويغطي جميع التغييرات الجوهرية. استخدمه عند ترقية إصدارات Prisma، أو مواجهة أخطاء v7، أو ترحيل المشاريع الحالية. يتم تفعيله عند "upgrade to prisma 7"، "prisma 7 migration"، "prisma-client generator"، "driver adapter required".

كيف أثبت ترقية Prisma V7؟

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

npx skills add prisma/skills
مع أي أدوات ذكاء اصطناعي تعمل ترقية Prisma V7؟

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

من طور ترقية Prisma V7؟

طورها prisma، وتصدر بترخيص MIT.

هل ترقية Prisma V7 مجانية؟

نعم، يمكنك استخدامها مجانا وفق ترخيص MIT.

أصول ذات صلة

مختارات أخرى في الإنتاجية والمكتب.

كل بدائل ترقية Prisma V7 ←
skillclaude_appclaude_codeclaude_api
npx skills add vercel-labs/skills
البحث عن المهارات
يساعد المستخدمين على اكتشاف وتثبيت مهارات الوكلاء عندما يطرحون أسئلة مثل "كيف أفعل X؟"، "ابحث عن مهارة ل X"، "هل توجد مهارة يمكنها..."، أو يعبرون عن ا…3,611,572+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
استخدام الوسائط
احصل على أو أنشئ أي وسائط لفيديو HyperFrames - موسيقى، مؤثرات صوتية، صور، أيقونات، شعارات، تعليق صوتي، صورة رمزية وفيديو مولد، نصوص، قصاصات، درجات ألو…1,085,267+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تحسين هيكلية قاعدة الكود
افحص قاعدة بيانات برمجية بحثا عن فرص للتحسين والتعميق، وقدمها كتقرير HTML مرئي، ثم تعمق في أي فرصة تختارها.1,040,100+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تسليم المهام
لخص المحادثة الحالية في وثيقة تسليم ليتابعها وكيل آخر.946,569+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
فرز أولي
نقل المشكلات وطلبات السحب الخارجية عبر آلة حالة لأدوار الفرز، وتصنيفها، والتحقق منها، والتدقيق فيها عند الحاجة، وكتابة ملخصات جاهزة للوكلاء.881,979+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تعليم
علم المستخدم مهارة أو مفهوما جديدا ضمن مساحة العمل هذه.778,928+

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

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

المزيد في الإنتاجية والمكتب