Laravel 13: ما الجديد؟ أهم المميزات ودليل الترقية
نظرة عملية موثقة على Laravel 13: دعم PHP Attributes، حزمة Laravel AI SDK، موارد JSON:API، Route Metadata، تحسينات قواعد البيانات والتخزين، ومتطلبات الترقية من Laravel 12.
صدر Laravel 13 في 17 مارس 2026 ليواصل فلسفة Laravel في تقديم إصدار رئيسي سنوي مع تقليل التغييرات التي قد تكسر التطبيقات القائمة. الإصدار الجديد لا يغيّر طريقة بناء تطبيقات Laravel جذريًا، لكنه يضيف أدوات قوية للذكاء الاصطناعي، وواجهات API، وبيئات قواعد البيانات الحديثة، مع اعتماد أوسع على إمكانيات PHP الحديثة.
متطلبات Laravel 13 ودورة الدعم
- PHP 8.3 هو الحد الأدنى المطلوب، مع دعم إصدارات PHP الأحدث.
- إصلاحات الأخطاء مستمرة حتى الربع الثالث من عام 2027.
- تحديثات الأمان مستمرة حتى 17 مارس 2028.
إذا كان مشروعك يعمل على PHP 8.2، فالخطوة الأولى قبل الترقية هي نقل بيئة التشغيل والحزم إلى PHP 8.3 أو أحدث واختبار المشروع كاملًا.
1. دعم PHP Attributes بشكل أوسع
يوسّع Laravel 13 استخدام PHP Attributes داخل الإطار، لتصبح طريقة اختيارية وواضحة لتعريف سلوك النماذج والمهام وأوامر Console وأجزاء أخرى من التطبيق. هذا لا يجبرك على إعادة كتابة الكود الحالي؛ الأساليب المعتادة ما زالت تعمل، ويمكنك تبني Attributes تدريجيًا حيث تجعل الكود أوضح.
2. Laravel AI SDK الرسمي
من أكبر إضافات منظومة Laravel 13 ظهور Laravel AI SDK كحزمة رسمية موحدة لبناء خصائص الذكاء الاصطناعي داخل تطبيقات Laravel. تشمل قدراتها:
- توليد النصوص والمخرجات المنظمة.
- بناء Agents تستطيع استدعاء الأدوات.
- Embeddings والبحث الدلالي والتكامل مع مخازن المتجهات.
- التعامل مع الصوت والصور من خلال واجهة Laravel موحدة.
القيمة الحقيقية هنا ليست مجرد استدعاء نموذج ذكاء اصطناعي، بل تنظيم التكامل داخل التطبيق بأسلوب مألوف لمطوري Laravel وقابل للاختبار والتبديل بين المزودين.
3. موارد JSON:API رسمية
يضيف الإصدار دعمًا رسميًا لموارد متوافقة مع مواصفة JSON:API، بما يشمل تسلسل البيانات، وتضمين العلاقات، واختيار الحقول المطلوبة فقط، وإضافة الروابط. هذه الإضافة مفيدة عند بناء API كبير يحتاج إلى عقد ثابت بين الواجهة والخادم بدل حلول مخصصة مختلفة من مشروع إلى آخر.
4. Route Metadata
يمكن إرفاق بيانات وصفية بالمسارات عبر metadata()، مثل معلومات SEO أو مفاتيح الخصائص أو قواعد مرتبطة بالوصول، مع توافقها مع تخزين المسارات المؤقت. هذا يقلل الحاجة إلى خرائط جانبية منفصلة تربط كل Route بإعداداته.
Route::get('/articles/{article}', ArticleController::class)
->metadata([
'section' => 'blog',
'requires_subscription' => false,
]);5. تحسينات قواعد البيانات الحديثة
يحسن Laravel 13 العمل مع بيئات PostgreSQL التي تستخدم Transaction Pooling مثل PgBouncer وAWS RDS Proxy وNeon. كما يضيف AsVector للتعامل مع أعمدة المتجهات في Eloquent، وهو مهم لتطبيقات البحث الدلالي وRAG وأنظمة التوصية.
6. Read-Through Filesystem
يسهّل مشغل التخزين الجديد نقل الملفات تدريجيًا بين قرصين. يستطيع التطبيق القراءة من الموقع الجديد، وعند عدم وجود الملف يرجع إلى القرص القديم. هذه الآلية تقلل مخاطر نقل مكتبة ملفات كبيرة دفعة واحدة وتسمح بترحيل هادئ دون توقف الخدمة.
7. تحسينات Laravel Cloud
توفّر Cloud Facade طريقة مباشرة لمعرفة ما إذا كان التطبيق يعمل على Laravel Cloud والتعامل مع قدرات البيئة المُدارة مثل قوائم الانتظار. وهي إضافة موجهة خصوصًا للتطبيقات التي تستخدم خدمات Laravel الرسمية للاستضافة.
ما الذي قد يتطلب تعديلًا أثناء الترقية؟
دليل الترقية الرسمي يصنّف أغلب التغييرات كتأثير منخفض، لكن يجب مراجعة النقاط التالية بعناية:
- تحديث متطلبات
composer.jsonإلىlaravel/framework:^13.0. - مراجعة تغييرات الحماية من تزوير الطلبات CSRF.
- مراجعة سلوك
upsertفي MySQL وMariaDB. - التحقق من إعداد
serializable_classesفي الكاش. - تحديث أدوات الاختبار والحزم المتوافقة، مثل PHPUnit 12 أو Pest 4 عند استخدامها.
- فحص الحزم الخارجية والتأكد من إعلان دعمها لـLaravel 13 وPHP 8.3.
خطة ترقية آمنة من Laravel 12
- أنشئ فرعًا مستقلًا للترقية وحدّث بيئة التطوير إلى PHP 8.3 أو أحدث.
- راجع الحزم عبر Composer وحدّث ما لا يتوافق مع Laravel 13.
- حدّث Laravel والحزم الرسمية تدريجيًا بدل تحديث جميع الاعتماديات بلا مراجعة.
- شغّل اختبارات Feature وUnit، ثم اختبر المصادقة والملفات والطوابير والمهام المجدولة يدويًا.
- راجع الاستعلامات التي تستخدم
upsert، وإعدادات الجلسة والكاش وCSRF. - اختبر نسخة تجريبية ببيانات مشابهة للإنتاج قبل النشر النهائي.
تقدّر وثائق Laravel الرسمية زمن الترقية الأساسية من 12.x بنحو عشر دقائق، لكن الزمن الفعلي يعتمد على حجم المشروع وعدد الحزم الخارجية ومستوى تغطية الاختبارات.
هل يجب أن ترقي الآن؟
نعم، إذا كانت بيئتك وحزمك تدعم PHP 8.3 ولديك اختبارات جيدة. Laravel 13 يقدم تحسينات عملية دون موجة كبيرة من التغييرات الجذرية، ويصبح أكثر أهمية للمشروعات التي تبني ميزات AI أو JSON:API أو تستخدم PostgreSQL وخدمات التخزين الحديثة. أما التطبيقات الحساسة، فالأفضل تنفيذ الترقية في بيئة تجريبية ومراجعة دليل الترقية بندًا بندًا قبل الإنتاج.
المصادر الرسمية
Laravel 13, released on March 17, 2026, continues Laravel's annual major-release cycle while keeping breaking changes to a minimum. It requires PHP 8.3 or newer and introduces first-party capabilities for AI, JSON:API, modern PostgreSQL deployments, vector data, and gradual filesystem migrations.
Key additions
- Broader, optional support for native PHP Attributes across the framework.
- The official Laravel AI SDK for text, agents, tools, embeddings, audio, images, and vector stores.
- First-party JSON:API resources with relationships, sparse fieldsets, and links.
- Route metadata that remains compatible with route caching.
- PostgreSQL transaction-pooler support and an Eloquent vector cast.
- A read-through filesystem driver for gradual storage migrations.
Before upgrading
Move your runtime to PHP 8.3+, update laravel/framework to ^13.0, verify third-party package compatibility, and review CSRF protection, cache serialization, and MySQL/MariaDB upsert behavior. Run the complete automated test suite and validate queues, scheduled jobs, authentication, and storage in a staging environment.