كيف تعمل نماذج Django؟

Question

Accepted Answer

نماذج Django **forms** تتعامل مع دورة حياة إدخال المستخدم بالكامل: تصيير حقول نماذج HTML، **التحقق من** صحة البيانات المرسلة، وتحويلها إلى قيم Python نظيفة. فهي تجردك من العمل المحتاج والمعرض للأخطاء في التعامل اليدوي مع الإدخال والتحقق — وهي ميزة إنتاجية وأمنية رئيسية. ## نموذج أساسي ```python from django import forms class ContactForm(forms.Form): name = forms.CharField(max_length=100) email = forms.EmailField() # validates email format age = forms.IntegerField(min_value=0, required=False) message = forms.CharField(widget=forms.Textarea) ``` كل حقل في النموذج يصرح بنوعه وقواعد التحقق. يمكن للنموذج أن يصيّر نفسه كـ HTML والتحقق من الإدخال مقابل تلك القواعد. ## التعامل مع نموذج في عرض (النمط القياسي) ```python def contact(request): if request.method == "POST": form = ContactForm(request.POST) # bind submitted data if form.is_valid(): # run validation # cleaned_data = validated, type-converted Python values name = form.cleaned_data["name"] send_email(form.cleaned_data) return redirect("success") else: form = ContactForm() # empty form for GET return render(request, "contact.html", {"form": form}) ``` الطرق الرئيسية: `is_valid()` تشغل التحقق، وعند النجاح `cleaned_data` يعطيك قيماً آمنة ومتحققاً منها ومحولة إلى الأنواع الصحيحة. عند الفشل، يحتفظ النموذج بالإدخال ويجمع رسائل الأخطاء. ## ModelForms — نماذج من الموديلات (DRY) ```python from django.forms import ModelForm class ArticleForm(ModelForm): class Meta: model = Article # build the form FROM a model fields = ["title", "body", "published"] # which fields to include # ModelForm can SAVE directly to the database def create(request): form = ArticleForm(request.POST) if form.is_valid(): form.save() # creates/updates the model instance! ``` **ModelForms** تولد نموذجاً تلقائياً من حقول الموديل ويمكنها الحفظ مباشرة إلى قاعدة البيانات — تجسد مبدأ DRY (الموديل يدفع النموذج)، مما يلغي الكود المتكرر لنماذج CRUD. ## التحقق المخصص ```python class SignupForm(forms.Form): password = forms.CharField() confirm = forms.CharField() def clean_password(self): # field-level validation pw = self.cleaned_data["password"] if len(pw) < 8: raise forms.ValidationError("Too short") return pw def clean(self): # form-level (cross-field) validation data = super().clean() if data.get("password") != data.get("confirm"): raise forms.ValidationError("Passwords don't match") ``` ## التصيير والأمن ```html ``` تتكامل النماذج مع حماية **CSRF** في Django (`{% csrf_token %}`) وتصيّر الحقول تلقائياً مع أخطاء التحقق الخاصة بها. ## لماذا يهم هذا نماذج Django هي ميزة أساسية للتعامل مع إدخال المستخدم بأمان وإنتاجية — والتعامل الصحيح مع الإدخال هو في نفس الوقت شامل (تقريباً كل تطبيق يحتوي على نماذج) وحساس من ناحية الأمن. فهم النماذج ضروري لأنها تجردك من العمل المحتاج والمعرض للأخطاء في معالجة الإدخال: تصيير حقول HTML، **التحقق من** البيانات مقابل القواعد، تحويلها إلى قيم Python نظيفة منمطة (`cleaned_data`)، الحفاظ على الإدخال وسطح الأخطاء عند الفشل، والحماية من الهجمات. جانب التحقق مهم بشكل خاص للـ **أمن والقوة** — النماذج تضمن أنك لا تثق أبداً بإدخال المستخدم الخام، لاكتشاف البيانات المشوهة أو الضارة قبل وصولها إلى منطق عملك. **ModelForms** هي فائز إنتاجية كبير، تجسد DRY بتوليد نماذج مباشرة من الموديلات والحفظ إلى قاعدة البيانات مع أقل كود — مما يلغي الكود المتكرر للحالة الشديدة الشيوع لنماذج CRUD. معرفة النمط القياسي للعرض (`is_valid()` + `cleaned_data`)، كيفية إضافة التحقق المخصص على مستوى الحقول والتحقق بين الحقول، ModelForms للنماذج المدعومة بالموديلات، والتكامل مع حماية **CSRF** أساسية لبناء أي تطبيق Django يقبل إدخال المستخدم. تربط النماذج بين معالجة الإدخال والتحقق والأمن وطبقة الموديل، مما يجعلها جزءاً مهماً وكثير الاستخدام من الإطار وسبباً رئيسياً لكون Django منتجاً جداً لتطبيقات الإدخال الثقيلة للبيانات.