laravel بالعربي laravel بالعربي
المواضيع

التحقق من صحة التواريخ بطريقة سلسة في لارافل ١١.٤٠

هذا الموضوع مترجم، المصدر "Fluent Date Validation in Laravel 11.40"


تم إصدار نسخة Laravel 11.40، والتي تتضمن class للتحقق من صحة التواريخ بطريقة سلسة، وسمات Eloquent معلقة، ومساعدات dump لمعالجة مثيلات استجابات HTTP، والمزيد.

التحقق من صحة التواريخ بطريقة سلسة

ساهم Michael Nabil بقاعدة تحقق جديدة قابلة للتخصيص من نوع `Date` في طلب السحب #53465:

تسهل قاعدة `Date` التحقق من صحة التواريخ من خلال توفير أساليب متسلسلة تسمح بمتطلبات تواريخ معقدة مباشرة داخل تعريف القاعدة. يتضمن هذا التحسين أساليب لتحديد تنسيقات التواريخ، و التحقق أن التواريخ قبل أو بعد تواريخ محددة (بما في ذلك "اليوم")، وكذلك التحقق أن التواريخ في أو قبل/بعد قيود محددة.

توفر قاعدة `Date` قيمًا افتراضية للتحقق من صحة التواريخ الأساسية، بالإضافة إلى أساليب لإنشاء احتياجات للتحقق من صحة التواريخ المعقدة، مثل تحديد تاريخ انتهاء يتم مقارنته بتاريخ بداية، والعديد من الاحتمالات الأخرى: 
use Illuminate\Validation\Rules\Date;
 
public function rules()
{
    return [
        'start_date' => [
            'required',
            new Date, // Defaults to validating the date
        ],
        'end_date' => [
            'required',
            (new Date)->after('start_date')->before('2025-01-01'), // Ensures end date is after start_date and before 2025-01-01
        ],
        'birth_date' => [
            'required',
            (new Date)->format('d/m/Y')->beforeToday(), // Validates birth_date is before today in 'd/m/Y' format
        ],
    ];
}

الأساليب المتاحة:

* `format($format)`: يحدد تنسيق التاريخ للتحقق من صحته. القيمة الافتراضية هي 'Y-m-d' إذا لم يتم تحديدها.

* `afterToday()`: يضمن أن التاريخ بعد تاريخ اليوم.

* `beforeToday()`: يضمن أن التاريخ قبل تاريخ اليوم.

* `after($date)`: يضمن أن التاريخ بعد التاريخ المحدد.

* `afterOrEqual($date)`: يضمن أن التاريخ في أو بعد التاريخ المحدد.

* `before($date)`: يضمن أن التاريخ قبل التاريخ المحدد.

* `beforeOrEqual($date)`: يضمن أن التاريخ في أو قبل التاريخ المحدد.

* `between($from, $to)`: يضمن أن التاريخ بين تاريخين.

* `betweenOrEqual($from, $to)`: يضمن أن التاريخ بين تاريخين أو يساويهما. ملاحظة: في وقت كتابة هذه السطور، هناك إصلاح لم يتم وسمه/إصداره بعد يتعلق بهذه الميزة. نظرًا لأنه ميزة جديدة، فإنه لا يكسر التطبيقات الموجودة، ومن المأمول أن يتم حله قريبًا.

مساعدات Dump لعميل HTTP في Laravel

ساهم Craig Morris بأساليب مساعدة جديدة للـ object الذي تم إرجاعه بواسطة HTTP. تتطابق هذه التوقيعات مع فئة `TestResponse` إذا كنت معتادًا على استخدامها: 
Http::get($url)->dump($key = null);
Http::get($url)->dd($key = null);
Http::get($url)->dumpHeaders();
Http::get($url)->ddHeaders();

السمات المعلقة

ساهم @tontonsb بإضافة السمات المعلقة في Eloquent، باستخدام طريقة `withAttributes()`:

إنشاء `->withAttributes(['key' => 'value'])` سيوجه مثيل Builder إلى إضافة السمات المحددة إلى مثيلات النموذج الجديدة إذا قمت بإنشاء نموذج واستخدمتها كشروط `where` إذا انتهى بك الأمر بالقيام بتحديد.

// in the relationship on the User model
public function hiddenPosts(): HasMany
{
    return $this->posts()->withAttributes('hidden', 'y');
}
 
// in the scope on the Post model
public function scopeHidden(Builder $posts)
{
    $posts->withAttributes('hidden', 'y');
}

ملاحظات الإصدار

يمكنك الاطلاع على القائمة الكاملة للميزات والتحديثات الجديدة أدناه والفرق بين 11.39.0 و 11.40.0 على GitHub. ملاحظات الإصدار التالية مأخوذة مباشرة من سجل التغييرات:

v11.40.0

→ المقال السابق
المقال التالي ←
جميع الحقوق محفوظة © 2025 Laravel | عربي