قبل أن تبدأ في بناء الوظائف الأساسية لتطبيق ويب Django جديد، تحتاج إلى إكمال بضع خطوات الضرورية لإعداد مشروع Django.
في هذا الدرس سنركز على الخطوات الأولية التي ستحتاج إلى اتخاذها لبدء تطبيق ويب جديد.
ستحتاج إلى تثبيت Python وفهم كيفية العمل مع البيئات الافتراضية ومدير حزم بايثون pip، لن تحتاج إلى معرفة برمجية كبيرة لإكمال هذه الإعدادات، بل كل ماتحتاجه معرفة بعض أساسياتPython .
بنهاية هذا الدرس ستكون قادرا على:
إعداد بيئة افتراضية
بتثبيت Django
تثبيت متطلبات المشروع
إعداد مشروع Django
تشغيل تطبيق Django
تجهيز بيئة العمل
عندما تريد بدء تطبيق ويب Django جديد، أنشئ مجلد جديد وانتقل إليه، في هذا المجلد ستقوم بإعداد بيئة افتراضية جديدة باستخدام سطر الأوامر
python3 -m venv env
يقوم هذا الأمر بإعداد بيئة افتراضية جديدة تسمى env في دليل العمل الحالي، و بمجرد اكتمال العملية ستحتاج أيضًا إلى تفعيل البيئة الافتراضية:
source env/bin/activate
بعد التفعيل سترى اسم بيئتك الافتراضية (env) في بداية موجه الأوامر، و يعني هذا أن إعداد البيئة الخاصة بك قد اكتمل.
تثبيت جانغو
بمجرد إنشاء بيئة Python الافتراضية وتفعيلها، يمكنك تثبيت Django داخل هذه البيئة:
python -m pip install django
قوم هذا الأمر بجلب حزمة django من فهرس حزمة Python (PyPI) باستخدام pip، بعد اكتمال التثبيت يمكنك تثبيت التبعيات الخاصة بك للتأكد من أنك تتبع إصدار Django الذي قمت بتثبيته:
python -m pip freeze > requirements.txt
يكتب هذا الأمر أسماء وإصدارات جميع حزم Python الخارجية الموجودة حاليًا في بيئتك الافتراضية في ملف يسمى requirements.txt، و يتضمن هذا الملف حزمة django وجميع تبعياتها.
قم بإعداد مشروع Django
عند تثبيت Django بنجاح ستكون على استعداد لإنشاء تطبيق الويب الجديد الخاص بك، و ينقسم إطار عمل Django بين المشاريع والتطبيقات:
- مشروع Django هو وحدة تنظيمية رفيعة المستوى و عبارة عن تطبيق ويب كامل و يمكن أن يحتوي كل مشروع على تطبيقات متعددة.
- تطبيق Django هو وحدة ذات مستوى منخفض لتطبيق الويب الخاص بك و يمكن أن يكون لديك العديد من التطبيقات في المشروع ، ستتعرف على المزيد حول التطبيقات في القسم التالي.
من خلال بيئتك الافتراضية يمكنك الآن إنشاء المشروع:
django-admin startproject project-name
يمكنك تسمية مشروعك بأي إسم تريد، و في هذا الدرس سنستخدم setup كإسم للمشروع
django-admin startproject setup
يؤدي تشغيل هذا الأمر إلى إنشاء بنية مجلد افتراضية، والتي تتضمن بعض ملفات Python وتطبيق الإدارة الذي يحمل نفس اسم مشروعك:
يمكنك رؤية بنية المجلد التي أنشأها الأمر startproject.
setup/
│
├── setup/
│ ├── __init__.py
│ ├── asgi.py
│ ├── settings.py
│ ├── urls.py
│ └── wsgi.py
│
└── manage.py
- مجلد setup هو مجلد مشروع .
- مجلد setup / setup هو مجلد المستوى الأدنى الذي يمثل تطبيق الإدارة الخاص بك.
- مجلد manage.py هو ملف Python يعمل كمركز قيادة لمشروعك، و يفعل نفس الشيء مثل الأداة المساعدة لسطر الأوامر django-admin.
يحتوي مجلد setup / setup / على بضعة ملفات أخرى ستقوم بتعديلها عندما تعمل على تطبيق الويب الخاص بك.
ملاحظة: إذا كنت ترغب في تجنب إنشاء مجلد المشروع فيمكنك إضافة نقطة (.) في نهاية الأمر Django-Admin StartProject:
تشغيل تطبيق Django
يمكن أن يحتوي كل مشروع تقوم بإنشائه باستخدام Django على العديد من تطبيقات Django، عندما قمت بتشغيل أمر startproject في القسم السابق قمت بإنشاء تطبيق إدارة ستحتاجه لكل مشروع افتراضي ستقوم بإنشائه. الآن ستنشئ تطبيق Django الذي سيحتوي على الوظائف المحددة لتطبيق الويب الخاص بك.
لن تحتاج إلى استخدام الأداة المساعدة django-admin بعد الآن ويمكنك تنفيذ أمر startapp من خلال ملف manager.py بدلاً من ذلك:
python manage.py startapp appname
يقوم الأمر startapp بإنشاء بنية مجلد افتراضية لتطبيق Django، وسنستخدم في هذا الدرس example كاسم للتطبيق و طبعا يمكنك إستخدام أي إسم:
python manage.py startapp example
بمجرد انتهاء أمر startapp من التنفيذ ، سترى أن Django قد أضاف مجلدًا آخر إلى بنية المجلد الخاص بك:
setup/
│
├── example/
│ │
│ ├── migrations/
│ │ └── __init__.py
│ │
│ ├── __init__.py
│ ├── admin.py
│ ├── apps.py
│ ├── models.py
│ ├── tests.py
│ └── views.py
│
├── setup/
│ ├── __init__.py
│ ├── asgi.py
│ ├── settings.py
│ ├── urls.py
│ └── wsgi.py
│
└── manage.py
يحمل المجلد الجديد الاسم الذي منحته إياه عند تشغيل الأمر، و في مثالنا هذا example، يمكنك أن ترى أن المجلد يحتوي على اثنين من ملفات Python.
مجلد تطبيق Django هذا هو المكان الذي ستقضي فيه معظم وقتك عند إنشاء تطبيق الويب الخاص بك، ستحتاج أيضًا إلى إجراء بعض التغييرات في تطبيق الإدارة setup/ لكنك ستنشئ معظم وظائفك داخل تطبيق Django ، examlpe /.
ستتعرف على ملفات Python التي تم إنشاؤها بمزيد من التفاصيل عند العمل على بناء مشروعك الخاص، و فيما يلي ثلاثة ملفات بارزة تم إنشاؤها في مجلد التطبيق:
- __init__.py: تستخدم بايثون هذا الملف لإعلان مجلد كحزمة مما يسمح لـ جانغو باستخدام كود من تطبيقات مختلفة لتكوين الوظائف العامة لتطبيق الويب الخاص بك. ربما لن تضطر إلى لمس هذا الملف.
- Models.py: يتم تصريح نماذج التطبيق الخاصة بك في هذا الملف، والذي يسمح لجانغو بالإتصال مع قاعدة بيانات تطبيق الويب الخاص بك.
- views.py: ستكتب معظم التعليمات البرمجية لتطبيقك في هذا الملف.
في هذه المرحلة تكون قد انتهيت من إعداد تطبيق ويب Django، ويمكنك البدء في تنفيذ أفكارك، من الآن فصاعدًا يعود الأمر إليك فيما تريد إنشاءه لإنشاء مشروعك الفريد.
اكتشاف المزيد من بايثون العربي
اشترك للحصول على أحدث التدوينات المرسلة إلى بريدك الإلكتروني.