探索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 MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類