探索Django：從項目創建到圖片上傳的全方位指南

来源:https://www.cnblogs.com/guoxiaoyu/p/18187177
-Advertisement-
Play Games

通過本文，我們深入瞭解了 Django 框架的一些基本概念和使用方法，以及如何利用 Django 構建一個簡單的圖像上傳應用程式。從項目創建到環境配置，再到 admin 端圖像處理和用戶圖片上傳，我們逐步學習瞭如何利用 Django 提供的功能快速搭建 Web 應用。無論是對於初學者還是有一定經驗的... ...


Django是什麼

Django 是一個流行的 Python Web 開發框架，它提供了一系列工具和庫，用於幫助開發人員構建高效、可擴展的 Web 應用程式。Django 的目標是讓開發者能夠以快速和簡單的方式構建複雜的 Web 應用，通過提供許多預構建的組件和功能，如 ORM（對象關係映射）、表單處理、認證系統、管理界面等，從而降低了開發工作的複雜性。

今天，我們將會以一個示例為例，來演示關於圖像上傳的操作。

項目創建

前提條件

要順利完成本教程，你需要具備以下條件：

  1. 扎實的 Python 和 Django 基礎知識，包括但不限於 Django 的模型、視圖、模板以及表單等方面的理解。
  2. 一個代碼編輯器，比如 Visual Studio Code，它能夠提供豐富的編輯功能和便捷的開發環境，有助於你更高效地編寫和調試代碼。

環境配置

首先，要在新項目中執行以下命令：

pip install django

安裝完成後，我們現在開始執行以下步驟，以創建一個名為 xiaoYuGallery 的 Django 項目：

django-admin startproject xiaoYuGallery
cd xiaoYuGallery
py manage.py startapp demo

admin端圖像處理

現在，我們需要打開位於項目目錄下的 settings.py 文件，併在已安裝應用程式列表 (INSTALLED_APPS) 中進行註冊，以便將我們的 demo 應用程式納入其中。請參考下麵的示例代碼：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'demo',  # 這是我們新增的應用程式
]

確保在列表中添加 demo 這一行，並且位於其他 Django 內置應用程式的下方，這樣可以確保我們的應用程式能夠正確載入和運行。

當我們配置Django時，我們必須明確指定媒體文件的URL和存儲位置。這可以通過設置MEDIA_URL和MEDIA_ROOT來完成。因此，在settings.py文件中，我們需要添加以下內容：

import os

MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

為了確保用戶在開發過程中能夠上傳圖片，我們需要在項目級的urls.py文件中進行相應設置，以便進行測試。

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

