引用：
from django.db import models
创建：
在models.py中创建的每一个类都为表，类变量即为表字段，类变量赋予的值相当于字段属性。models.Model
字段说明：
| - | 类型名称 | 类方法 | widget | 必填参数 |
| 数值型 | int自增列 | AutoField | TextInput | primary_key=True |
| bigint自增列 | BigAutoField | TextInput | primary_key=True | |
| 小整数(32768～32767) | SmallIntegerField | TextInput | ||
| 正小整型(0~32767) | PositiveSmallIntegerField | TextInput | ||
| 整数(-2147483648~2147483647) | IntegerField | TextInput | ||
| 正整数(0～2147483647) | PositiveIntegerField | TextInput | ||
| 长整型(-9223372036854775808～9223372036854775807) | BigIntegerField | TextInput | ||
| 浮点型 | FloatField | TextInput | ||
| 10进制小数 | DecimalField | TextInput |
max_digits： 小数总长度 |
|
| 二进制类型 | BinaryField | TextInput | ||
| 字符型 | 字符型 | CharField | TextInput | max_length |
| 文本类型 | TextField | Textarea | ||
| Email类型（字符串） | EmailField | TextInput | ||
| IP4&6类型（字符串） | GenericIPAddressField | TextInput | ||
| URL类型（字符型） | URLField | TextInput | ||
| 字母、数字、下划线、连接符（减号） | SlugField | TextInput | ||
| 逗号分割的数字 | CommaSeparatedIntegerField | TextInput | max_length | |
| UUID类型（字符型） | UUIDField | TextInput | ||
| 文件型 | 提供读取文件夹下文件 | FilePathField | CharField |
path |
|
它是一个 CharField ，它用来选择文件系统下某个目录里面的某些文件。它有三个专有的参数，只有第一个参数是必须的： path: 这个参数是必需的。它是一个目录的绝对路径，而这个目录就是 FilePathField 用来选择文件的那个目录。比如： "/home/images"。 match: 可选参数。它是一个正则表达式字符串， FilePathField 用它来过滤文件名称，只有符合条件的文件才出现在文件选择列表中。要注意正则表达式只匹配文件名，而不是匹配文件路径。 例如："foo.*\\.txt$" 只匹配名为foo23.txt 而不匹配 bar.txt 和 foo23.gif。 recursive: 可选参数。它的值是 True 或 False。默认值是 False。它指定是否包含 path 下的子目录。 allow_files: 该项属于Django1.5新增内容。可选参数，它的值是 True 或 False。默认值是 True。它指定是否包含指定位置的文件。该项与allow_folders 必须有一个是 True。 allow_folders: Django1.5新增内容。可选参数，它的值是True或False。默认是False。它指定是否包含指定位置的目录。该项与allow_files必须有一个是 True。 前面已经提到了 match 只匹配文件名称，而不是文件路径。所以下面这个例子：
FilePathField(path="/home/images", match="foo.*", recursive=True)?
将匹配 /home/images/foo.gif ，而不匹配 /home/images/foo/bar.gif。这是因为 match 只匹配文件名(foo.gif 和 bar.gif)。 默认情况下， FilePathField 实例在数据库中的对应列是varchar(100) 。和其他字段一样，你可以利用 max_length 参数改变字段的最大长度。 |
||||
| 文件上传到指定目录 | FileField | FileInput |
upload_to |
|
|
class FileField(upload_to=None[, max_length=100, **options]) Note：该字段不支持primary_key和unique 参数，否则会抛出TypeError 异常。 它有一个必须的参数： upload_to: 用于保存文件的本地文件系统。它根据 MEDIA_ROOT 设置确定该文件的 url 属性。 该路径可以包含 时间格式串strftime()，可以在上传文件的时候替换成当时日期／时间(这样，就不会出现在上传文件把某个目录塞满的情况了)。 该参数也可以是一个可调用项，比如是一个函数，可以调用函数获得包含文件名的上传路径。这个可调用项必须要接受两个参数，并且返回一个保存文件用的 Unix-Style 的路径(用/斜杠)。两个参数分别是： instance ：定义了当前 FileField 的 model 实例。更准确地说，就是以该文件为附件的 model 实例。 大多数情况下，在保存该文件时， model 实例对象还并没有保存到数据库，这是因为它很有可能使用默认的 AutoField，而此时它还没有从数据库中获得主键值。 filename ：上传文件的原始名称。在生成最终路径的时候，有可能会用到它。 还有一个可选的参数： storage: 负责保存和获取文件的对象。 默认的form widget是FileInput。 Note：在 model 中使用 FileField 或 ImageField 要按照以下的步骤：
例如，假设你的 MEDIA_ROOT 被设为 ‘/home/media‘，upload_to 被设为 ‘photos/%Y/%m/%d‘。 upload_to 中的 ‘%Y/%m/%d‘ 是一个strftime()，‘%Y‘ 是四位的年份，‘%m‘ 是两位的月份，‘%d‘ 是两位的日子。如果你在2007年01月15号上传了一个文件，那么这个文件就保存在/home/media/photos/2007/01/15 目录下。 如果你想得到上传文件的本地文件名称，文件网址或是文件的大小，你可以使用 name, url 和 size 属性。 Note：在上传文件时，要警惕保存文件的位置和文件的类型，这么做的原因是为了避免安全漏洞。对每一个上传文件都要验证，这样你才能确保上传的文件是你想要的文件。举个例子，如果你盲目地让别人上传文件，而没有对上传文件进行验证，如果保存文件的目录处于 web 服务器的根目录下，万一有人上传了一个 CGI 或是 php脚本，然后通过访问脚本网址来运行上传的脚本，那可就太危险了。千万不要让这样的事情发生！默认情况下，FileField 实例在数据库中的对应列是 varchar(100) ，和其他字段一样，你可以利用max_length 参数改变字段的最大长度。 |
||||
| 图片上传到指定目录 | ImageField | FileInput | upload_to | |
| class ImageField(upload_to=None[, height_field=None, width_field=None, max_length=100,**options])和FileField一样，只是会验证上传对象是不是一个合法的图象文件。除了那些在FileField中有效的参数之外， ImageField 还可以使用 File.height and File.width 两个属性 。它有两个可选参数：height_field:保存图片高度的字段名称。在保存对象时，会根据该字段设定的高度，对图片文件进行缩放转换。width_field:保存图片宽度的字段名称。在保存对象时，会根据该字段设定的宽度，对图片文件进行缩放转换。默认情况下，ImageField 实例对应着数据库中的varchar(100) 列。和其他字段一样，你可以使用max_length 参数来改变字段的最大长度。 | ||||
| 日期型 | 日期型 | DateField | TextInput |
auto_now auto_now_add |
| 日期时间型 | DateTimeField | TextInput | 同DateField | |
| 时间型 | TimeField | TextInput | 同DateField | |
| 布尔 | 布尔型 | BooleanField | CheckboxInput | |
| 空布尔 | NullBooleanField | NullBooleanSelect | ||
参数说明：
| 参数名称 | 默认值 | 说明 |
| null | False | 数据库中字段是否可以为空 |
| blank | django的Admin中添加数据时是否可允许空值 | |
| primary_key | False | 主键，设置后，就会代替原来的自增 id 列 |
| auto_now | 自动创建---无论添加或修改，都是当前操作的时间 | |
| auto_now_add | 自动创建---永远是创建时的时间 | |
| choices | Admin中显示选择框的内容，用不变动的数据放在内存中从而避免跨表操作 | |
|
代码如下： gf = models.IntegerField(choices=[(0, ‘何穗‘),(1, ‘大表姐‘),],default=1)?
|
||
| default | 长度 | |
| verbose_name | Admin中字段的显示名称 | |
| db_column | 数据库中的字段名称 | |
| unique | False | 不允许重复 |
| db_index | False | 数据库索引 |
| editable | False | 在Admin里是否可编辑 |
| error_messages | 自定义错误信息（字典类型），从而定制想要显示的错误信息； | |
| 字典健：null, blank, invalid, invalid_choice, unique, and unique_for_date 如：{‘null‘: "不能为空.", ‘invalid‘: ‘格式错误‘} |
||
| auto_created | False | 自动创建 |
| help_text | 在Admin中提示帮助信息 | |
| validators | 自定义错误验证（列表类型），从而定制想要的验证规则 | |
from django.core.validators import RegexValidator
from django.core.validators import EmailValidator,URLValidator,DecimalValidator,MaxLengthValidator,MinLengthValidator,MaxValueValidator,MinValueValidator
#举个声明的例子如下：
test = models.CharField(
max_length=32,
error_messages={
‘c1‘: ‘优先错信息1‘,
‘c2‘: ‘优先错信息2‘,
‘c3‘: ‘优先错信息3‘,
},
validators=[
RegexValidator(regex=‘root_\\d+‘, message=‘错误了‘, code=‘c1‘),
RegexValidator(regex=‘root_112233\\d+‘, message=‘又错误了‘, code=‘c2‘),
EmailValidator(message=‘又错误了‘, code=‘c3‘), ]
)
|
||
| upload-to | 文件上传路径 | |
外键说明：
一对多：models.ForeignKey(其他表)
一对多：当一张表中创建一行数据时，有一个单选的下拉框（可以被重复选择）
例如：创建用户信息时候，需要选择一个用户类型【普通用户】【金牌用户】【铂金用户】等。
代码：
a=models.ForeignKey(to=‘TableName‘,to_field=‘id‘)
ForeignKey的参数：
| 参数名称 | 参数说明 |
| to=None, | 要进行关联的表名 |
| to_field=None, | 要关联的表中的字段名称 |
| on_delete=None, |
当删除关联表中的数据时，当前表与其关联的行的行为，内部可传递的变量有： - a. 与之关联的值设置为指定值，设置：models.SET(值) |
| related_name=None, | 反向操作时，使用的字段名，用于代替 【表名_set】 |
| related_query_name=None, | 反向操作时，使用的连接前缀，用于替换【表名】 |
| limit_choices_to=None, | 在Admin或ModelForm中显示关联数据时，提供的条件 |
| db_constraint=True | 是否在数据库中创建外键约束 |
| parent_link=False | 在Admin中是否显示关联数据 |
多对多：models.ManyToManyField(其他表)
多对多：在某表中创建一行数据是，有一个可以多选的下拉框
例如：创建用户信息，需要为用户指定多个爱好
ManyToManyField参数：
| 参数名称 | 参数说明 |
|
to=None |
要进行关联的表名 |
| related_name=None | 反向操作时，使用的字段名，用于代替 【表名_set】 如： obj.表名_set.all() |
| related_query_name=None | 反向操作时，使用的连接前缀，用于替换【表名】 如： models.UserGroup.objects.filter(表名__字段名=1).values(‘表名__字段名‘) |
| limit_choices_to=None |
在Admin或ModelForm中显示关联数据时，提供的条件： from django.db.models import Q - limit_choices_to=Q(nid__gt=10) - limit_choices_to=Q(nid=8) | Q(nid__gt=10) - limit_choices_to=lambda : Q(Q(nid=8) | Q(nid__gt=10)) & Q(caption=‘root‘)? |
| symmetrical=None | 仅用于多对多自关联时，symmetrical用于指定内部是否创建反向操作的字段 |
| through=None | 自定义第三张表时，使用字段用于指定关系表 |
| through_fields=None |
自定义第三张表时，使用字段用于指定关系表中那些字段做多对多关系表： from django.db import models
class Person(models.Model):
name=models.CharField(max_length=50)
class Group(models.Model):
name=models.CharField(max_length=128)
members=models.ManyToManyField(
Person,
through=‘Membership‘,
through_fields=(‘group‘, ‘person‘),
)
class Membership(models.Model):
group=models.ForeignKey(Group, on_delete=models.CASCADE)
person = models.ForeignKey(Person,on_delete=models.CASCADE)
inviter=models.ForeignKey(
Person,
on_delete=models.CASCADE,
related_name="membership_invites",
)
invite_reason=models.CharField(max_length=64)?
|
| db_constraint=True | 是否在数据库中创建外键约束 |
| db_table=None | 默认创建第三张表时，数据库中表的名称 |
一对一：models.OneToOneField(其他表)
一对一：在某表中创建一行数据时，有一个单选的下拉框（下拉框中的内容被用过一次就消失了）
例如：原有含10列数据的一张表保存相关信息，经过一段时间之后，10列无法满足需求，需要为原来的表再添加5列数据
OneToOneField参数：
| 参数名称 | 参数说明 |
| to | 要进行关联的表名 |
| to_field=None | 要关联的表中的字段名称 |
| on_delete=None | 当删除关联表中的数据时，当前表与其关联的行的行为 |