ImageField – Django模型
ImageField是一个FileField,其上传只限于图像格式。在上传文件之前,人们需要指定大量的设置,以便文件被安全地保存并能以方便的方式检索。这个字段的默认窗体部件是一个ClearableFileInput 。除了FileField可用的特殊属性外,ImageField也有高度和宽度属性。
ImageField需要Pillow库。要安装同样的运行。
pip install Pillow
语法
field_name = models.ImageField(upload_to=None, height_field=None, width_field=None, max_length=100, **options)
ImageField有以下可选参数:
ImageField.upload_to
这个属性提供了一种设置上传目录和文件名的方法,可以通过两种方式设置。在这两种情况下,该值都会传递给Storage.save()方法。如果你指定一个字符串值,它可能包含strftime()格式,它将被替换为文件上传的日期/时间(这样上传的文件就不会填满给定的目录)。比如说。
class MyModel(models.Model):
# file will be uploaded to MEDIA_ROOT / uploads
upload = models.ImageField(upload_to ='uploads/')
# or...
# file will be saved to MEDIA_ROOT / uploads / 2015 / 01 / 30
upload = models.ImageField(upload_to ='uploads/% Y/% m/% d/')
如果您使用的是默认的FileSystemStorage,那么该字符串值将被添加到MEDIA_ROOT路径中,以形成本地文件系统中上传文件的存储位置。如果您使用不同的存储,请查看该存储的文档,了解它如何处理upload_to。
upload_to也可以是一个可调用的,比如说一个函数。这将被调用以获得上传路径,包括文件名。这个可调用函数必须接受两个参数,并返回一个Unix风格的路径(带正斜杠),以传递给存储系统。这两个参数是
论据 | 说明 |
---|---|
instance | 定义ImageField的模型的一个实例。更具体地说,这是一个特定的实例,当前的文件正在被附加。 |
文件名 | 最初给该文件的文件名。在确定最终的目标路径时,可能会也可能不会考虑到这一点。 |
For example:
def user_directory_path(instance, filename):
# file will be uploaded to MEDIA_ROOT / user_<id>/<filename>
return 'user_{0}/{1}'.format(instance.user.id, filename)
class MyModel(models.Model):
upload = models.ImageField(upload_to = user_directory_path)
ImageField.height_field
模型字段的名称,每次保存模型实例时,该字段将自动填入图像的高度。
ImageField.width_field
模型字段的名称,该字段在每次保存模型实例时将自动填入图像的宽度。
Django模型ImageField的解释
用一个例子说明ImageField的情况。考虑一个名为geeksforgeeks的项目,有一个名为geeks的应用程序。
在geeks应用程序的models.py文件中输入以下代码。
from django.db import models
from django.db.models import Model
# Create your models here.
class GeeksModel(Model):
geeks_field = models.ImageField()
在INSTALLED_APPS中增加geek的应用程序。
# Application definition
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'geeks',
]
现在,当我们从终端运行makemigrations命令时。
Python manage.py makemigrations
在geeks目录下将创建一个名为migrations的新文件夹,其中有一个名为0001_initial.py的文件。
# Generated by Django 2.2.5 on 2019-09-25 06:00
from django.db import migrations, models
class Migration(migrations.Migration):
initial = True
dependencies = [
]
operations = [
migrations.CreateModel(
name ='GeeksModel',
fields =[
('id',
models.AutoField(
auto_created = True,
primary_key = True,
serialize = False,
verbose_name ='ID'
)),
('geeks_field', models.ImageField()),
],
),
]
Now run,
Python manage.py migrate
因此,当你在项目上运行迁移时,会创建一个geeks_field ImageField。它是一个用来存储有效图像文件的字段。
如何使用ImageField
ImageField用于将有效的图像文件存储到数据库中。人们可以在ImageField中存储任何类型的图像文件。让我们试着在上面创建的模型中存储一个图像。
- 要开始创建模型的实例,请使用以下命令创建一个管理账户。
Python manage.py createsuperuser
- 输入一个用户名、电子邮件和一个安全密码。然后在你的浏览器中输入以下网址。
http://localhost:8000/admin/
- 去添加在Geeks Models前面的。
- 选择你想上传的文件并点击保存。现在让我们在管理服务器中检查它。我们已经创建了一个GeeksModel的实例。