ما الفرق بين الملفات الثابتة (Static) والملفات الإعلامية (Media)؟

Question

Accepted Answer

يميز Django بين نوعين من الملفات: **الملفات الثابتة** (الموارد التي تكون جزءًا من تطبيقك — CSS و JavaScript والصور التي تشحنها) و**ملفات الوسائط** (الملفات **التي يرفعها المستخدمون** في وقت التشغيل — صور الملف الشخصي والمستندات). يتم التعامل معها بشكل مختلف لأن مصادرها ودورات حياتها تختلف بشكل أساسي. ## الملفات الثابتة — موارد تطبيقك ```python # settings.py STATIC_URL = "/static/" STATICFILES_DIRS = [BASE_DIR / "static"] # where YOU put source static files STATIC_ROOT = BASE_DIR / "staticfiles" # where collectstatic GATHERS them for prod ``` ```html {% load static %}

``` الملفات الثابتة **جزء من مستودع الكود الخاص بك** — CSS و JS والخطوط والصور التصميمية. يتم التحكم في إصداراتها، وتكون متطابقة لجميع المستخدمين، وتُقدَّم من مجلدات static في مشروعك. ## collectstatic للإنتاج ```bash python manage.py collectstatic # gathers ALL static files (from your apps and STATICFILES_DIRS) into STATIC_ROOT, # so a web server / CDN can serve them efficiently in production ``` في بيئة الإنتاج، يقوم `collectstatic` بدمج الملفات الثابتة من جميع التطبيقات في مجلد واحد (`STATIC_ROOT`) ليتم تقديمها من قبل خادم الويب أو شبكة CDN — Django لا يقدمها بنفسه في الإنتاج. ## ملفات الوسائط — عمليات تحميل المستخدمين ```python # settings.py MEDIA_URL = "/media/" MEDIA_ROOT = BASE_DIR / "media" # where UPLOADED files are stored ``` ```python # a model with an uploadable file class Profile(models.Model): avatar = models.ImageField(upload_to="avatars/") # stored under MEDIA_ROOT/avatars/ document = models.FileField(upload_to="docs/") profile.avatar.url # the URL to access the uploaded file ``` ملفات الوسائط **يرفعها المستخدمون في وقت التشغيل** عبر `FileField`/`ImageField`. إنها ديناميكية، ليست في التحكم بالإصدارات، وتنمو بمرور الوقت مع قيام المستخدمين برفع محتوى. ## الاختلافات الرئيسية ```text Static files Media files Source part of your code uploaded by users at runtime Version control YES (committed) NO (user-generated, .gitignored) Lifecycle fixed (changes with code) dynamic (grows continuously) Examples CSS, JS, logos, fonts avatars, uploaded documents, photos Settings STATIC_URL/ROOT/DIRS MEDIA_URL/ROOT Production collectstatic + CDN/server stored on disk/cloud (S3), served carefully ``` ## اعتبارات الإنتاج ```text ✓ Static → serve via the web server (nginx) or a CDN (cached, fast) ✓ Media → store on cloud storage (S3) for scalability/persistence; in multi-server setups, local disk doesn't work (files must be shared) → use S3/object storage ✓ Security → VALIDATE uploaded files (type, size); be careful serving user uploads (a user could upload malicious content) ``` ## لماذا يهم فهم التمييز بين الثابتة والوسائط مهم لكل من بناء ونشر تطبيقات Django بشكل صحيح، حيث أن النوعين من الملفات لهما مصادر ودورات حياة ومتطلبات معالجة مختلفة بشكل أساسي. **الملفات الثابتة** (CSS و JavaScript والصور والخطوط الخاصة بتطبيقك) هي جزء من مستودع الكود، تحت التحكم بالإصدارات، وموحدة للجميع — ويتم الإشارة إليها عبر `{% static %}` ودمجها باستخدام `collectstatic` لتقديمها من قبل خادم ويب أو شبكة CDN في الإنتاج. **ملفات الوسائط** (عمليات تحميل المستخدمين عبر `FileField`/`ImageField`) هي محتوى ديناميكي من إنشاء المستخدمين يتم إنشاؤه في وقت التشغيل، ليست في التحكم بالإصدارات، وتنمو بشكل مستمر. الخلط بينهما أو إساءة تكوين إعداداتهما (`STATIC_*` مقابل `MEDIA_*`) هو مصدر شائع لمشاكل "CSS الخاص بي لا يتم تحميله" أو "عمليات التحميل لا تعمل"، خاصة في الإنتاج حيث لا يقوم Django بتقديم الملفات الثابتة بنفسه (مما يتطلب `collectstatic` وخادمًا/CDN مناسبًا). التمييز له أيضًا **آثار مهمة على الإنتاج والأمان**: لا يمكن لملفات الوسائط في نشر خوادم متعددة الاعتماد على القرص المحلي (يجب أن تستخدم تخزينًا سحابيًا مشتركًا مثل S3)، وتحميلات المستخدمين تتطلب **التحقق من الصحة** (نوع الملف والحجم) والتقديم الحذر لتجنب مخاطر الأمان من المحتوى الضار. معرفة كيفية تكوين والتعامل مع كلا النوعين، ودور `collectstatic`، واعتبارات الإنتاج (CDN للملفات الثابتة، التخزين السحابي للوسائط، أمان التحميل) هي معرفة عملية متكررة الاحتياج لبناء ونشر تطبيقات Django الحقيقية بشكل صحيح — عقبة شائعة يحل هذا الفهم محلها.