skill
ترقية Prisma V7
دليل الهجرة الكامل من Prisma ORM v6 إلى v7، ويغطي جميع التغييرات الجوهرية. استخدمه عند ترقية إصدارات Prisma، أو مواجهة أخطاء v7، أو ترحيل المشاريع الحالية. يتم تفعيله عند "upgrade to prisma 7"، "prisma 7 migration"، "prisma-client generator"، "driver adapter required".
نبذة
# الترقية إلى 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يعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add prisma/skills`، أو استنسخ المستودع وانسخ مجلد `prisma-upgrade-v7` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة ترقية 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.
npx skills add vercel-labs/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى