Django搭建我的博客：上傳頭像圖片

時間 2019-12-05

原文原文鏈接

到目前爲止咱們的博客處理的都是文字。現代互聯網早就進入了「讀圖」時代，圖片的維護、展現也就至關重要。html

上一章中預留了avatar字段，用來保存用戶上傳的頭像，如今咱們來實現這個功能。python

必要的設置

圖片屬於一種媒體文件，它與靜態文件相似，須要設置一個統一的目錄，便於集中存儲和訪問。git

這類須要框架統一設置的參數，固然應該在/my_blog/settings.py中。在底部加上：github

/my_blog/settings.py

...

# 媒體文件地址
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media/')

MEDIA_ROOT和MEDIA_URL是用戶上傳文件保存、訪問的位置：django

在前面的Profile中咱們設置了upload_to參數。有了這個參數，文件上傳後將自動保存到項目根目錄的media文件夾中。 os.path.join(MEDIA_ROOT, 'media/')指定了media文件夾的位置。
MEDIA_URL表明用戶經過URL來訪問這個本地地址的URL。設置好這個參數後，用戶就能夠經過解析url，很方便的獲取文件的地址。這樣作的好處是避免的硬編碼，讓代碼更容易維護。

Django框架擅長的是對邏輯的處理，而對圖片這類文件的處理則很是的耗時。所以在實際的生產環境中（即產品上線以後），一般是有專門的Web服務器來處理文件的訪問。服務器

而在開發階段咱們不會在乎效率問題，因此Django也提供了方法，讓開發服務器可以處理圖片。框架

在/my_blog/urls.py添加下面的語句：學習

/my_blog/urls.py

...
# 新引入的模塊
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    ...
]

#添加這行
urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

這樣就爲之後上傳的圖片配置好了URL路徑。網站

編寫MTV

回顧一下，avatar的字段已經在上一章寫好了：ui

/userprofile/models.py

...
class Profile(models.Model):
    ...
    avatar = models.ImageField(upload_to='avatar/%Y%m%d/', blank=True)
    ...

upload_to指定了圖片上傳的位置，即/media/avatar/%Y%m%d/。%Y%m%d是日期格式化的寫法，會最終格式化爲系統時間。好比說圖片上傳是2018年12月5日，則圖片會保存在/media/avatar/2018205/中。

注意 ImageField字段不會存儲圖片自己，而僅僅保存圖片的地址。
記得用pip指令安裝Pillow。

表單類在前面也寫好了，不用修改：

/userprofile/forms.py

...
class ProfileForm(forms.ModelForm):
    class Meta:
        model = Profile
        fields = ('phone', 'avatar', 'bio')

接着須要修改視圖，使之可以對圖片進行處理：

/userprofile/views.py

...
@login_required(login_url='/userprofile/login/')
def profile_edit(request, id):
    ...

    # 修改本行
    # 上傳的文件保存在 request.FILES 中，經過參數傳遞給表單類
    profile_form = ProfileForm(request.POST, request.FILES)

    if profile_form.is_valid():
        ...
        
        # 添加在 profile.bio = profile_cd['bio'] 後面
        # 若是 request.FILES 存在文件，則保存
        if 'avatar' in request.FILES:
            profile.avatar = profile_cd["avatar"]

        ...

表單上傳的文件對象存儲在類字典對象request.FILES中，所以須要修改表單類的參數，將它一併傳遞進去。
若是request.FILES中存在鍵爲avatar的元素，則將其賦值給profile.avatar（注意保存的是圖片地址）；不然不進行處理。

修改模板文件，添加代碼顯示、處理用戶的頭像：

/templates/userprofile/edit.html

...

{% if profile.avatar %}
    <div class="col-md-4">頭像</div>
    <img src="{{ profile.avatar.url }}" style="max-width: 20%; border-radius: 15%;" class="col-md-4">
{% else %}
    <h5 class="col-md-4">暫無頭像</h3>
{% endif %}
<br>
<br>
<form ... enctype="multipart/form-data">{% csrf_token %}
    <!-- avatar -->
    <div class="form-group">
        <label for="avatar">上傳頭像</label>
        <input type="file" class="form-control-file" name="avatar" id="avatar">
    </div>
    
    ...