解决Django FileField路径URL编码问题及FilePathField用法详解

Django FileField URL编码问题与解决方案

在使用Django处理FileField数据时，开发者常会遇到文件路径编码异常的情况。

数据库中存储的路径通常显示为原始格式，例如：D:\python项目\wxmkczpy\uploadfile\QQ截图20190210180915.png。

然而，当通过代码提取该路径字符串时，结果往往变为经过URL编码的形式。

具体表现为：D%3A/python%E9%A1%B9%E7%9B%AE/wxmkczpy/uploadfile/QQ%E6%88%AA%E5%9B%BE20190210180915.png。

这种现象属于标准的URL编码（Percent-encoding），会导致路径无法直接用于文件系统操作。

针对此问题，可以利用Python标准库urllib中的parse模块进行解码处理。

from urllib import parse
 
# Create your tests here.
a = "D%3A/python%E9%A1%B9%E7%9B%AE/wxmkczpy/uploadfile/QQ%E6%88%AA%E5%9B%BE20190210180915.png"
str3 = parse.unquote(a) #解码字符串
print(str3) 

执行测试脚本："C:\Program Files\Python36\python.exe" D:/python项目/wxmkczpy/wechat_app/tests.py，输出正确解码后的路径：D:/python项目/wxmkczpy/uploadfile/QQ截图20190210180915.png。

FilePathField字段参数详解

此外，了解Django中FilePathField字段的正确用法对于管理本地文件引用同样重要。

FilePathField的定义语法为：class FilePathField(path=None[, match=None, recursive=False, max_length=100, **options])。

该字段继承自CharField，其值被限制为文件系统中特定目录下的文件名。它包含三个主要参数，其中path为必填项。

FilePathField.path参数说明。

此为必填参数，指定FilePathField应获取其选择目录的绝对文件系统路径。例如设置为："/home/images"。

FilePathField.match参数说明。

此为可选参数，用于指定匹配文件名的正则表达式。需注意，正则表达式仅作用于基本文件名（basename），而非完整路径。例如模式"foo.*.txt$"可匹配名为foo23.txt的文件，但不会匹配bar.txt或foo23.png。

FilePathField.recursive参数说明。

此为可选参数，类型为布尔值（True或False），默认值为False。若设为True，则包含所有子目录的路径供选择。

FilePathField.allow_files参数说明。

此为可选参数，类型为布尔值（True或False），默认值为True。用于声明是否包含指定位置的文件。该参数与allow_folders中必须有一个为True。

FilePathField.allow_folders参数说明。

此为可选参数，类型为布尔值（True或False），默认值为False。用于声明是否包含指定位置的文件夹。该参数与allow_files中必须有一个为True。

上述参数可以组合使用，以满足不同的文件筛选需求。

需要特别注意的是，match参数仅匹配基本文件名（base filename），而不匹配整个文件路径（full path）。

示例配置：FilePathField(path="/home/images", match="foo.*", recursive=True)。

在此配置下，系统将匹配/home/images/foo.png，但不会匹配/home/images/foo/bar.png，因为规则仅允许匹配基本文件名（即foo.png和bar.png）。

FilePathField在数据库中对应varchar列，默认最大长度为100个字符。与其他字段类似，可通过max_length参数修改最大长度限制。

基于FilePathField的缩略图处理示例

大多数网站在上传图片时的处理逻辑如下：

上传大尺寸图片时，系统自动生成一张缩略图；网页展示时使用缩略图，而点击链接或查看大图时指向原始大尺寸图片的地址。

基于上述逻辑，在Django模型中定义主要字段的方式如下：

title = models.CharField(max_length = 120)
img = models.ImageField(upload_to = 'screenshots')
thumb = models.FilePathField(path = 'screenshots/thumb')

为何thumb字段不使用ImageField？因为考虑到Admin后台上传的是大图，而缩略图并非直接上传，而是由系统自动生成。具体处理逻辑如下（假设MEDIA_ROOT为/tmp，MEDIA_URL为http://localhost/media/）：

当图片（test.jpg）上传至MEDIA_ROOT/screenshots目录时，img对象的属性状态为：

img.name = screenshots/test.jpg, img.path = /tmp/screenshots/test.jpg, img.url = http://localhost/media/screenshots/test.jpg。

系统判断图片大小是否需要生成缩略图，若不需要，则直接复制img.path到thumb字段；若需要，则生成一张名为test-thumb.jpg的缩略图，并保存在screenshots/thumb目录下。

在网页模板中插入图片时，可使用以下代码片段：

<a href="{% object.img.url %}" rel="external nofollow" ><img title="{% object.title %}" src="{% object.thumb %}" alt="{% object.title %}"></a>

上述代码中，object表示一个ScreenShot实例。

以上关于解决Django FileField编码问题及FilePathField使用的全部内容，希望能对读者有所帮助，欢迎支持本站。