خیلی از توسعهدهندههای لاراول همیشه دنبال راههایی برای مدیریت بهتر صفهای انتظار هستند. یکی از جدیدترین ویژگیهایی که در لاراول ۱۱ معرفی شده، متد PendingChain::catch()
هست. این متد به ما این امکان را میدهد که خطاهای احتمالی که در حین اجرای صفهای همزمان پیش میاد رو به نحو بهتری مدیریت کنیم.
وقتی که شما از صفهای همزمان استفاده میکنید، معمولاً کارهایی رو به صورت غیرهمزمان در نظر میگیرید که ممکنه یک یا چند تا از اونها با خطا مواجه بشن. حالا با استفاده از catch()
میتونید هم خطای عمومی رو مدیریت کنید و هم به راحتی مشخص کنید که چه کاری باید در صورت بروز خطا انجام بشه. این به شما اجازه میده که هیچ بخشی از کارهای صفتون بینتیجه ن بمونه.
استفاده از PendingChain::catch()
خیلی ساده هست. شما یه سری کار رو به صف اضافه میکنید و با خطاها رو شناسایی و به طور صحیح مدیریت میکنید. این متد به شما این امکان رو میده که یکcallback برای هر خطا مشخص کنید. اینطوری شما میتونید در مواقع بروز خطا، هموارتر با شرایط کنار بیایید.
فرآیند استفاده از این متد بهصورت زیر هست: شما ابتدا کارهایی که میخواهید به صف اضافه کنید رو میسازید و بعد با استفاده از catch()
مشخص میکنید که در صورت بروز خطا چه باید بکنید. برای مثال، میتونید بهراحتی به کاربر یک پیام مناسب نشون بدید یا شاید بخواید درخواست رو دوباره ارسال کنید.
مثال کد
use Illuminate\Bus\PendingChain;
PendingChain::new()->
push(new JobOne())
->push(new JobTwo())
->catch(function ($exception) {
// مدیریت خطا
Log::error($exception);
})
->dispatch();
توضیح کد
use Illuminate\Bus\PendingChain;
این خط باعث میشود که ما بتوانیم از PendingChain
که در فضای نام Illuminate\Bus
قرار دارد استفاده کنیم.
PendingChain::new()
اینجا ما یک مورد جدید از صف PendingChain
ایجاد میکنیم.
push(new JobOne())
ما یک کار جدید به صف اضافه میکنیم که در اینجا JobOne
نام دارد.
->push(new JobTwo())
ما در مرحله بعدی یک کار دیگر به صف اضافه میکنیم.
->catch(function ($exception) { ... })
در اینجا ما یک تابع برای مدیریت استثنا ایجاد میکنیم که وقتی یک استثنا در صف ایجاد میشود، کارهای خاصی مثل ثبت خطا در لاگ انجام میدهد.
->dispatch();
در نهایت، صف را برای انجام کارها اجرا میکنیم.