إنشاء أول مشروع Django لك: دليل خطوة بخطوة

مقدمة

Django هو إطار عمل ويب قوي ومفتوح المصدر يعتمد على لغة البرمجة Python. يُستخدم Django لتطوير تطبيقات الويب بشكل سريع وفعال بفضل ميزاته المدمجة مثل نظام ORM لإدارة قواعد البيانات، ونظام القوالب لإنشاء الواجهات، ودعم الأمان. في هذا الدرس، سنتعلم كيفية إنشاء مشروع Django جديد خطوة بخطوة، بدءًا من التثبيت وحتى تشغيل التطبيق.

الخطوة 1: تثبيت Python وPIP

قبل البدء في إنشاء مشروع Django، يجب أن يكون لديك Python مثبتًا على نظامك. Python هي لغة البرمجة التي يعتمد عليها Django. للتحقق مما إذا كان Python مثبتًا، افتح سطر الأوامر واكتب:

python --version

إذا لم يكن Python مثبتًا، يمكنك تنزيله من الموقع الرسمي python.org وتثبيته. كما يجب عليك التأكد من أن PIP، وهو مدير الحزم الخاص بـ Python، مثبت أيضًا. للتحقق من ذلك، اكتب:

pip --version

الخطوة 2: تثبيت Django

بعد التأكد من أن Python وPIP مثبتان، يمكنك الآن تثبيت Django باستخدام PIP. في سطر الأوامر، اكتب الأمر التالي:

pip install django

سيقوم هذا الأمر بتنزيل وتثبيت أحدث إصدار من Django. للتحقق من أن Django تم تثبيته بنجاح، اكتب:

django-admin --version

الخطوة 3: إنشاء مشروع Django جديد

لإنشاء مشروع Django جديد، استخدم الأمر django-admin startproject متبوعًا باسم المشروع. لنفترض أننا نريد إنشاء مشروع باسم myproject:

django-admin startproject myproject

سيقوم هذا الأمر بإنشاء مجلد جديد باسم myproject يحتوي على الملفات والمجلدات الأساسية لمشروع Django.

الخطوة 4: هيكلية مشروع Django

عند فتح مجلد المشروع، ستجد الهيكلية التالية:

• manage.py: ملف يستخدم للتفاعل مع المشروع عبر سطر الأوامر.
• myproject/: المجلد الذي يحتوي على إعدادات المشروع، وعنوان URL الرئيسي، وإعدادات WSGI.
• __init__.py: ملف يجعل من myproject حزمة Python.
• settings.py: يحتوي على إعدادات المشروع مثل قاعدة البيانات، والتطبيقات المثبتة، والإعدادات الأخرى.
• urls.py: يحدد مسارات URL لتطبيقات Django.
• wsgi.py: يستخدم لتشغيل المشروع على خادم ويب.

الخطوة 5: تشغيل خادم التطوير

لتشغيل خادم التطوير المدمج في Django والتحقق من أن المشروع يعمل بشكل صحيح، استخدم الأمر التالي داخل مجلد المشروع:

python manage.py runserver

سيبدأ خادم التطوير بالعمل، ويمكنك الوصول إلى المشروع في متصفح الويب عن طريق الذهاب إلى http://127.0.0.1:8000/.

الخطوة 6: إنشاء تطبيق جديد داخل المشروع

في Django، يُعتبر كل جزء من المشروع تطبيقًا مستقلًا. لإنشاء تطبيق جديد داخل المشروع، استخدم الأمر startapp متبوعًا باسم التطبيق. لنقم بإنشاء تطبيق باسم blog:

python manage.py startapp blog

سيقوم هذا الأمر بإنشاء مجلد جديد باسم blog يحتوي على الملفات والمجلدات الأساسية للتطبيق.

الخطوة 7: إعداد التطبيق الجديد في المشروع

بعد إنشاء التطبيق الجديد، نحتاج إلى إخبار Django بأن هذا التطبيق جزء من مشروعنا. يتم ذلك من خلال تعديل ملف الإعدادات الرئيسي للمشروع، settings.py.

لفتح ملف settings.py، اتبع الخطوات التالية:

• انتقل إلى المجلد الرئيسي للمشروع، ثم افتح الملف settings.py باستخدام محرر النصوص الذي تفضله.
• ابحث عن المتغير INSTALLED_APPS. هذا المتغير هو قائمة تحتوي على جميع التطبيقات المثبتة في المشروع.
• أضف اسم التطبيق الجديد (في حالتنا blog) إلى قائمة INSTALLED_APPS، كما يلي:

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'blog',  # التطبيق الجديد
]

إضافة التطبيق إلى INSTALLED_APPS يخبر Django بأن التطبيق جزء من المشروع. بعد ذلك، سيكون بإمكانك استخدام هذا التطبيق وجميع مكوناته مثل النماذج (models) والعروض (views) وقوالب HTML.

الخطوة 8: إنشاء نموذج بيانات (Model)

النماذج (Models) في Django تُستخدم لتعريف بنية البيانات للتطبيق. لنقم بإنشاء نموذج بيانات بسيط للمقالات في التطبيق blog. افتح الملف models.py وأضف الكود التالي:

from django.db import models

class Post(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.title

هذا النموذج يعرف بنية بيانات بسيطة لمقال يحتوي على عنوان ومحتوى وتاريخ الإنشاء. باستخدام النماذج، يستطيع Django إنشاء الجداول المناسبة في قاعدة البيانات.

الخطوة 9: إنشاء قاعدة البيانات وترحيل النماذج

بعد إنشاء النماذج، يجب علينا إنشاء قاعدة البيانات وترحيل النماذج إليها. يبدأ هذا بإنشاء ملفات الترحيل باستخدام الأمر التالي:

python manage.py makemigrations

ثم قم بترحيل التغييرات إلى قاعدة البيانات باستخدام الأمر التالي:

python manage.py migrate

سيقوم هذا بإنشاء الجداول المطلوبة في قاعدة البيانات لتخزين البيانات المتعلقة بالنماذج.

الخطوة 10: إنشاء لوحة تحكم الإدارة

Django يأتي مع لوحة تحكم إدارة جاهزة تتيح لك إدارة النماذج الخاصة بك بسهولة. لإضافة النموذج الجديد إلى لوحة التحكم، قم بتسجيل النموذج في admin.py في مجلد التطبيق:

from django.contrib import admin
from .models import Post

admin.site.register(Post)

الآن، يمكنك الدخول إلى لوحة التحكم عبر الذهاب إلى /admin في متصفح الويب وإضافة أو تعديل المقالات.

خاتمة

في هذا الدليل، تعلمنا كيفية إنشاء أول مشروع Django لك من البداية، بدءًا من التثبيت وإنشاء المشروع، إلى إعداد التطبيقات وإنشاء النماذج، وترحيلها إلى قاعدة البيانات. يُعد Django إطارًا قويًا لتطوير تطبيقات الويب، ويقدم العديد من الميزات المفيدة التي تساعد في بناء تطبيقات معقدة بسرعة وكفاءة. استمر في ممارسة العمل مع Django لتطوير مهاراتك وبناء تطبيقات ويب مذهلة.

تابعنا للحصول على مزيد من الدروس المتقدمة حول Django وكيفية استخدام ميزاته المتقدمة لبناء تطبيقات قوية وقابلة للتوسع.