Exception Handling in Laravel - معالجة الاستثناءات في laravel - مركز التطوير

معالجة الاستثناءات في Laravel

تعتبر معالجة الاستثناءات جزءًا أساسيًا من تطوير تطبيقات الويب، حيث تضمن أن يتمكن تطبيقك من التعامل مع الأخطاء غير المتوقعة بسلاسة وتقديم استجابات مفيدة للمستخدمين. يأتي Laravel بنظام معالجة استثناءات قوي يسمح لك بإدارة الأخطاء بكفاءة. في هذه المقالة، سنتناول أساسيات معالجة الاستثناءات في Laravel مع استعراض المفاهيم الرئيسية.

فهم الاستثناءات في Laravel

في Laravel، يتم استخدام الاستثناءات للتعامل مع الأخطاء والاختلالات التي قد تحدث أثناء تنفيذ التطبيق. الاستثناءات هي كائنات من فئة Exception أو الفئات الفرعية لها، وتوفر معلومات تفصيلية حول الخطأ. يتم التعامل مع الاستثناءات في Laravel بشكل مركزي داخل الفئة App\Exceptions\Handler، والتي تتيح لك تخصيص كيفية الإبلاغ عن الاستثناءات وكيفية عرضها.

مدير الاستثناءات

تتحمل الفئة Handler في Laravel مسؤولية التقاط ومعالجة الاستثناءات. تحتوي هذه الفئة على طرق للإبلاغ عن الاستثناءات وعرضها. لنلقِ نظرة أقرب على طريقة render():

php

public function render($request, Throwable $exception)
{
    if ($exception instanceof CustomException) {
        return response()->view('errors.custom', [], 500);
    }
 
    return parent::render($request, $exception);
}

في هذا المثال، نتحقق مما إذا كان الاستثناء هو من نوع CustomException. إذا كان كذلك، نعيد عرض خطأ مخصص؛ وإلا نترك Laravel يتعامل مع الاستثناء باستخدام طريقة render() الأصلية.

فئات الاستثناءات المخصصة

يساعد إنشاء فئات استثناءات مخصصة على تنظيم وإدارة أنواع مختلفة من الأخطاء في التطبيق. إليك كيفية إنشاء فئة استثناء مخصصة:

php

namespace App\Exceptions;
 
use Exception;
 
class CustomException extends Exception
{
    // يمكن إضافة خصائص أو طرق إضافية هنا
}

يمكنك رمي هذا الاستثناء في الكود باستخدام:

php

throw new CustomException('This is a custom exception.');

التعامل مع استثناءات HTTP

يوفر Laravel دالة المساعدة abort لرمي استثناءات HTTP. يمكن أن تكون هذه الوظيفة مفيدة لإرجاع رموز حالة HTTP محددة ورسائل خطأ مخصصة. على سبيل المثال:

PHP

abort(404, 'Resource not found.');

هذه السطر من الكود سيرمي HttpException مع رمز الحالة 404 والرسالة المحددة.

معالجة استثناءات قاعدة البيانات

عند العمل مع قواعد البيانات، من الضروري التعامل مع الاستثناءات التي قد تحدث أثناء تنفيذ الاستعلامات. إليك مثالًا على التعامل مع استثناء قاعدة بيانات:

PHP

use Illuminate\Support\Facades\DB;
use Illuminate\Database\QueryException;
 
try {
    DB::table('users')->insert([
        'name' => 'John Doe',
        'email' => 'john@example.com',
    ]);
} catch (QueryException $e) {
    // التعامل مع استثناء قاعدة البيانات
    Log::error($e->getMessage());
    return response()->json(['error' => 'Database error'], 500);
}

في هذا المثال، نقوم بالتقاط استثناء QueryException بشكل خاص وتسجيل الخطأ قبل إرجاع استجابة JSON مع رمز الحالة 500.

التعامل مع استثناءات التحقق

يطرح نظام التحقق في Laravel استثناءات عند فشل التحقق. يمكنك التعامل مع أخطاء التحقق في وحدات التحكم الخاصة بك كما يلي:

PHP

public function store(Request $request)
{
    $validatedData = $request->validate([
        'name' => 'required|string|max:255',
        'email' => 'required|email|unique:users',
    ]);
 
    // الكود الخاص بك هنا
}

إذا فشل التحقق، سيقوم Laravel تلقائيًا بإعادة توجيه المستخدم مع أخطاء التحقق. يمكنك تخصيص هذا السلوك من خلال التعامل مع استثناء التحقق بشكل صريح إذا لزم الأمر.

تسجيل الاستثناءات

يعد تسجيل الاستثناءات أمرًا بالغ الأهمية لأغراض التصحيح والمراقبة. يوفر Laravel واجهة Log التي تجعل من السهل تسجيل الاستثناءات:

PHP

use Illuminate\Support\Facades\Log;
 
try {
    // الكود الخاص بك هنا
} catch (\Exception $e) {
    // تسجيل الاستثناء
    Log::error($e->getMessage());
    // منطق معالجة إضافي
}

ساعدك تسجيل الاستثناءات في التعرف على المشكلات وتشخيصها في تطبيقك، خاصة في بيئات الإنتاج.

المراجع

Laravel Documentation

laravel magazine

Exception Handling in Laravel – معالجة الاستثناءات في laravel