لاراول 13.42 با uuid() و ulid() برای ورودی درخواست
خلاصهٔ کاملتر
لاراول نسخهٔ 13.42.0 رو منتشر کرده و به گفتهٔ Laravel News مهمترین تغییرش دوتا متد جدید برای ورودی درخواسته: uuid() و ulid(). این دوتا کنار date() و enum() قرار میگیرن و به جای رشته، یه آبجکت تایپدار برمیگردونن.
$request->uuid('order_id'); // Ramsey\Uuid\UuidInterface|null
$request->ulid('order_id'); // Symfony\Component\Uid\Ulid|null
$request->safe()->uuid('order_id');اگه ورودی خالی باشه null برمیگرده و اگه نامعتبر باشه exception پرت میشه. چون این متدها از trait InteractsWithData میان، روی Fluent، ورودی validate شده، query string کلاس Uri و ورودی کامندها هم کار میکنن. یه نکته: ulid() فقط ULID واقعی قبول میکنه و اگه بهش UUID بدی، به جای تبدیل کردن، خطا میده.
رویداد جدید MigrationFailed هم وقتی اجرا میشه که یه migration خطا بده. این رویداد همون پراپرتیهای migration، method و name رو داره، بهعلاوهٔ exception. نویسنده توضیح میده که تو MySQL تغییرات ساختاری مثل ALTER TABLE با شکست دستور بعدی rollback نمیشن. یعنی دیتابیس ممکنه نصفهنیمه تغییر کنه. با این رویداد میتونی قبل از اینکه کاربرها به این وضع بخورن، سایت رو down کنی یا به تیم هشدار بدی:
Event::listen(function (MigrationFailed $event) {
Artisan::call('down');
Log::channel('slack')->critical("Migration [{$event->name}] failed");
});تو بخش زمانبند (scheduler)، رویداد ScheduledTaskSkipped حالا یه پراپرتی reason داره. این یه enum با سه حالته: ConditionNotMet، Paused و RanOnAnotherServer. خروجی schedule:list --json هم حالا cron و timezone خود هر تسک رو نشون میده. قبلاً همهچی به timezone اپ تبدیل میشد و بعد از تغییر ساعت تابستونی یه ساعت اختلاف پیش میومد. اگه این JSON رو پارس میکنی، تسکهایی که timezone() خودشون رو دارن چک کن.
چندتا قابلیت کوچیکتر هم اومده. LostConnectionDetector::detectUsing() بهت اجازه میده تشخیص قطع شدن اتصال دیتابیس رو با یه closure خودت گسترش بدی. Uri::origin() scheme و host و port رو نرمالشده برمیگردونه، که برای مقایسهٔ same-origin به درد میخوره. PendingProcess هم حالا macro قبول میکنه و پکیج Ably هم از ably/ably-php به ably/pubsub-server تغییر اسم داده.
تو بخش باگها، TokenGuard::validate() قبلاً برای توکنهای معتبر وقتی hashing فعال بود false برمیگردوند که درست شده. cursor() هم حالا به preventLazyLoading() احترام میذاره و اتصالهای PostgreSQL بعد از قطع شدن موقع commit، درست دوباره وصل میشن.
نکات کلیدی:
- متدهای uuid() و ulid() آبجکت تایپدار برمیگردونن و برای ورودی نامعتبر exception میدن
- رویداد MigrationFailed بعد از اجرا هم exception رو دوباره پرت میکنه
- ScheduledTaskSkipped حالا سه دلیل رد شدن داره: ConditionNotMet، Paused و RanOnAnotherServer
- schedule:list --json حالا timezone خود هر تسک رو گزارش میده، نه timezone اپ
- لاراول حالا به league/uri نسخهٔ 7.6 یا بالاتر نیاز داره




