MODULE 57 / 72

Scénario : upload d'un fichier (image, PDF)

Le piège du débutant : envoyer le fichier en base64 dans un JSON. C'est inefficace (×1.33 en taille) et ça fait exploser la mémoire serveur pour les gros fichiers. La bonne approche utilise `multipart/form-data` ou mieux, les URLs pré-signées.
Approche classique — multipart : le frontend envoie un `POST /api/upload` avec le fichier en `FormData`. Le backend reçoit le stream, le valide (taille, type MIME, contenu réel avec magic numbers), puis l'écrit sur disque ou cloud. Simple, mais passe par votre serveur : scaling limité.
Approche moderne — URLs pré-signées : (1) Frontend demande `POST /api/uploads/sign` → backend génère une URL S3/Cloudflare R2 signée valable 5 min. (2) Frontend upload DIRECTEMENT sur S3 avec cette URL — le backend n'est jamais en contact avec le fichier. (3) Frontend notifie le backend que l'upload est terminé → enregistre en BDD. Scaling illimité, coût serveur minimal.
Validation côté backend : JAMAIS faire confiance à l'extension `.jpg`. Un attaquant peut nommer `virus.exe` en `photo.jpg`. On vérifie les magic numbers (les premiers octets du fichier qui identifient le vrai format). Et on scanne avec un antivirus (ClamAV, ou service cloud).
Traitement asynchrone : un upload d'image = 3 tâches à faire APRÈS la réception. (1) Redimensionner en plusieurs tailles (thumbnail, medium, large). (2) Convertir en WebP/AVIF pour réduire le poids. (3) Extraire les métadonnées (EXIF, dimensions). Ces tâches passent par une queue (Redis, RabbitMQ, SQS) — le user reçoit sa réponse instantanément pendant que les workers traitent en arrière-plan.
Distribution — CDN : les images finales sont servies par un CDN (Cloudflare, CloudFront) depuis le point géographique le plus proche de l'utilisateur. Latence ÷ 10, coût bande passante ÷ 5.
Sécurité finale : jamais servir les fichiers depuis le même domaine que l'app (risque XSS si HTML uploadé). Toujours via un sous-domaine sandboxé ou un bucket dédié.
⚡ ANALOGIE — LE DÉPÔT DE COLIS EN POINT RELAIS
Upload classique = vous déposez le colis à la poste centrale, elle le réachemine vers l'entrepôt. La poste centrale devient le goulot d'étranglement. URL pré-signée = la poste vous donne un ticket pour déposer directement à l'entrepôt, sans passer par elle. Queue asynchrone = vous laissez le colis, ils le traitent plus tard (pesage, étiquetage, tri) pendant que vous êtes déjà reparti. CDN = plusieurs points relais proches du destinataire final.
📐 SCHÉMA
Frontend
POST /uploads/sign (taille, type)
Backend
Génère URL S3 signée (5 min)
Frontend
PUT fichier → S3 directement
Frontend
POST /uploads/complete {id}
Backend
INSERT en BDD + push en queue
Worker
Resize, convert WebP, metadata
CDN
Sert le fichier proche du user
💬 QUESTION INTERACTIVE
1/5
"Un utilisateur upload une photo de 15 MB. Que se passe-t-il de bout en bout dans une architecture moderne ?"
🎯 PIÈGE / QUESTION D'ENTRETIEN
Pourquoi ne jamais stocker les fichiers uploadés directement dans la base de données ?