
بهبودهای امنیتی: حفاظت CSRF و سریالایزیشن بهتر
ویژگیهای جدید: PHP Attributes، Cache::touch() و موارد دیگر
بهینهسازی عملکرد: سرعت و کارایی بیشتر
Syntax و API جدید: کد تمیزتر و خوانایی بهتر
لاراول ۱۳ از PHP 8 Attributes به عنوان جایگزینی برای propertyهای کلاس برای پیکربندی اجزاء Laravel استفاده میکند. این یک تغییر غیرشکستپذیر است — پیکربندی مبتنی بر propertyهای قدیمی همچنان کار میکند.
اکنون میتوانید از Attributes استفاده کنید تا نیازی به تعریف کردن $table، $hidden، $fillable و دیگر properties نباشد:
#[Table('users', key: 'user_id', keyType: 'string', incrementing: false)] #[Hidden(['password'])] #[Fillable(['name', 'email'])] class User extends Model {}
کپی
Attributes دستیاب برای Models:
Attributeتوضیح#[Appends]ویژگیهای بیشتری را append کنید#[Connection]اتصال دیتابیس را تنظیم کنید#[Fillable]فیلدهای قابل پُرکردن#[Guarded]فیلدهای محافظتشده#[Hidden]فیلدهای مخفی در خروجی#[Table]نام جدول دیتابیس#[Touches]رابطههای جدید شامل#[Unguarded]تمام فیلدها قابل اختصاص هستند#[Visible]فیلدهای نمایشی
اکنون میتوانید پیکربندی Queue را مستقیماً روی کلاس Job تعریف کنید:
#[Connection('redis')] #[Queue('podcasts')] #[Tries(3)] #[Timeout(120)] class ProcessPodcast implements ShouldQueue {}
کپی
Attributes دستیاب برای Queue:
#[Backoff]
#[Connection]
#[FailOnTimeout]
#[MaxExceptions]
#[Queue]
#[Timeout]
#[Tries]
#[UniqueFor]
این Attributes همچنین برای Listeners، Notifications، Mailables و Broadcast Events قابل استفاده هستند.
Commands میتوانند signature و description خود را با Attributes به جای class properties تعریف کنند:
#[Signature('mail:send {user} {--queue}')] #[Description('Send a marketing email to a user')] class SendMailCommand extends Command {}
کپی
Attributes همچنین برای موارد زیر قابل دسترس هستند:
Form Requests: #[RedirectTo]، #[StopOnFirstFailure]
API Resources: #[Collects]، #[PreserveKeys]
Factories: #[UseModel]
Test Seeders: #[Seed]، #[Seeder]
PR #55954 یک متد Cache::touch() اضافه میکند که TTL یک آیتم کششده را بدون دریافت یا بازذخیره کردن مقدار تمدید میکند:
// Extend by seconds Cache::touch('user_session:123', 3600); // Extend with a DateTime Cache::touch('analytics_data', now()->addHours(6)); // Extend indefinitely Cache::touch('report_cache', null);
کپی
چرا این مهم است؟ قبلاً، تمدید TTL نیاز به get و سپس put داشت، که نیاز به انتقال مقدار کششده بر روی سیم داشت. Cache::touch() این مرحله را رد میکند:
Redis: یک فرمان EXPIRE استفاده میکند
Memcached: TOUCH استفاده میکند
Database: یک UPDATE صادر میکند
متد true در صورت موفقیت و false در صورتی که کلید موجود نباشد برمیگرداند.
✅ پشتیبانی: روش Cache::touch() در تمام drivers کش پیادهسازی شده است: Array، APC، Database، DynamoDB، File، Memcached، Memoized، Null، و Redis.
لاراول ۱۳ نیاز به PHP 8.3 به عنوان حداقل نسخه دارد. این نمایندگی یک افزایش از نسخه ۱۲ (PHP 8.2) است.
نسخه Laravelنسخه PHPتاریخ انتشاررفع باگ تاپشتیبانی امنیتی تا108.1 - 8.314 فوریه 20236 اگست 20244 فوریه 2025118.2 - 8.412 مارس 20243 سپتامبر 202512 مارس 2026128.2 - 8.524 فوریه 202513 اگست 202624 فوریه 2027138.3 - 8.5Q1 2026 (مارس)Q3 2027Q1 2028
اولین و مهمترین گام، بروزرسانی فایل composer.json است:
{ "require": { "php": "^8.3", "laravel/framework": "^13.0", "laravel/tinker": "^3.0", "laravel/sanctum": "^4.0" }, "require-dev": { "phpunit/phpunit": "^12.0", "laravel/pint": "^1.17", "laravel/sail": "^1.30" } }
کپی
سپس این دستورات را اجرا کنید:
rm -rf vendor composer.lock composer install composer dump-autoload
کپی
یکی از مهمترین تغییرات در لاراول ۱۳:
Illuminate\Foundation\Http\Middleware\VerifyCsrfToken
Illuminate\Foundation\Http\Middleware\PreventRequestForgery
مراحل انتقال:
use Illuminate\Foundation\Http\Middleware\PreventRequestForgery; ->withoutMiddleware([PreventRequestForgery::class])
کپی
گزینه جدیدی به نام serializable_classes به کانفیگ کش اضافه شده که به طور پیشفرض false است. این کار جلوی حملات deserialization gadget chain را میگیره.
// config/cache.php return [ 'serializable_classes' => [ App\Models\User::class, App\Data\CachedDashboardStats::class, ], ];
کپی
حالا متد upsert حتماً نیاز به یک مقدار غیرتهی برای uniqueBy دارد.
User::upsert( [ ['email' => '[email protected]', 'name' => 'John'], ['email' => '[email protected]', 'name' => 'Jane'], ], 'email', // uniqueBy - اجباری ['name', 'updated_at'] // updateFields );
کپی
خاصیت exceptionOccurred حذف و با $event->exception جایگزین شد.
use Illuminate\Queue\Events\JobAttempted; Queue::listen(JobAttempted::class, function (JobAttempted $event) { if ($event->exception !== null) { Log::error('Job failed', ['exception' => $event->exception]); } });
کپی
خاصیت $connection به $connectionName تغییر نام داد.
use Illuminate\Queue\Events\QueueBusy; class ListenerQueueBusy { public function handle(QueueBusy $event) { Log::info("Queue busy: {$event->connectionName}"); } }
کپی
الویت تطابق مسیرها عوض شده: مسیرهایی که دامنه (domain) مشخص دارند، اولویت بیشتری نسبت به مسیرهای بدون دامنه دارند.
// الویت 1 - Domain مشخص Route::domain('api.example.com')->group(function () { Route::get('/users', 'UserController@index'); }); // الویت 2 - بدون Domain Route::get('/users', 'UserController@index');
کپی
کارخانههای UUID و string دیگر بین تستها ریست میشوند. اگر در تستهای مختلف به persist شدن این فیکسچرها تکیه کرده بودید، باید در هر تست یا در متد setUp دوباره مقداردهی کنید.
public function setUp(): void { parent::setUp(); Str::createUuidsUsing(function () { return Str::uuid(); }); }
کپی
حالا به طور پیشفرض از JSON_UNESCAPED_UNICODE استفاده میکند.
Backup دیتابیس و فایلهای پروژه
git commit -am "Pre-upgrade backup" mysqldump -u user -p database > backup.sql
کپی
بررسی نسخه PHP (باید 8.3+ باشد)
php -v
کپی
اجرای تستهای موجود
php artisan test --stop-on-failure
کپی
❌ مشکل: "Class not found" برای PreventRequestForgery
✅ حل: از Illuminate\Foundation\Http\Middleware\PreventRequestForgery استفاده کنید
❌ مشکل: "Serializable classes not found"
✅ حل: کلاسهای استفادهشده را به config/cache.php اضافه کنید
❌ مشکل: "upsert() requires uniqueBy parameter"
✅ حل: پارامتر uniqueBy را تنظیم کنید
لاراول ۱۳ آپگرید سرمایهگذاری ارزشمندی برای امنیت و عملکرد است. ویژگیهای جدید مثل PHP Attributes و Cache::touch() توسعه را آسانتر میکنند.
Backup بگیرید
بهترتیب پیش بروید
تستها را اجرا کنید
از ابزارهای خودکار استفاده کنید (Laravel Shift)
Logs را نظارت کنید