لاراول ۱۳.۲۱ منتشر شد: ویژگی RouteKey، اعتبارسنجی Base64 و فرمت‌های تصویری بیشتر

اتریبیوت #[RouteKey] برای مدل‌های Eloquent

مشکل قدیمی، راه‌حل جدید

class Post extends Model
{
    public function getRouteKeyName()
    {
        return 'slug';
    }
}

use Illuminate\Database\Eloquent\Attributes\RouteKey;

#[RouteKey('slug')]
class Post extends Model
{
    // ...
}

قانون اعتبارسنجی base64

نحوه استفاده

$request->validate([
    'signature' => ['required', 'base64'],
]);

چرا این ویژگی مهم است؟

• رشته باید به درستی decode شود
• پس از decode و encode مجدد، باید دقیقاً همان رشته اولیه تولید شود
• این یعنی اشتباهات Padding یا کاراکترهای اضافی به راحتی شناسایی می‌شوند

اتریبیوت زمینه‌ای #[RequestAttribute]

مشکل چیست؟

public function index(Request $request)
{
    $org = $request->attributes->get('org');
    // ...
}

راه‌حل جدید

use Illuminate\Container\Attributes\RequestAttribute;

class InventoryController
{
    public function index(
        #[RequestAttribute('org')] Organization $org
    ) {
        return $this->inventoryService->getForOrg($org);
    }
}

فرمت‌های خروجی بیشتر برای کامپوننت Image

چه چیزی اضافه شده؟

• toPng()
• toGif()
• toAvif()
• toBmp()

مثال استفاده

use Illuminate\Support\Facades\Image;

Image::fromUpload($request->file('avatar'))
    ->cover(400, 400)
    ->toAvif()
    ->quality(80)
    ->store('avatars');

اصلاح باگ مهم

Application Builder قابل شخصی‌سازی

چه تغییری ایجاد شده؟

Subsplit کامپوننت Concurrency

سایر اصلاحات و بهبودها

پایگاه داده

• Callbackهای Rollback: callbackهای تراکنش‌های دیتابیس حالا به درستی فراخوانی می‌شوند (PR #60777)
• Lost Connection: یک پیام خطای جدید برای از دست دادن اتصال شناسایی شده که امکان reconnect خودکار را فراهم می‌کند (PR #60819)
• Question Marks: علامت سوال در Grammar::whereColumn() به درستی escape می‌شود (PR #60832)

لاگ و کش

• LogManager: ارسال enum به LogManager::forgetChannel() دیگر TypeError نمی‌دهد (PR #60801)
• RedisTaggedCache: متد decrement() حالا enum keys را به درستی مدیریت می‌کند (PR #60821)

رشته‌ها و Utilityها

• Str::wordWrap(): حالا رشته‌های multibyte را به درستی مدیریت می‌کند (PR #60814)

اتریبیوت‌ها و Dependency Injection

• Contextual Attribute Caching: کش کردن اتریبیوت‌های زمینه‌ای دیگر بین propertyهای یک کلاس تداخل ایجاد نمی‌کند (PR #60815)
• Concurrency Exception: پارامترهای falsey در exceptionهای concurrency حفظ می‌شوند (PR #60822)

دستورات و Pipeline

• Serve Command: پارس کردن پورت host در دستور serve اصلاح شده است (PR #60828)
• Pipeline Hub: یک undefined index در Pipeline\Hub::pipe() برطرف شده است (PR #60802)

Jobها و Queue

• InvalidPayloadException: پیام‌های این exception حالا نام job و queue را شامل می‌شوند که دیباگ را آسان‌تر می‌کند (PR #60799)

مقایسه با نسخه‌های قبلی

• Developer Experience: اتریبیوت‌های جدید مثل #[RouteKey] و #[RequestAttribute] کد را خواناتر و نگهداری آن را آسان‌تر می‌کنند
• Validation: اضافه شدن قانون base64 نشان می‌دهد که لاراول به نیازهای واقعی توسعه‌دهندگان گوش می‌دهد
• Image Processing: پشتیبانی از فرمت‌های مدرن مثل AVIF نشان‌دهنده به‌روز بودن لاراول با استانداردهای وب است

مزایا و معایب به‌روزرسانی

• کاهش کد boilerplate با اتریبیوت‌های جدید
• اعتبارسنجی دقیق‌تر با قانون base64
• انعطاف‌پذیری بیشتر در پردازش تصاویر
• دیباگ آسان‌تر با پیام‌های خطای بهتر

• این یک نسخه مینور است و تغییرات breaking change ندارد
• برای استفاده از ویژگی‌های جدید، باید PHP 8.1 یا بالاتر داشته باشید (به دلیل استفاده از Attributes)

جمع‌بندی نهایی و نگاه شخصی

سوالات متداول