Le mécanisme d'erreur et d'exception de Laravel est basé sur le système d'exception PHP et le composant Symfony, et est géré par la classe App \ Exceptions \ Handler. 1. Enregistrer les exceptions via la méthode du rapport (), telles que l'intégration de Sentry et d'autres services de surveillance; 2. Convertir les exceptions en réponses HTTP via la méthode Render (), en prenant en charge les sauts JSON ou Page personnalisés; 3. Vous pouvez créer des classes d'exception personnalisées telles que PaytFailedException et définir leur format de réponse; 4. Gérer automatiquement la Vérification Exception ValidationException et ajuster manuellement la structure de réponse d'erreur; 5. Décidez de l'affichage d'informations d'erreur détaillées en fonction de la configuration APP_DEBUG, et l'environnement de production doit être défini sur False; 6. Utilisez monolog pour enregistrer les journaux, et il est recommandé d'enregistrer activement les informations clés dans la gestion des exceptions; La meilleure pratique met l'accent sur le fait de ne pas gérer silencieusement des exceptions, la distinction de l'API des formats de réponse de demande Web, garantissant le développement convivial, convivial et convivial et contr?lable de l'opération, améliorant ainsi la robustesse des applications.

Le mécanisme d'erreur et de gestion des exceptions de Laravel est très puissant. Il est basé sur PHP et combine les composants de Symfony pour permettre aux développeurs de capturer, d'enregistrer et de répondre gracieusement à diverses erreurs. Comprendre le processus de gestion des erreurs de Laravel peut aider à localiser rapidement les problèmes et à améliorer la robustesse des applications.

1. Processus de base de l'erreur Laravel et de la gestion des exceptions

Toutes les exceptions dans les applications Laravel sont gérées uniformément par App\Exceptions\Handler . Il existe deux méthodes principales de cette classe:

• report() : utilisé pour enregistrer des exceptions ou envoyer des notifications (comme l'envoi d'un e-mail au développeur).
• render() : convertit l'exception en réponse HTTP et la renvoie à l'utilisateur.

Lorsqu'une exception est lancée dans le code, Laravel sera:

1. Gérez l'exception à report() de Handler (si la classe d'exception Reportable ou configure la logique de rapport personnalisée).
2. Appelez ensuite render() pour générer une réponse (comme renvoyer le message d'erreur JSON ou sauter sur la page d'erreur).

Par défaut, Laravel gère automatiquement la plupart des exceptions au niveau du framework (telles que ModelNotFoundException , ValidationException , etc.) et renvoie une réponse HTTP appropriée.

2. Manipulation des exceptions personnalisées (classe de gestionnaire)

Vous pouvez ajouter une logique dans app/Exceptions/Handler.php pour gérer des exceptions spécifiques.

Exemple: captez une exception spécifique et personnalisez la réponse

 Utiliser illuminate \ auth \ AuthenticationException;
Utiliser illuminate \ http \ request;

Rendu de la fonction publique (demande de $, exception $ thrognable)
{
    if ($ exception instance of AuthenticationException) {
        retourner $ request-> attendSjson ()
            ? réponse () -> JSON (['message' => 'non authentifié.'], 401)
            : redirect () -> invité (itinéraire ('connexion'));
    }

    Retour Parent :: Render ($ demande, $ Exception);
}

Exception du rapport (méthode de rapport)

 Rapport des fonctions publiques (exception de $ Throwable)
{
    if (app () -> bound ('Sentry') && $ this-> devraientport ($ exception)) {
        app ('Sentry') -> captureException ($ exception);
    }

    Parent :: Report ($ exception);
}

Utilisé couramment pour intégrer Sentry, BugsNag et d'autres services de surveillance des erreurs.

3. Classe d'exception personnalisée

Vous pouvez créer votre propre classe d'exception pour gérer des erreurs de logique métier spécifiques.

Créer une exception personnalisée

 PHP Artisan Make: Exception PaymentFailedException

Le fichier généré se trouve dans app/Exceptions/PaymentFailedException.php :

 Classe PaymentFailedException étend une exception
{
    Rendu de la fonction publique (demande $)
    {
        return réponse () -> JSON ([
            'Error' => 'Le paiement a échoué',
            'message' => $ this-> getMessage ()
        ], 422);
    }
}

Puis jetez le code:

 lancer un nouveau PaymentFailedException (?Solde de carte de crédit insuffisant?);

4. Erreur de vérification et exception de demande de formulaire

Laravel gère automatiquement la défaillance de la vérification, lève ValidationException et renvoie le code d'état 422 et les informations sur le champ d'erreur.

Vérification manuelle dans le contr?leur

 $ request-> valider ([
    'email' => 'requis | e-mail',
    'mot de passe' => 'requis | min: 8'
]));

Si la vérification échoue, Laravel sautera automatiquement ou renvoie une erreur JSON.

Réponse d'erreur de vérification personnalisée

Dans Handler.php , il peut être géré uniformément:

 Utiliser illuminate \ validation \ ValidationException;

Rendu de la fonction publique (demande de $, exception $ thrognable)
{
    if ($ exception instance of validationException) {
        return réponse () -> JSON ([
            'erreurs' => $ exception-> errors ()
        ], $ exception-> statut);
    }

    Retour Parent :: Render ($ demande, $ Exception);
}

5. Affichage des erreurs liées à l'environnement

Laravel décide s'il faut afficher des informations d'erreur détaillées basées sur la configuration APP_DEBUG dans le fichier .env :

• APP_DEBUG=true : affiche la pile d'erreur complète (pour le développement local uniquement).
• APP_DEBUG=false : renvoie la page d'erreur générale (500 erreurs) pour éviter la fuite d'informations.

L'environnement de production doit définir APP_DEBUG=false .

6. Logotage

Laravel utilise Monolog pour enregistrer. Vous pouvez vous connecter manuellement à la gestion des exceptions:

 Utiliser illuminate \ support \ FACADES \ Log;

Log :: error ('Le paiement a échoué pour l'utilisateur:'. $ User-> id, [
    'exception' => $ exception,
    'data' => $ requestData
]));

Le fichier de journal est situé dans storage/logs/laravel.log .

Conseils et meilleures pratiques

• Ne traitez pas silencieusement après avoir attrapé des exceptions : au moins enregistrer le journal.
• Utilisez report() pour signaler des exceptions importantes , même si vous avez render la réponse.
• Le projet API vous recommande de retourner des erreurs de format JSON en uniforme pour éviter de retourner les pages HTML.
• Utilisez la méthode render pour distinguer les demandes AJAX / JSON et les demandes de page ordinaires .

Fondamentalement, c'est tout. Le mécanisme de gestion des exceptions de Laravel est très flexible. La clé est d'utiliser raisonnablement Handler et les exceptions personnalisées, afin d'atteindre "le développement convivial, convivial et contr?lable de l'opération" dans l'environnement de développement et de production.

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!