urlpatterns = [
    path('admin/', admin.site.urls),
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

在models.py文件中，使用Django框架中的模型類來定義一個名為Image的模型。在這個模型中，我們定義了兩個欄位：

  1. title：這是一個CharField欄位，用於存儲圖片的標題。max_length參數指定了該欄位的最大長度為20個字元。
  2. photo：這是一個ImageField欄位，用於存儲圖片文件。upload_to參數指定了上傳圖片時的存儲路徑，這裡設置為'pics'，意味著上傳的圖片將會保存在項目中的'pics'文件夾下。

這個模型將允許我們在資料庫中存儲圖片的標題和相應的圖片文件，並且可以通過Django的ORM（對象關係映射）進行管理和操作。

from django.db import models

class Image(models.Model):
    title = models.CharField(max_length=20)
    photo = models.ImageField(upload_to='pics')

在admin.py 中我們定義了一個名為imageAdmin的類，它繼承自admin.ModelAdmin。在這個類中，我們可以自定義模型在後臺管理界面中的顯示方式。在這個例子中，我們通過設置list_display屬性，指定了在Image模型的列表頁面中顯示哪些欄位。在這裡，我們希望顯示圖片的標題和對應的圖片文件。

最後，我們使用admin.site.register()函數將Image模型和imageAdmin類關聯起來，這樣就可以在後臺管理界面中對Image模型進行管理，並且按照我們定義的方式進行顯示。

from django.contrib import admin
from .models import Image

class imageAdmin(admin.ModelAdmin):
    list_display = ["title", "photo"]

admin.site.register(Image, imageAdmin)

在views.py ，我們添加這段代碼，它是一個Django視圖函數，用於處理用戶請求並返回相應的網頁內容。

from django.shortcuts import render
from .models import Image

# Create your views here.
def index(request):
    data = Image.objects.all()
    context = {
        'data' : data
    }
    return render(request,"display.html", context)
  1. def index(request):: 這是一個名為index的視圖函數，它接收一個request對象作為參數，該對象包含了用戶請求的所有信息。
  2. data = Image.objects.all(): 這一行代碼通過Image模型的objects管理器調用all()方法，從資料庫中獲取了所有的Image對象，並將它們存儲在名為data的變數中。
  3. context = {'data': data}: 這行代碼創建了一個字典context，其中鍵為'data'，值為之前獲取的所有Image對象。這個字典將被傳遞給模板，以便在HTML頁面中使用這些數據。
  4. return render(request, "display.html", context): 最後一行代碼調用了render函數，它接收了三個參數：request對象、要渲染的HTML模板文件名（在這裡是"display.html"），以及要傳遞給模板的上下文數據。該函數將使用指定的模板和上下文數據渲染HTML頁面，並將渲染後的頁面作為HTTP響應返回給用戶的瀏覽器。

在display.html 裡面渲染頁面

<!doctype html>
<html lang="en">
<head>
    <!-- Required meta tags -->
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <!-- Bootstrap CSS -->
    <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">

    <title>Demo Gallery</title>
</head>
<body class="container" style="padding-top: 5%;">
<div class="row">
    {% for x in data %}
    <div class="col-md-4">
        <div class="card mb-4">
            <img src="{{ x.photo.url }}" class="card-img-top" alt="{{ x.title }}">
            <div class="card-body">
                <h5 class="card-title">{{ x.title }}</h5>
            </div>
        </div>
    </div>
    {% endfor %}
</div>

<!-- Bootstrap Bundle with Popper -->
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.bundle.min.js"></script>
</body>
</html>

urls.py中配置URLs

  1. path('admin/', admin.site.urls),：將 admin 應用的 URL 映射到 Django 自帶的管理頁面。這使得你可以通過 yourdomain.com/admin/ 訪問管理員界面。
  2. path('', include('demo.urls'))：將根 URL 映射到名為 demo 的應用程式的 URL 配置。這意味著所有根 URL 請求（例如 yourdomain.com/）將被傳遞給 demo 應用程式的 URL 配置以進一步處理。
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('', include('demo.urls')) # new
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

顯示圖片

執行一下進行資料庫遷移的命令：

py manage.py makemigrations：這個命令告訴 Django 你對模型進行了更改，並且需要將這些更改記錄下來以便在資料庫中進行更新。

py manage.py migrate：Django 會讀取之前生成的遷移文件，並根據這些文件中的指令，在資料庫中執行相應的更改，例如創建新的表、修改表結構或添加新的欄位等。

py manage.py createsuperuser

當你運行這個命令時，Django 會提示你輸入超級用戶的用戶名、電子郵件地址和密碼。輸入完畢後，Django 將會在資料庫中創建一個新的超級用戶，並使用你提供的信息設置其登錄憑據。這個超級用戶可以用來登錄到 Django 的後臺管理界面，進行網站管理和維護工作。

啟動服務，一旦伺服器啟動，你就可以在瀏覽器中訪問你的 Django 項目，併在開發環境中進行測試和調試。預設情況下，開發伺服器會監聽本地主機的 8000 埠，你可以通過在瀏覽器中輸入 http://127.0.0.1:8000/ 或 http://localhost:8000/ 來訪問你的網站。

py manage.py runserver

看下管理後臺效果，點擊add也會進行添加圖片。

image

用戶圖片上傳

在這個示例中，我們將創建一個名為 forms.py 的文件，併在其中定義一個用於處理上傳表單的類，將其與我們的 Image 模型相關聯。這樣做可以確保我們的代碼結構清晰，易於維護和擴展。

  1. class Meta:：這是一個內部類，用於提供關於該表單的元數據。在這個內部類中，我們可以指定與表單相關的元信息。
  2. model = Image：在 Meta 類中，這行代碼指定了表單對應的模型是 Image。這意味著表單將基於 Image 模型生成欄位。
  3. fields = ['title', 'photo']：這行代碼指定了表單中應該顯示的欄位。在這個例子中，表單中將包含名為 'title' 和 'photo' 的欄位，這與 Image 模型中定義的欄位相對應。
from django import forms
from .models import Image

class ImageUploadForm(forms.ModelForm):
    class Meta:
        model = Image
        fields = ['title', 'photo']

在您的項目的templates文件夾中，您可以添加一個名為upload.html的文件。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Image Upload</title>
    <style>
        body {
            font-family: Arial, sans-serif;
            margin: 0;
            padding: 0;
            background-color: #f4f4f4;
            display: flex;
            justify-content: center;
            align-items: center;
            height: 100vh;
        }
        form {
            background-color: #fff;
            padding: 20px;
            border-radius: 8px;
            box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
            width: 300px;
        }
        input[type="file"] {
            margin-bottom: 10px;
        }
        button[type="submit"] {
            background-color: #007bff;
            color: #fff;
            border: none;
            padding: 10px 20px;
            border-radius: 5px;
            cursor: pointer;
            transition: background-color 0.3s ease;
        }
        button[type="submit"]:hover {
            background-color: #0056b3;
        }
    </style>
</head>
<body>
    <form method="POST" enctype="multipart/form-data">
        {% csrf_token %}
        {{ form.as_p }}
        <button type="submit"> Upload Image </button>
    </form>
</body>
</html>

在views.py更新下代碼

def uploadView(request):                                      
    if request.method == 'POST':
        form = ImageUploadForm(request.POST, request.FILES)#如果請求方法為 POST，這一行創建一個 `ImageUploadForm` 的實例，通過將 `request.POST` 和 `request.FILES` 傳遞給它來填充表單數據。`request.POST` 包含用戶通過 POST 方法提交的表單數據，而 `request.FILES` 包含用戶上傳的文件數據。
        if form.is_valid(): #這一行檢查表單數據是否有效，即是否通過了表單的驗證。
            form.save()#如果表單數據有效，這一行將保存表單數據到資料庫中。
            return redirect('index')
    else:
            form = ImageUploadForm()
    return render(request, 'upload.html', {'form': form})

demo文件中更新下urls.py

from django.urls import path
from .import views

urlpatterns = [
    path('', views.index, name='index'),
    path('upload_image/', views.uploadView, name= 'upload_image') 
]

我們來看下效果：

image

首頁效果：

image

結語

通過本文，我們深入瞭解了 Django 框架的一些基本概念和使用方法，以及如何利用 Django 構建一個簡單的圖像上傳應用程式。從項目創建到環境配置，再到 admin 端圖像處理和用戶圖片上傳，我們逐步學習瞭如何利用 Django 提供的功能快速搭建 Web 應用。無論是對於初學者還是有一定經驗的開發者，掌握 Django 都能夠幫助我們更高效地開發出高質量的 Web 應用。希望本文能夠為您提供一些幫助和啟發，讓您更加深入地瞭解 Django，並能夠在實際項目中運用所學知識。

我是努力的小雨，一名 Java 服務端碼農，潛心研究著 AI 技術的奧秘。我熱愛技術交流與分享，對開源社區充滿熱情。身兼掘金優秀作者、騰訊雲內容共創官、阿裡雲專家博主、華為云云享專家等多重身份。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • JPEG庫的移植（arm平臺）
    JPEG庫的移植（arm平臺） 目錄JPEG庫的移植（arm平臺）介紹頭文件及全局變數1、圖片顯示2、其他圖片壓縮到jpg圖片3、主函數及驗證程式輸出結果 介紹 圖解 頭文件及全局變數 #include <stdio.h> #include <stdlib.h> #include <sys/type ...
  • Vue3學習（二十四）- 文檔頁面功能開發
    寫在前面 這部分真的感覺超級難，其實也不能說難，主要是真的想不到這個思路應該這麼做，或者說他好厲害，他怎麼知道該這麼設計實現。 說下難點吧，我覺得後天邏輯還好，主要是前端部分真的需要點花點時間來思考，比如佈局、交互設計的實現等等。 文檔頁面功能開發 1、任務拆解 增加文檔頁面，首頁點擊電子書時，跳轉 ...
  • NumPy 數組複製與視圖詳解
    NumPy 數組的複製與視圖 NumPy 數組的複製和視圖是兩種不同的方式來創建新數組，它們之間存在著重要的區別。 複製 複製 會創建一個包含原始數組相同元素的新數組，但這兩個數組擁有獨立的記憶體空間。這意味著對複製進行的任何更改都不會影響原始數組，反之亦然。 創建副本可以使用以下方法： arr.co ...
  • Django 安全性與防禦性編程：如何保護 Django Web 應用
    title: Django 安全性與防禦性編程：如何保護 Django Web 應用 date: 2024/5/13 20:26:58 updated: 2024/5/13 20:26:58 categories: 後端開發 tags: CSRF XSS SQL Upload HTTPOnly Pa ...
  • SpringCache
    正文 感覺自己這兩天摸魚有些嚴重（笑。 前兩天有件事忘了寫了。周六晚去吃飯和拍照的時候，看見有個女生坐在路邊，紅著眼睛跟誰打電話，語氣裡帶一股哭腔。身上穿著校服，我想應該是高中生。身邊沒有人。我不知道什麼事情能讓人發火又哭泣，覺得有些奇怪，也不知道怎麼寬慰這個陌生人。想了想，跑去小賣部買了瓶怡寶，放 ...
  • 使用 Python 旋轉PDF頁面、或調整PDF頁面順序
    在將紙質文檔掃描成PDF電子文檔時，有時可能會出現頁面方向翻轉或者頁面順序混亂的情況。為了確保更好地瀏覽和查看PDF文件，本文將分享一個使用Python來旋轉PDF頁面或者調整PDF頁面順序的解決方案。 要實現Python對PDF頁面進行設置，我們需要用到第三方庫 Spire.PDF for Pyt ...
  • Redis網路模型
    theme: condensed-night-purple highlight: androidstudio 主從複製原理 建立連接 從節點在配置了 replicaof 配置了主節點的ip和port 從庫執行replicaof 併發送psync命令 同步數據到從庫 主庫bgsave生成RDB文件，並 ...
  • Java Chassis 3：介面維度負載均衡
    Java Chassis 3通過介面維度負載均衡的策略設置，為不同的應用場景提供了非常強大的負載均衡管理能力，幫助解決負載不均衡、會話粘滯等應用負載問題。 ...
一周排行
    -Advertisement-
    Play Games
  • （開源）都進來！簡單易懂、功能強大的許可權+可視化流程管理系統
    1、預覽地址：http://139.155.137.144:9012 2、qq群:801913255 一、前言 隨著網路的發展，企業對於信息系統數據的保密工作愈發重視，不同身份、角色對於數據的訪問許可權都應該大相徑庭。 列如 1、不同登錄人員對一個數據列表的可見度是不一樣的，如數據列、數據行、數據按鈕 ...
  • 設計模式-C#實現簡單工廠模式
    前言 上一篇文章寫瞭如何使用RabbitMQ做個簡單的發送郵件項目，然後評論也是比較多，也是準備去學習一下如何確保RabbitMQ的消息可靠性，但是由於時間原因，先來說說設計模式中的簡單工廠模式吧！ 在瞭解簡單工廠模式之前，我們要知道C#是一款面向對象的高級程式語言。它有3大特性，封裝、繼承、多態。 ...
  • Nodify學習 一：介紹與使用
    Nodify學習 一：介紹與使用 - 可樂_加冰 - 博客園 (cnblogs.com) Nodify學習 二：添加節點 - 可樂_加冰 - 博客園 (cnblogs.com) 介紹 Nodify是一個WPF基於節點的編輯器控制項，其中包含一系列節點、連接和連接器組件，旨在簡化構建基於節點的工具的過程 ...
  • 使用C#/.NET解析Wiki百科數據實現獲取歷史上的今天
    創建一個webapi項目做測試使用。 創建新控制器，搭建一個基礎框架，包括獲取當天日期、wiki的請求地址等 創建一個Http請求幫助類以及方法，用於獲取指定URL的信息 使用http請求訪問指定url，先運行一下，看看返回的內容。內容如圖右邊所示，實際上是一個Json數據。我們主要解析 大事記 部 ...
  • .NET科普：.NET簡史、.NET Standard以及C#和.NET Framework之間的關係
    最近在不少自媒體上看到有關.NET與C#的資訊與評價，感覺大家對.NET與C#還是不太瞭解，尤其是對2016年6月發佈的跨平臺.NET Core 1.0，更是知之甚少。在考慮一番之後，還是決定寫點東西總結一下，也回顧一下.NET的發展歷史。 首先，你沒看錯，.NET是跨平臺的，可以在Windows、 ...
  • Nodify學習 二：添加節點
    Nodify學習 一：介紹與使用 - 可樂_加冰 - 博客園 (cnblogs.com) Nodify學習 二：添加節點 - 可樂_加冰 - 博客園 (cnblogs.com) 添加節點（nodes） 通過上一篇我們已經創建好了編輯器實例現在我們為編輯器添加一個節點 添加model和viewmode ...
  • 論如何直接用EF Core實現創建更新時間、用戶審計，自動化樂觀併發、軟刪除和樹形查詢（上）
    前言 資料庫併發，數據審計和軟刪除一直是數據持久化方面的經典問題。早些時候，這些工作需要手寫複雜的SQL或者通過存儲過程和觸發器實現。手寫複雜SQL對軟體可維護性構成了相當大的挑戰，隨著SQL字數的變多，用到的嵌套和複雜語法增加，可讀性和可維護性的難度是幾何級暴漲。因此如何在實現功能的同時控制這些S ...
  • C# 使用模式匹配的好處,因為好用所以推薦~
    類型檢查和轉換：當你需要檢查對象是否為特定類型，並且希望在同一時間內將其轉換為那個類型時，模式匹配提供了一種更簡潔的方式來完成這一任務，避免了使用傳統的as和is操作符後還需要進行額外的null檢查。 複雜條件邏輯：在處理複雜的條件邏輯時，特別是涉及到多個條件和類型的情況下，使用模式匹配可以使代碼更 ...
  • 推薦一種批量判斷文件是否存在的快速辦法
    在日常開發中，我們經常需要和文件打交道，特別是桌面開發，有時候就會需要載入大批量的文件，而且可能還會存在部分文件缺失的情況，那麼如何才能快速的判斷文件是否存在呢？如果處理不當的，且文件數量比較多的時候，可能會造成卡頓等情況，進而影響程式的使用體驗。今天就以一個簡單的小例子，簡述兩種不同的判斷文件是否... ...
  • 論如何直接用EF Core實現創建更新時間、用戶審計，自動化樂觀併發、軟刪除和樹形查詢（中）
    前言 資料庫併發，數據審計和軟刪除一直是數據持久化方面的經典問題。早些時候，這些工作需要手寫複雜的SQL或者通過存儲過程和觸發器實現。手寫複雜SQL對軟體可維護性構成了相當大的挑戰，隨著SQL字數的變多，用到的嵌套和複雜語法增加，可讀性和可維護性的難度是幾何級暴漲。因此如何在實現功能的同時控制這些S ...
所有分類