探索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
  • 實用接地氣的 .NET 微服務框架
    前言 微服務架構已經成為搭建高效、可擴展系統的關鍵技術之一，然而，現有許多微服務框架往往過於複雜，使得我們普通開發者難以快速上手並體驗到微服務帶了的便利。為瞭解決這一問題，於是作者精心打造了一款最接地氣的 .NET 微服務框架，幫助我們輕鬆構建和管理微服務應用。 本框架不僅支持 Consul 服務註 ...
  • 基於surging的木舟IOT平臺如何添加網路組件
    先看一下效果吧: 如果不會寫動畫或者懶得寫動畫，就直接交給Blend來做吧; 其實Blend操作起來很簡單，有點類似於在操作PS，我們只需要設置關鍵幀，滑鼠點來點去就可以了，Blend會自動幫我們生成我們想要的動畫效果. 第一步：要創建一個空的WPF項目 第二步：右鍵我們的項目，在最下方有一個，在B ...
  • Prism:框架介紹與安裝
    Prism:框架介紹與安裝 什麼是Prism? Prism是一個用於在 WPF、Xamarin Form、Uno 平臺和 WinUI 中構建鬆散耦合、可維護和可測試的 XAML 應用程式框架 Github https://github.com/PrismLibrary/Prism NuGet htt ...
  • 不可不知的WPF畫筆（Brush）
    在WPF中，屏幕上的所有內容，都是通過畫筆（Brush）畫上去的。如按鈕的背景色，邊框，文本框的前景和形狀填充。藉助畫筆，可以繪製頁面上的所有UI對象。不同畫筆具有不同類型的輸出（ 如：某些畫筆使用純色繪製區域，其他畫筆使用漸變、圖案、圖像或繪圖）。 ...
  • .NET 8 高併發微服務電商系統實戰
    前言 嗨，大家好！推薦一個基於 .NET 8 的高併發微服務電商系統，涵蓋了商品、訂單、會員、服務、財務等50多種實用功能。 項目不僅使用了 .NET 8 的最新特性，還集成了AutoFac、DotLiquid、HangFire、Nlog、Jwt、LayUIAdmin、SqlSugar、MySQL、 ...
  • 基於surging 如何利用peerjs進行語音視頻通話
    本文主要介紹攝像頭（相機）如何採集數據，用於類似攝像頭本地顯示軟體，以及流媒體數據傳輸場景如傳屏、視訊會議等。 攝像頭採集有多種方案，如AForge.NET、WPFMediaKit、OpenCvSharp、EmguCv、DirectShow.NET、MediaCaptre（UWP），網上一些文章以及 ...
  • [WPF]數據綁定時為何會出現StringFormat失效
    前言 Seal-Report 是一款.NET 開源報表工具，擁有 1.4K Star。它提供了一個完整的框架，使用 C# 編寫，最新的版本採用的是 .NET 8.0 。 它能夠高效地從各種資料庫或 NoSQL 數據源生成日常報表，並支持執行複雜的報表任務。 其簡單易用的安裝過程和直觀的設計界面，我們 ...
  • NET Core 多身份校驗與策略模式
    背景需求： 系統需要對接到XXX官方的API，但因此官方對接以及管理都十分嚴格。而本人部門的系統中包含諸多子系統，系統間為了穩定，程式間多數固定Token+特殊驗證進行調用，且後期還要提供給其他兄弟部門系統共同調用。 原則上：每套系統都必須單獨接入到官方，但官方的接入複雜，還要官方指定機構認證的證書 ...
  • C#自定義控制項—轉換開關
    本文介紹下電腦設備關機的情況下如何通過網路喚醒設備，之前電源S狀態 電腦Power電源狀態- 唐宋元明清2188 - 博客園 (cnblogs.com) 有介紹過遠程喚醒設備，後面這倆天瞭解多了點所以單獨加個隨筆 設備關機的情況下，使用網路喚醒的前提條件： 1. 被喚醒設備需要支持這WakeOnL ...
  • .NET 8.0 前後分離快速開發框架
    前言 大家好，推薦一個.NET 8.0 為核心，結合前端 Vue 框架，實現了前後端完全分離的設計理念。它不僅提供了強大的基礎功能支持，如許可權管理、代碼生成器等，還通過採用主流技術和最佳實踐，顯著降低了開發難度，加快了項目交付速度。 如果你需要一個高效的開發解決方案，本框架能幫助大家輕鬆應對挑戰，實 ...
所有分類