العودة إلى الدرس

ملف العمل الأصلي

run-locally.txt

تحتفظ الشيفرة وصفحات الأمثلة القابلة للتشغيل بمعرّفاتها ونصوصها التجريبية الأصلية. يشرحها الدرس وإرشادات الملفات بلغتك.

تشغيل مشروع التدريب المنفصل هذا

1. أبقِ public/ وnetlify/functions/ وpackage.json في جذر الورشة هذا. استخدم إصدار Node LTS مدعومًا حاليًا يلبي package.json engines، أي >=22.13.0 وهو الحد الأدنى لأداة CLI المثبتة بإصدار محدد. افحص node --version. لدعم الإصدارات الحالي: https://nodejs.org/en/about/previous-releases
2. شغّل npm install في جذر الورشة هذا. يثبّت Netlify CLI المحلية المحددة الإصدار وStripe SDK وينشئ package-lock.json. احتفظ بملف القفل مع مشروعك. لا يلزم تثبيت CLI عالميًا.
3. شغّل npx netlify login ثم npx netlify link. اختر مشروع تدريبك القابل للاستغناء عنه فقط. يحدد الربط مشروعًا؛ ولا ينشر نسخة.
4. أنشئ .env خاصة في الجذر باستخدام الأسماء في server-env.example.txt. لا تضعها في public/ أبدًا. تأكد من تجاهل Git لها، واستخدم خدمات وصناديق اختبار خاصة بك فقط.
5. شغّل npm run dev. افتح الرابط المحلي الذي يطبعه الوكيل، عادة http://localhost:8888. لا تستطيع صفحة file:// أو خادم HTTP ثابت عادي تشغيل هذه الدوال.
6. اختبر الميزة والحالات السلبية في الدرس. يظل الوكيل المحلي يستدعي الخدمة البعيدة المعدّة؛ تنطبق إتاحة حسابك وحصته ورسومه المحتملة. فتح الصفحة وحده لا يثبت تسليم المزوّد. أوقف التشغيل باستخدام Ctrl+C.


وثائق CLI: https://docs.netlify.com/api-and-cli-guides/cli-guides/local-development/