File Uploads and Media Handling

# CHAPTER 14

File Uploads and Media Handling #

1. Introduction #

• Configure MEDIAROOT and MEDIAURL in settings.py.

4. Step 1: Installing Dependencies #

Open your terminal (with the virtual environment active):

pip install Pillow

5. Step 2: Configuring Media Settings #

Open core/settings.py and add these lines at the very bottom:

import os # Make sure this is imported at the top of the file!

# The URL prefix for media files (e.g., http://127.0.0.1:8000/media/profile.jpg)
MEDIA_URL = '/media/'

# The absolute filesystem path to the directory that will hold user-uploaded files.
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

6. Step 3: Serving Media in Development #

Open core/urls.py:

from django.contrib import admin
from django.urls import path, include
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    path('admin/', admin.site.urls),
    path('blog/', include('blog.urls')),
]

# ONLY DO THIS IN DEVELOPMENT!
if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

7. Step 4: Adding the ImageField #

Open blog/models.py:

class Post(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    
    # NEW FIELD: upload_to creates a subfolder inside the media folder
    cover_image = models.ImageField(upload_to='post_images/', default='default.jpg')
    
    date_posted = models.DateTimeField(default=timezone.now)

CRITICAL STEP: Because we changed models.py, we MUST update the database!

python manage.py makemigrations
python manage.py migrate

8. Step 5: Updating the Form and Template #

In post_form.html:

<!-- You MUST include enctype! -->
<form method="POST" enctype="multipart/form-data">
    {% csrf_token %}
    {{ form.as_p }}
    <button type="submit">Publish</button>
</form>

In views.py (Handling the POST): When files are uploaded, they are not inside request.POST. They are inside request.FILES.

def create_post(request):
    if request.method == 'POST':
        # MUST include request.FILES to bind the image data to the form
        form = PostForm(request.POST, request.FILES)
        if form.is_valid():
            form.save()
# ...

9. Step 6: Rendering the Image #

In post_detail.html:

<h1>{{ post.title }}</h1>
<!-- Access the image URL -->
<img src="{{ post.cover_image.url }}" alt="{{ post.title }} cover" width="400">
<p>{{ post.content }}</p>

10. Backend Workflow: Cloud Storage #

• Challenge: Log into the Django Admin panel. Create a new Post and upload an image using the Admin interface. Afterward, look at your project folder structure in your code editor. Verify that Django automatically created a media/postimages/ directory and physically placed the image file inside it.

14. MCQs with Answers #

15. Interview Questions #

• Q: Explain the conceptual difference between STATICROOT and MEDIAROOT in Django. What types of files belong in each directory?

• Q: Describe why serving media files locally from the Django development server is strictly disabled in production environments. What is the industry standard for handling user-uploaded media in production?

16. FAQs #

17. Summary #

18. Next Chapter Recommendation #