django上传图片，ImageField

今天看django的时候，突然发现model里有个ImageField，原以为django的model只是一个ORM的框架，没想到连上传图片到服务器都可以搞定，于是结合例子尝试了一下。ImageField需要PIL的支持，所以没装PIL这个库的需要先安装。

首先建立两个model:

class Item(models.Model):
    name = models.CharField(max_length=250)
    description = models.TextField()
    
    class Meta:
        ordering = ['name']
        
    def __unicode__(self):
        return self.name
    
    @models.permalink
    def get_absolute_url(self):
        return ('item_detail', None, {'object_id':self.id})


class Photo(models.Model):
    item = models.ForeignKey(Item)
    title = models.CharField(max_length=100)
    image = models.ImageField(upload_to='photos')
    caption = models.CharField(max_length=250, blank=True)
    
    class Meta:
        ordering = ["title"]
        
    def __unicode__(self):
        return self.title
    
    @models.permalink
    def get_absolute_url(self):
        return ('photo_detail', None, {'object_id':self.id})
    

class PhotoInline(admin.StackedInline):
    model = Photo
    
class ItemAdmin(admin.ModelAdmin):
    inlines = [PhotoInline]
        

然后在settings.py中加入 MEDIA_ROOT:

MEDIA_ROOT = '/var/www/gallery/media/'

由于我是用apache跑的，所以需要注意目录权限。

这里

upload_to='photos' 这句表示上传的文件会存放在$MEDIA_ROOT/photos/ 下面，也就是放在 /var/www/gallery/media/photos/ 下。

之后一番syncdb，打开admin页面，看到刚才建立的model，添加一条数据，上传图片，成功了，django真是强大！

然后再修改刚才添加的那条记录的修改界面，可以看到刚才上传的图片的超接：

点开图片的超链接，却显示404 not found ，这可奇怪了，在服务器上明明已经有这个文件，并且数据库都添加正确了，怎么读不回来呢。

这里发现有个奇怪的地方，打开的图片url为：http://10.40.3.164:8090/admin/gallery/item/1/photos/github-logo.png/

超链接里面的href值为：photos/github-logo.png，这个有问题啊，图片应该是相对独立的，且不说这里load不到图片，如果真实使用的时候，用这个url肯定不对。

好吧，看下ImageField 的源代码吧。

在django/db/models/fields/files.py 中有：

class ImageField(FileField):

ImageField本身没有什么和 url有关的东西，继续看它的父类： FileField

class FileField(Field):

    # The class to wrap instance attributes in. Accessing the file object off
    # the instance will always return an instance of attr_class.
    attr_class = FieldFile

FileField 中有个属性 attr_class 这里注释说里面属性都是从这里配置的那个类那来的。那我们继续看 FieldFile 类：

class FieldFile(File):
    def _get_url(self):
        self._require_file()
        return self.storage.url(self.name)
    url = property(_get_url)

果然有个叫做 url 的属性，但是这个属性有是通过 storage.url方法返回的。由于是存的文件，那很可能是FileStorage，先look一下吧。

在django/core/files/storage.py  中有个FileSystemStorage类，其中有个url方法：

    def url(self, name):
        if self.base_url is None:
            raise ValueError("This file is not accessible via a URL.")
        return urljoin(self.base_url, filepath_to_uri(name))

这里的已经比较清楚了，url是由 self.base_url 加上一段文件的filename组成的，这里的 self.base_url 的值是由 MEDIA_URL 这个配置选项决定的，再看下 django/conf/global_setting.py 文件，里面的MEDIA_URL默认为空字符串。

在我们项目的settings.py中加入 MEDIA_URL 这个配置选项:

MEDIA_URL='/media/'

重启apache后，再次打开那条记录的修改页面，这时候通过firebug看到超链接的href属性已经变为 /media/photos/github-logo.png

点击超链接，请求的是 http://10.40.3.164:8090/media/photos/github-logo.png 页面，好吧这就是href属性是否以 “/" 开头的不同。

但是此时还是显示错误，但是问题已经很明显了，和设置静态文件一样，需要在项目的urls.py中加点东西：

urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

OK，再试一下，图片果然出来了。

至此，ImageField 已经可以使用了 :-)