Guide de téléchargement de fichiers Laravel: gérer correctement le stockage d'images et les questions fréquemment posées

2. Processus des fichiers dans le contrôleur

Dans le contrôleur, nous devons vérifier s'il y a d'abord des téléchargements de fichiers, puis obtenir l'instance de fichier et le stocker.

Exemple de code du contrôleur:

  Php

Namespace App \ Http \ Controllers;

Utiliser illuminate \ http \ request;
Utilisez App \ Models \ Post; // Supposons que vous ayez un modèle de publication pour stocker la classe d'informations d'image ImageUploadController étend le contrôleur
{
    / **
     * Traitez le téléchargement et enregistrez l'image localement.
     *
     * @param \ illuminate \ http \ request $ request
     * @param int | null $ postid Si vous devez mettre à jour les enregistrements existants, passer
     * @return \ illuminer \ http \ réponse
     * /
    Fonction publique UploadImage (demande $ demande, $ postid = null)
    {
        // 1. Vérification du document (fortement recommandé)
        $ request-> valider ([
            'image' => 'requis | Image | mimes: jpeg, png, jpg, gif, svg | max: 2048', // exemples de règles de vérification]);

        // 2. Vérifiez s'il y a un téléchargement de fichiers si (! $ Request-> HasFile ('image')) {
            // S'il n'y a pas de fichier, vous pouvez retourner une erreur ou effectuer un autre traitement. Return back () -> witherrors ('Veuillez sélectionner un fichier image pour le téléchargement.');
        }

        // 3. Get uploadFile instance // Remarque: utilisez file () au lieu de l'entrée () ici
        $ file = $ request-> file ('image');

        // 4. Obtenez l'extension de fichier $ extension = $ file-> getClientoriginalextension ();

        // 5. Générez un nom de fichier unique pour empêcher l'écrasement des fichiers.
        // Remarque: le «Time ()». ».
        $ filename = time (). '.' . $ Extension;

        // 6. Stocker les fichiers à différents emplacements // Méthode 1: Utilisez la méthode Move () pour les stocker dans le répertoire public // Le fichier sera stocké directement dans le répertoire public / image et peut être accessible directement via l'URL // Remarque: Le paramètre 'Image' est le Path $ file-> Mov (public_path ('image'), $ filen);
        $ publicPath = 'image /'. $ nom de fichier; // Le chemin utilisé pour le stockage de la base de données // Méthode 2: Utilisez la méthode Storeas () pour la stocker dans le stockage / app / public Directory // Cette méthode est plus recommandée. Le fichier sera stocké dans le stockage / app / public / image Directory // Cette méthode nécessite l'exécution de `PHP Artisan Storage: link` Pour créer un lien symbolique pour y accéder via l'URL // $ StoragePath = $ file-> Storeas ('public / image', $ fileName); // le chemin par rapport au stockage / app // 7. Enregistrez le nom du fichier dans la base de données $ post = $ postid? Post :: find ($ postid): nouveau post ();
        if (! $ post) {
            return back () -> witherrors ('post n'existe pas.');
        }
        $ post-> image = $ publicPath; // ou $ StoragePath
        $ post-> title = $ request-> entrée ('title', 'Title par défaut'); // Exemple: Enregistrer d'autres champs $ post-> sauver ();

        return back () -> avec ('succès', 'image téléchargée avec succès!');
    }
}

Explication détaillée de la méthode de stockage

• $ file-> Move (public_path ('your_folder'), $ filename);

  • Cette méthode déplacera le fichier téléchargé directement dans le dossier spécifié dans le répertoire public.
  • Par exemple, public_path ('image') déplacera le fichier dans le répertoire YOT_LARAVEL_PROject / public / image.
  • Avantages: simple et direct, après avoir téléchargé le fichier, vous pouvez y accéder via votre_domain.com/image/filename.ext.
  • Inconvénients: la modification directe du répertoire public peut ne pas se conformer à certaines politiques de déploiement et ne sont pas propices à la gestion de l'autorisation.

• $ file-> Storeas ('public / your_folder', $ filename);

  • Cette méthode stocke les fichiers téléchargés dans le dossier spécifié dans le répertoire de stockage / app / public.
  • Par exemple, «public / image» stockera le fichier dans votre répertoire de répertoire de votre_Laravel_project / Storage / APP / Public / Image.
  • avantage:
    • Séparez les fichiers téléchargés par les utilisateurs du code d'application pour améliorer la sécurité.
    • La configuration du système de fichiers de Laravel est facile à utiliser (par exemple, passer au stockage cloud tel que S3).
    • Grâce à la commande php artisan Storage: lien, vous pouvez créer un lien symbolique public / stockage pointant vers le stockage / app / public dans le répertoire public, permettant ainsi l'accès à ces fichiers via URL.
  • Inconvénients: Besoin d'exécuter le stockage: Commande de liaison supplémentaire.

Meilleures pratiques et précautions

1. Validation du fichier : Avant de traiter les téléchargements de fichiers, assurez-vous d'effectuer une vérification stricte. Laravel fournit des règles de vérification puissantes telles que l'image (assurez-vous qu'il s'agit d'un fichier image), des mimes (type de fichier limite), max (taille limite du fichier), etc. Cela peut effectivement empêcher les téléchargements de fichiers malveillants et l'abus de ressources du serveur.

    $ request-> valider ([
       'image' => 'requis | Image | mimes: jpeg, png, jpg, gif, svg | max: 2048', // 2MB
   ]));

2. Générez des noms de fichiers uniques : évitez d'utiliser les noms de fichiers d'origine téléchargés par l'utilisateur, car il peut y avoir des remplacements de fichiers en double ou des risques de sécurité. Utilisez Time (), Uniqid () ou Str :: Random () pour combiner les extensions de fichiers pour générer un nom de fichier unique.

3. Noms de fichiers de stockage de la base de données : Habituellement, vous stockerez le chemin d'accès ou le nom du fichier du fichier téléchargé dans la base de données pour la récupération et l'affichage si nécessaire. Stockez uniquement le nom de fichier ou le chemin par rapport à un chemin de base.

4. PHP Artisan Storage: lien : Si vous choisissez de stocker des fichiers dans le répertoire de stockage / app / public, assurez-vous d'exécuter cette commande pendant le déploiement pour créer un lien symbolique du public / du stockage vers le stockage / l'application / le public afin que ces fichiers puissent être accessibles via des URL publiques.

5. Gestion des erreurs : Pendant le processus de téléchargement de fichiers, diverses erreurs peuvent être rencontrées (comme des fichiers trop volumineux, des types incohérents, un espace disque insuffisant, etc.). Assurez-vous que votre code de contrôleur gère correctement ces erreurs et fournit aux utilisateurs des commentaires conviviaux.

6. Supprimer les anciens fichiers : s'il s'agit d'une opération de mise à jour et que l'utilisateur télécharge une nouvelle image, n'oubliez pas de supprimer l'ancien fichier photo pour éviter de gaspiller l'espace de stockage du serveur.

En suivant les directives et les meilleures pratiques ci-dessus, vous pouvez implémenter en toute sécurité et efficacement le téléchargement de fichiers dans votre application Laravel, éviter GetClientoriginalextension commune sur les erreurs NULL et créer un système de gestion de fichiers robuste.