Création d'une application Web express pour le téléchargement de fichiers et le traitement dynamique d'images à la volée

Guide : Création d'une application Web Express pour les téléchargements de fichiers et le traitement dynamique des images

Dans ce didacticiel, nous allons vous montrer comment créer un serveur avec Express.js qui gère les téléchargements de fichiers et effectue un traitement dynamique des images comme le redimensionnement, la conversion de format et les ajustements de qualité à l'aide de Sharp<.>.

Conditions préalables

Avant de commencer, assurez-vous que

Node.js et npm sont installés. Nous utiliserons les bibliothèques suivantes dans ce tutoriel :

1. Express.js - pour configurer le serveur.
2. Multer - pour gérer les téléchargements de fichiers.
3. Sharp - pour le traitement des images.
4. CORS - pour autoriser les requêtes d'origine croisée.

---

Étape 1 : Mise en place du projet

Commencez par créer un nouveau répertoire pour votre projet :

mkdir image-upload-server
cd image-upload-server
npm init -y

Cela créera un nouveau dossier de projet et initialisera un fichier package.json.

Vous pouvez installer toutes les dépendances en exécutant :

npm install express multer sharp cors 

Créer les répertoires nécessaires

Nous aurons besoin de deux répertoires :

original-image pour stocker les images originales téléchargées.
transform-image pour stocker les images traitées.

Créez ces répertoires en exécutant :

mkdir original-image transform-image

---

Étape 2 : configurer le serveur Express

Maintenant, configurons le serveur de base en utilisant

Express.js. Créez un fichier appelé index.js à la racine de votre projet et ajoutez le code suivant pour configurer le serveur :

const express = require('express');
const cors = require('cors');
const multer = require('multer');
const path = require('path');
const sharp = require('sharp');
const fs = require('fs');

const app = express();

// Middleware for CORS and JSON parsing
app.use(cors());
app.use(express.json());
app.use(express.urlencoded({ extended: true }));

Cette configuration de base comprend :

• CORS pour autoriser les requêtes d'origine croisée.
• express.json() et express.urlencoded() pour analyser les données de requête entrantes.

---

Étape 3 : Configurer Multer pour les téléchargements de fichiers

Nous utiliserons

Multer pour gérer les téléchargements de fichiers. Multer nous permet de stocker les fichiers téléchargés dans un répertoire spécifié.

Ajoutez le code suivant pour configurer

Multer :

// Configure multer for file storage
const storage = multer.diskStorage({
  destination: function (req, file, cb) {
    cb(null, 'original-image'); // Ensure the 'original-image' directory exists
  },
  filename: function (req, file, cb) {
    const uniqueSuffix = Date.now() + '-' + Math.round(Math.random() * 1E9);
    cb(null, file.fieldname + '-' + uniqueSuffix + path.extname(file.originalname));
  }
});

const upload = multer({ storage: storage });

Cette configuration garantit que :

Les fichiers téléchargés sont stockés dans le dossier de l'image originale.
Chaque fichier reçoit un nom unique basé sur l'horodatage actuel et un nombre aléatoire.

---

Étape 4 : Créer le point de terminaison de téléchargement de fichiers

Ensuite, créez un point de terminaison

POST pour les téléchargements de fichiers. L'utilisateur enverra un fichier au serveur et le serveur stockera le fichier dans le répertoire de l'image d'origine.

Ajoutez le code suivant pour gérer le téléchargement du fichier :

// File upload endpoint
app.post('/upload', upload.single('file'), (req, res) => {
  const file = req.file;
  if (!file) {
    return res.status(400).send({ message: 'Please select a file.' });
  }
  const url = `http://localhost:3000/${file.filename}`;

  // Store file path with original filename as the key
  db.set(file.filename, file.path);

  res.json({
    message: 'File uploaded successfully.',
    url: url
  });
});

Ce point de terminaison effectue les opérations suivantes :

• Reçoit un seul téléchargement de fichier (avec le fichier de nom de champ).
• Renvoie l'URL du fichier téléchargé.

---

Étape 5 : Servir les fichiers téléchargés

Maintenant, créons un point de terminaison GET pour servir les fichiers téléchargés. Si des paramètres de requête sont fournis (par exemple, redimensionnement, conversion de format), le serveur traitera l'image en conséquence.

Ajoutez le code suivant pour diffuser les fichiers téléchargés :

mkdir image-upload-server
cd image-upload-server
npm init -y

Ce point de terminaison :

• Récupère le fichier de la carte de base de données en fonction du nom de fichier.
• Traite l'image si un redimensionnement, une conversion de format ou des ajustements de qualité sont spécifiés.
• Mette en cache les images traitées pour améliorer les performances.

---

Étape 6 : Traiter les images avec Sharp

La bibliothèque Sharp nous permettra d'effectuer diverses transformations sur les images, telles que le redimensionnement, la conversion de format et les ajustements de qualité.

Ajoutez la fonction processImage qui gère ces transformations :

npm install express multer sharp cors 

Cette fonction :

• Redimensionne l'image en fonction des paramètres h (hauteur) et w (largeur).
• Convertit le format d'image en fonction du paramètre f (JPEG, PNG, WebP, etc.).
• Ajuste la qualité de l'image en fonction du paramètre q (facultatif).
• Enregistre l'image traitée dans le dossier transform-image.

---

