# دليل بدء استخدام Django: كيفية إنشاء موقعك الأول بسرعة Django هو إطار عمل قوي وفعال لتطوير الويب بلغة Python، مناسب لبناء تطبيقات ومواقع ويب معقدة. يتضمن هذا الإطار العديد من الميزات المفيدة، مما يتيح للمطورين بناء تطبيقات قوية بسرعة. سواء كنت مبتدئًا أو لديك خبرة معينة، يمكن أن يوفر لك Django العديد من المزايا. في هذه المقالة، سنعلمك كيفية استخدام Django لإنشاء موقعك الأول من خلال خطوات محددة. ## 1. إعداد البيئة قبل البدء، تأكد من أن بيئة التطوير الخاصة بك قد تم تثبيت Python و pip (أداة إدارة الحزم الخاصة بـ Python). يحتاج Django إلى Python 3.6 أو إصدار أحدث. ### تثبيت Python و pip يمكنك تنزيل وتثبيت الإصدار المناسب لنظام التشغيل الخاص بك من [الموقع الرسمي لـ Python](https://www.python.org/downloads/). بعد التثبيت، تحقق من إصدار Python و pip من خلال سطر الأوامر: ```bash python --version pip --version ``` ### تثبيت Django تثبيت Django عبر pip سهل للغاية. أدخل الأمر التالي في سطر الأوامر: ```bash pip install django ``` بعد الانتهاء من التثبيت، تأكد من أنه يمكنك العثور على إصدار Django في سطر الأوامر: ```bash django-admin --version ``` ## 2. إنشاء مشروع Django بعد تثبيت Django، يمكننا البدء في إنشاء مشروع جديد. المشروع هو الهيكل الأساسي لـ Django، ويتضمن تطبيقاتك وإعداداتك. ### إنشاء مشروع في الدليل الذي ترغب في إنشاء المشروع فيه، قم بتشغيل الأمر التالي: ```bash django-admin startproject myproject ``` سيؤدي ذلك إلى إنشاء دليل جديد باسم `myproject`، يحتوي على بعض الملفات الافتراضية وهيكل الدليل. ### هيكل الدليل سترى هيكل الدليل التالي: ``` myproject/ manage.py myproject/ __init__.py settings.py urls.py asgi.py wsgi.py ``` - `manage.py`: أداة إدارة Django، تُستخدم لإدارة المشروع. - `settings.py`: ملف إعدادات المشروع، يمكنك هنا تكوين قاعدة البيانات، الملفات الثابتة، وغيرها. - `urls.py`: إعدادات توجيه URL للمشروع. - `asgi.py` و `wsgi.py`: إعدادات الواجهة للنشر. ## 3. تشغيل خادم التطوير في دليل المشروع، استخدم الأمر التالي لبدء خادم التطوير الخاص بـ Django: ```bash python manage.py runserver ``` إذا كان كل شيء على ما يرام، يجب أن تتمكن من زيارة [http://127.0.0.1:8000/](http://127.0.0.1:8000/) في المتصفح لرؤية صفحة الترحيب الخاصة بـ Django. ## 4. إنشاء التطبيق الأول يمكن أن يتكون مشروع Django من عدة تطبيقات. كل تطبيق مسؤول عن وحدة وظيفية معينة. ### إنشاء تطبيق في دليل `myproject`، قم بتشغيل الأمر التالي لإنشاء تطبيق باسم `myapp`: ```bash python manage.py startapp myapp ``` سيؤدي ذلك إلى إنشاء دليل جديد باسم `myapp` في دليل مشروعك، وهيكلها مشابه لـ: ``` myapp/ migrations/ __init__.py admin.py apps.py models.py tests.py views.py ``` ### تعديل settings.py في `settings.py` قم بتسجيل تطبيقك. ابحث عن قائمة `INSTALLED_APPS` وأضف `'myapp',`: ```python INSTALLED_APPS = [ ... 'myapp', ] ``` ## 5. إنشاء العرض والقالب يستخدم Django نمط MVC، حيث يكمل العرض والقالب بعضهما البعض. ### إنشاء العرض في `myapp/views.py` قم بتعريف عرض بسيط: ```python from django.http import HttpResponse def home(request): return HttpResponse("Hello, Django!") ``` ### تكوين URL في دليل `myapp`، أنشئ ملفًا باسم `urls.py` وقم بتعيين توجيه URL: ```python from django.urls import path from . import views urlpatterns = [ path('', views.home, name='home'), ] ``` ثم في `urls.py` الخاص بالمشروع، قم بإدراج URL الخاص بـ `myapp`: ```python from django.contrib import admin from django.urls import include, path urlpatterns = [ path('admin/', admin.site.urls), path('', include('myapp.urls')), ] ``` ## 6. الوصول إلى صفحتك الآن، يمكنك إعادة تشغيل خادم التطوير وزيارة [http://127.0.0.1:8000/](http://127.0.0.1:8000/). يجب أن ترى رسالة "Hello, Django!". ## 7. إضافة دعم قاعدة البيانات يستخدم Django قاعدة بيانات SQLite بشكل افتراضي، ولكنه يدعم أيضًا قواعد بيانات أخرى مثل MySQL وPostgreSQL. إليك كيفية تكوين SQLite. ### إعداد قاعدة البيانات في `settings.py` ابحث عن قسم `DATABASES`، يبدو التكوين الافتراضي كالتالي: ```python DATABASES = { 'default': { 'ENGINE': 'django.db.backends.sqlite3', 'NAME': BASE_DIR / "db.sqlite3", } } ``` يمكنك تعديله حسب الحاجة إلى قاعدة بيانات أخرى. على سبيل المثال، لاستخدام PostgreSQL: ```python DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql', 'NAME': 'yourdbname', 'USER': 'yourusername', 'PASSWORD': 'yourpassword', 'HOST': 'localhost', 'PORT': '5432', } } ``` تأكد من تثبيت برنامج التشغيل المناسب لقاعدة البيانات، على سبيل المثال، بالنسبة لـ PostgreSQL، تحتاج إلى تثبيت `psycopg2`. ```bash pip install psycopg2 ``` ## 8. إنشاء نموذج وترحيل قاعدة البيانات بعد ذلك، دعنا نحدد نموذجًا بسيطًا ونقوم بترحيله إلى قاعدة البيانات. ### إنشاء النموذج في `myapp/models.py`، أضف الكود التالي لتعريف نموذج بسيط:

生成迁移

运行以下命令生成数据库迁移文件：

python manage.py makemigrations

然后，应用这些迁移：

python manage.py migrate

9. 创建管理员界面

Django 自带一个强大的管理员界面，方便你管理数据。

创建超级用户

通过以下命令创建管理员账户：

python manage.py createsuperuser

添加模型到管理界面

在 myapp/admin.py 中注册你的模型：

from django.contrib import admin
from .models import Item

admin.site.register(Item)

现在再次运行开发服务器，访问 http://127.0.0.1:8000/admin，使用创建的超级用户登录，你能看到刚刚注册的模型。

结语

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