Gestion des fichiersLien vers cette rubrique#

Utilisation des fichiers dans les modèlesLien vers cette rubrique#

Quand vous utilisez un FileField ou un ImageField, Django fournit un ensemble d’API pour pouvoir manipuler le fichier correspondant.

Considérez le modèle suivant qui utilise un ImageField pour stocker une photo :

from django.db import models


class Car(models.Model):
    name = models.CharField(max_length=255)
    price = models.DecimalField(max_digits=5, decimal_places=2)
    photo = models.ImageField(upload_to="cars")
    specs = models.FileField(upload_to="specs")

Toute instance de Car possède un attribut photo qu’il est possible d’utiliser pour obtenir les détails de la photo jointe :

>>> car = Car.objects.get(name="57 Chevy")
>>> car.photo
<ImageFieldFile: cars/chevy.jpg>
>>> car.photo.name
'cars/chevy.jpg'
>>> car.photo.path
'/media/cars/chevy.jpg'
>>> car.photo.url
'https://media.example.com/cars/chevy.jpg'

Cet objet (car.photo dans l’exemple) est un objet File, ce qui signifie qu’il possède toutes les méthodes et les attributs documentés ci-dessous.

Par exemple, vous pouvez modifier le nom de fichier en définissant l’attribut name du fichier à un chemin relatif à l’emplacement de stockage des fichiers (MEDIA_ROOT si vous utilisez le FileSystemStorage par défaut) :

>>> import os
>>> from django.conf import settings
>>> initial_path = car.photo.path
>>> car.photo.name = "cars/chevy_ii.jpg"
>>> new_path = settings.MEDIA_ROOT + car.photo.name
>>> # Move the file on the filesystem
>>> os.rename(initial_path, new_path)
>>> car.save()
>>> car.photo.path
'/media/cars/chevy_ii.jpg'
>>> car.photo.path == new_path
True

Pour enregistrer un fichier existant sur le disque dans un champ FileField:

>>> from pathlib import Path
>>> from django.core.files import File
>>> path = Path("/some/external/specs.pdf")
>>> car = Car.objects.get(name="57 Chevy")
>>> with path.open(mode="rb") as f:
...     car.specs = File(f, name=path.name)
...     car.save()
...

L’objetLien vers cette rubrique#

En interne, Django utilise une instance de django.core.files.File chaque fois qu’il a besoin de représenter un fichier.

La plupart du temps, vous utiliserez l’objet File que Django vous transmet (par exemple un fichier joint à un modèle comme ci-dessus ou peut-être un fichier téléversé).

Si vous avez besoin de construire vous-même un objet File, la façon la plus simple est de le créer en utilisant un objet file de Python :

>>> from django.core.files import File

# Create a Python file object using open()
>>> f = open("/path/to/hello.world", "w")
>>> myfile = File(f)

Il est maintenant possible d’utiliser les attributs et les méthodes documentés de la classe File.

Il faut savoir que les fichiers créés de cette façon ne sont pas fermés automatiquement. L’approche suivante peut être employée pour fermer automatiquement les fichiers :

>>> from django.core.files import File

# Create a Python file object using open() and the with statement
>>> with open("/path/to/hello.world", "w") as f:
...     myfile = File(f)
...     myfile.write("Hello World")
...
>>> myfile.closed
True
>>> f.closed
True

La fermeture des fichiers est particulièrement importante lors de l’accès en boucle à des champs fichier pour un grand nombre d’objets. Si les fichiers ne sont pas fermés manuellement après les avoir lus, il y a un risque d’épuisement des descripteurs de fichiers. Cela peut amener à l’erreur suivante :

OSError: [Errno 24] Too many open files

Stockage des fichiersLien vers cette rubrique#

En arrière-plan, Django délègue les décisions au sujet des emplacements des fichiers et de la manière de les stocker à un système de stockage de fichiers. C’est cet objet qui s’occupe réellement des systèmes de fichiers, de l’ouverture et de la lecture des fichiers, etc.

Le stockage de fichiers par défaut de Django est 'django.core.files.storage.FileSystemStorage'. Si vous n’indiquez pas explicitement un système de stockage dans la clé default du réglage STORAGES, c’est celui qui sera utilisé.

Lisez ci-dessous pour obtenir des détails sur le système de stockage de fichiers intégré par défaut et lisez Écriture d’une classe de stockage personnalisée pour plus d’informations sur l’écriture de son propre système de stockage de fichiers.

>>> from django.core.files.base import ContentFile
>>> from django.core.files.storage import default_storage

>>> path = default_storage.save("path/to/file", ContentFile(b"new content"))
>>> path
'path/to/file'

>>> default_storage.size(path)
11
>>> default_storage.open(path).read()
b'new content'

>>> default_storage.delete(path)
>>> default_storage.exists(path)
False

from django.core.files.storage import FileSystemStorage
from django.db import models

fs = FileSystemStorage(location="/media/photos")


class Car(models.Model):
    ...
    photo = models.ImageField(storage=fs)

from django.conf import settings
from django.db import models
from .storages import MyLocalStorage, MyRemoteStorage


def select_storage():
    return MyLocalStorage() if settings.DEBUG else MyRemoteStorage()


class MyModel(models.Model):
    my_file = models.FileField(storage=select_storage)

from django.core.files.storage import storages


def select_storage():
    return storages["mystorage"]


class MyModel(models.Model):
    upload = models.FileField(storage=select_storage)