Étape 7 : démarrer le serveur

Enfin, démarrez le serveur en ajoutant le code suivant :

mkdir original-image transform-image

Cela démarrera le serveur sur le port 3000.

---

Étape 8 : tester le serveur

1. Test du téléchargement de fichiers avec Postman

Pour tester la fonctionnalité de téléchargement de fichiers à l'aide de Postman, procédez comme suit :

1.1 Ouvrir le facteur

Lancez Postman sur votre ordinateur. Si Postman n'est pas installé, vous pouvez le télécharger ici.

1.2 Créer une requête POST

• Définissez le type de demande sur POST.
• Dans le champ URL, saisissez : http://localhost:3000/upload.

1.3 Ajouter le fichier dans le corps

• Sélectionnez l'onglet Corps.
• Choisissez l'option form-data.
• Dans le formulaire, définissez la clé sur file (cela doit correspondre au nom du champ dans votre configuration multer).
• Cliquez sur le bouton Choisir des fichiers et sélectionnez un fichier image sur votre ordinateur.

1.4 Envoyer la demande

• Cliquez sur Envoyer.
• Si le téléchargement réussit, vous devriez recevoir une réponse avec l'URL de l'image téléchargée.

Exemple de réponse :

mkdir image-upload-server
cd image-upload-server
npm init -y

---

2. Test de la récupération et du traitement des images via le navigateur

Maintenant, testons la récupération de l'image avec les transformations à l'aide du Navigateur.

2.1 Obtenez l'image téléchargée

Pour récupérer l'image, ouvrez simplement votre navigateur et accédez à l'URL que vous avez reçue après avoir téléchargé le fichier. Par exemple, si l'URL de réponse était :

npm install express multer sharp cors 

Tapez simplement cette URL dans la barre d'adresse de votre navigateur et appuyez sur Entrée. Vous devriez voir l'image originale affichée.

---

3. Test des transformations d'image avec des paramètres de requête

Testons maintenant les transformations d'images dynamiques en ajoutant des paramètres de requête pour le redimensionnement, la conversion de format et l'ajustement de la qualité.

3.1 Ajouter des paramètres de requête pour la transformation

Dans votre navigateur, ajoutez les paramètres de requête à l'URL de l'image pour tester les transformations. Voici quelques exemples :

• Redimensionnez l'image à une largeur de 200 px et une hauteur de 300 px :

mkdir original-image transform-image

• Convertir l'image au format PNG :

const express = require('express');
const cors = require('cors');
const multer = require('multer');
const path = require('path');
const sharp = require('sharp');
const fs = require('fs');

const app = express();

// Middleware for CORS and JSON parsing
app.use(cors());
app.use(express.json());
app.use(express.urlencoded({ extended: true }));

• Convertir l'image au format WebP avec une qualité de 90% :

// Configure multer for file storage
const storage = multer.diskStorage({
  destination: function (req, file, cb) {
    cb(null, 'original-image'); // Ensure the 'original-image' directory exists
  },
  filename: function (req, file, cb) {
    const uniqueSuffix = Date.now() + '-' + Math.round(Math.random() * 1E9);
    cb(null, file.fieldname + '-' + uniqueSuffix + path.extname(file.originalname));
  }
});

const upload = multer({ storage: storage });

• Redimensionnez l'image à une largeur de 400 px, une hauteur de 500 px et convertissez-la en JPEG avec une qualité de 80 % :

// File upload endpoint
app.post('/upload', upload.single('file'), (req, res) => {
  const file = req.file;
  if (!file) {
    return res.status(400).send({ message: 'Please select a file.' });
  }
  const url = `http://localhost:3000/${file.filename}`;

  // Store file path with original filename as the key
  db.set(file.filename, file.path);

  res.json({
    message: 'File uploaded successfully.',
    url: url
  });
});

3.2 Comportement attendu

• Lorsque vous accédez à l'une des URL avec les paramètres de requête, le serveur traitera l'image en conséquence.
  • Si l'image a déjà été traitée avec les mêmes paramètres, elle servira la version mise en cache.
  • Si elle n'a pas encore été traitée, il traitera l'image (redimensionner, convertir le format, ajuster la qualité) et l'enregistrera dans le dossier transform-image pour les demandes futures.

Le navigateur affichera l'image traitée et vous pourrez confirmer si la transformation a été appliquée correctement.

---

Exemple de flux de travail

1. Télécharger une image via Postman.
2. Récupérez l'image téléchargée dans le navigateur en utilisant l'URL fournie par Postman.
3. Modifiez l'URL dans le navigateur en ajoutant des paramètres de requête tels que ?h=300&w=200 pour voir le redimensionnement en action ou ?f=webp&q=90 pour la conversion de format.

---

Conclusion

Ce serveur de téléchargement et de traitement d'images fournit une solution robuste pour gérer les téléchargements, les transformations et les récupérations d'images. Utilisant Multer pour la gestion des fichiers et Sharp pour le traitement des images, il prend en charge le redimensionnement, la conversion de format et les ajustements de qualité via les paramètres de requête. Le système met efficacement en cache les images traitées pour optimiser les performances, garantissant ainsi une livraison rapide et réactive des images. Cette approche simplifie la gestion des images pour les applications nécessitant des transformations d'images dynamiques, ce qui en fait un outil polyvalent pour les développeurs.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!