Django FilePathField 字段详解与图片缩略图处理实践

FilePathField 字段定义与核心参数

class FilePathField(path=None[, match=None, recursive=False, max_length=100, **options])

这是一个继承自 CharField 的字段，其值被限制为文件系统中特定目录下的文件名。该字段包含三个关键参数，其中第一个参数是必须提供的：

FilePathField.path

这是必填参数，用于指定 FilePathField 应该获取其选择目录的绝对文件系统路径。例如："/home/images"。

FilePathField.match

这是一个可选参数。FilePathField 会将此参数视为正则表达式来匹配文件名。需要注意的是，正则表达式仅作用于基本文件名，而非完整路径。例如："foo.*.txt$" 将匹配名为 foo23.txt 的文件，但不会匹配 bar.txt 或 foo23.png。

FilePathField.recursive

这是一个可选参数，取值为 True 或 False，默认为 False。它用于声明是否包含所有子目录的路径。

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最大长度。

图片上传与缩略图生成实战

大多数网站在插入图片时一般都是这样处理的：

上传大尺寸图时，自动生成一张缩略图；网页中插入缩略图，并把地址指向大尺寸的图。

所以在Django中，我这样定义主要字段：

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

为什么thumb不是ImageFiled呢？因为考虑到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。

FileField 与 ImageField 上传路径改写示例

补充知识：django FileFIeld和ImageField 上传路径改写

我就废话不多说了，大家还是直接看代码吧！

def get_file_path(instance, filename):
  return 'file/document/%s/%s/%s' % (instance.period.code, instance.student.college.code, filename)

class Document(models.Model):
  title = models.CharField(max_length=50, blank=True, verbose_name="文档名", default="")
  student = models.ForeignKey('accounts.Student', verbose_name="学生")
  period = models.ForeignKey('systemconfig.Periods', verbose_name="阶段")
  file = models.FileField(upload_to=get_file_path, verbose_name="文档", blank=True, null=True)
  mark = models.SmallIntegerField(null=True, blank=True, verbose_name="标记")
  create_time = models.DateTimeField(verbose_name="添加时间", auto_now_add=True)

  class Meta:
    verbose_name = "学生报告文档"
    verbose_name_plural = "学生报告文档"
重点就是get_file_path

def get_file_path(instance, filename):
return 'file/document/%s/%s/%s' % (instance.period.code, instance.student.college.code, filename)


class Document(models.Model):
  title = models.CharField(max_length=50, blank=True, verbose_name="文档名", default="")
  student = models.ForeignKey('accounts.Student', verbose_name="学生")
  period = models.ForeignKey('systemconfig.Periods', verbose_name="阶段")
  file = models.FileField(upload_to=get_file_path, verbose_name="文档", blank=True, null=True)
  mark = models.SmallIntegerField(null=True, blank=True, verbose_name="标记")
  create_time = models.DateTimeField(verbose_name="添加时间", auto_now_add=True)

class Meta:
    verbose_name = "学生报告文档"
verbose_name_plural = "学生报告文档"

以上这篇Django中FilePathField字段的用法就是小编分享给大家的全部内容了，希望能给大家一个参考，也希望大家多多支持本站。