使用django的ImageField和from制作上传图片页面

需求描述:

做一个简单的注册页面,使得用户在注册页上传头像。

解决办法:

以前用java写这个的时候,在action上面需要用IO接受文件,然后生成一个文件名,再将文件相对路径保存到user表的img字段中。

而在django的model层上,有一个叫做ImageField的字段(还有FileField,两者几乎一样),看了文档中对于这个字段的描述,大致意思就是自动将文件保存在media的文件夹里面,然后产生的文件路径保存到一个var char的字段中。如果一个model有ImageField字段,则在其对应表里面就会有一个var char字段,正是用于保存路径的。

1.设置setting中的MEDIA_ROOT:

如果使用django的快捷方法,那么所有用户上传的文件应该都会被保存到MEDIA_ROOT定义的文件夹中去。注意这里需要绝对路径。我的设置是:

# in settings.py

HERE = os.path.dirname(os.path.abspath(__file__))

MEDIA_ROOT = os.path.join(HERE,'media').replace('\\','/')+'/'

这样就能将MEDIA_ROOT设置为项目目录下的media目录。注意最后的斜杠,如果不加最后的斜杠,那么在保存的时候会出现奇怪的错误。

2.设置model:

为了方便,自己建了一个User的Model:

# in myapp1/models.py

class User(models.Model):

    name = models.CharField(max_length=30)

    password = models.CharField(max_length=30)

    GENDER_CHOICE = (

        (u'M', u'Male'),

        (u'F', u'Female'),

    )

    gender = models.CharField(max_length=2,choices = GENDER_CHOICE)

    birthday = models.DateField(null=True)

    img = models.ImageField(upload_to='photo',null=True,blank=True)

    phoneNum = models.CharField(max_length=13,null=True,blank=True)

    email = models.EmailField(null=True,blank=True)

    hobbies = models.CharField(max_length=100,null=True,blank=True)

    regTime = models.DateTimeField(null=True,blank=True)

    bio = models.TextField(null = True,blank=True)

    def __unicode__(self):

        return self.name

这里要注意的地方是null=True之后,要也要加上blank=True。其中null=True是针对数据库的,而blank=True是针对validation的。如果blank=True没加,那么在下面做form的时候,省略字段的话验证不会通过。

这里面有一个img字段,是ImageField类型的,这个在快速制作上传图片的表单里起了至关重要的作用。里面有一句upload_to='xxxxx',是指文件保存在MEDIA_ROOT中的哪个子目录下。

3.设置forms from models:

django有一个form类,这个类抽象出了html的form。用在view里的话,就能在template里生成form的html。但是可以发现用户注册时,表单的字段和model的字段非常相似,所以可以通过model生成form类。

而model类里面并不是所有的内容都需要用户填写,比如regTime就不需要。这时候可以指定那些字段会成为form字段(使用fields=(xxxx)),或者可以指定哪些字段不会成为form字段(使用exclude=(xxx))。这里,我们似乎只有一个regTime不需要显示。

另外,我们的model里面password字段是CharField,django不会聪明到通过变量名的意思来生成form,所以默认生成出来的会是input type="text"的表单,我们需要通过一种方法修改掉它。综上所述,最后的form代码是这样的:

# in myapp1/models.py

from django.db import models

from django.forms import ModelForm

from django import forms

class UserForm(ModelForm):

    class Meta:

        model = User #通过上面的User Model生成表单

        exclude =('regTime')#将regTime字段排除在外

        widgets = {

            'password':forms.PasswordInput(),#将password字段的input type设为password

        }

这样就能生成一个简单的form了。forms from models和普通的form类有一个区别,就是它有save()方法,这个方法在view中将会被使用。

4.在view里调用form

这里,假设注册页面为/reg/。如果使用get方法,则浏览器中给出注册表单,如果用post方法,则将表单内容保存到数据库。

如果使用forms from models,则在view上面将会非常的简单:

#in myapp1/views.py

def reg(request):

    if request.method == 'POST':#提交表单

        form = models.UserForm(request.POST,request.FILES)#如果表单中要传文件、图片,则需要传两个参数

        if form.is_valid():#这个is_valid通过model的配置定义,这里显现出blank=True的意义了

            form.save()#这一句save,不但保存了各个字段,而且自动将上传的文件保存到指定目录,并且生成文件路径,保存到user表的img字段中了。

    else:#显示表单

        form = models.UserForm()

    return render_to_response('reg_form.html', {'form': form})

5.template中的使用:

<body>

    <form enctype="multipart/form-data" action="/reg/" method="post">

        {{ form.as_p }}

        <input type="submit" value="Submit" />

    </form>

</body>

这里和普通form是一样的。当然也可以手动设置格式,详见文档。

最后再配置一下urlpattern,就能在这个表单上传图片了。

不足:

单单这样做注册表单有个不足之处,就是没有confirm password这个字段。不过我们可以在UserForm类中增加一个表单字段,最后结果会是:

class UserForm(ModelForm):

    confirm_password = forms.CharField(widget=forms.PasswordInput())

    class Meta:

        model = User

        exclude('regTime')

        widgets = {

            'password':forms.PasswordInput(),

        }

不过这样一来,template中生成的表单,会把confirm_password字段放在最下面。所以得手动设定格式。另外,form.is_valid()也不会监测password和它是不是一样,需要在后面手动加逻辑。

上面的方法不一定是最好的,不过也提供了一些思路。另外,即便是不使用forms from models,也可以方便的使用ImageField保存图片: 

碰到的问题:

和MEDIA_ROOT对应有一个MEDIA_URL。按照道理说,MEDIA_ROOT是一个public的文件夹,不需要通过urlpatterns映射就能直接访问里面的文件(至少django 1.3里面STATIC_ROOT加上STATIC_URL可以做到这点),但是我测试了好几次,都还是经过了url映射才可以。目前暂时不知道怎么解决。

注意:

通过阅读文档,对MEDIA_URL的问题有了进一步的了解:django不会自动开放这个目录作为静态文件目录。在开发阶段,要使用urlpatterns映射。
但是这样仅限于开发阶段(static files也一样),按照django官方的说法,用urlpatterns映射静态文件的方法是“效率非常低”,进入使用阶段后,需要将media_root和static_root发布到“真正的静态文件服务器”。这也是为什么django本身提供static文件扫描,却又提供了python manage.py collectstatic这个命令来汇集各个app的static文件到static_root文件夹。

原文地址:https://www.cnblogs.com/chenjianhong/p/4145146.html