Laravel News Laravel News
News

UseFactory Attribute Added in Laravel 11.39

Published
UseFactory Attribute Added in Laravel 11.39 image

Release updates

Never miss a Laravel release

Get an email whenever a new Laravel release lands.

The Laravel team released v11.39, which includes a model factory class attribute, the ability to prevent destructive rollbacks, PhpRedis backoff and max retry options, and more.

Introduce the UseFactory attribute

Chris Arter contributed a UseFactory PHP attribute to define which factory a model should use. This is useful for registering a factory for models outside of the conventional App\Models namespace:

namespace App\SomeFeatureDomain\Models\Comment;
 
use Database\Factories\CommentFactory;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\Attributes\UseFactory;
 
#[UseFactory(CommentFactory::class)]
class Comment extends Model
{
    use HasFactory;
    // ...
}

Another way to override the factory convention is defining a newFactory() method, which still takes precedence over the UseFactory() attribute if you happen to define both:

use Database\Factories\CommentFactory;
 
/**
 * Create a new factory instance for the model.
 */
protected static function newFactory()
{
    return CommentFactory::new();
}

According to the pull request description, the factory resolution follows this priority:

  1. Static $factory property if defined
  2. UseFactory attribute if present
  3. Convention-based factory resolution

See the Model and Factory Discovery Conventions documentation for details on how factories are loaded using Laravel's conventions.

Add Report/Log Option to Filesystem

Sávio Resende contributed throw and report filesystem driver options. If both are set to true, that means that the disk will not throw exceptions and will report the errors:

'disks' => [
    'local' => [
        'driver' => 'local',
        'root' => storage_path('app'),
        'throw' => false, // Suppress exceptions
        'report' => true,    // Enable error logging
    ],
],

See Pull Request #54212 for details on how these options function.

Prevent Destructive Rollbacks

Rainer Bendig contributed the ability to prevent destructive RollbackCommand operations if the app has configured preventing destructive commands with:

DB::prohibitDestructiveCommands(true);

Allow Adding a Path to the Translation Loader

Selçuk Çukur contributed a addPath() method to add a directory for the translation loader:

It was not possible to add a new directory directly without a namespace for the translation loader. This method makes it possible to load translation lines by including a new directory directly in the loader without a namespace.

See Pull Request #54277 for details.

Add Support for phpredis Backoff and Max Retry Config Options

Petr Levtonov contributed configuration options for backoff and retry in the phpredis connector:

This pull request adds support for the ~phpredis backoff/retry~ configs.

Those settings are crucial for high performance applications. Currently I am forced to overwrite the driver in many services to leverage those configs. It would be amazing if you can merge this to support those configs out of the box.

I have confirmed with the phpredis maintainer, that those settings are currently only available to the normal Redis class, not for RedisCluster yet, so I did not add them to the cluster setup.

For reference, the PhpRedis section of the Laravel docs lists these new options.

Release notes

You can see the complete list of new features and updates below and the diff between 11.38.0 and 11.39.0 on GitHub. The following release notes are directly from the changelog:

v11.38.0

Paul Redmond photo

Staff writer at Laravel News. Full stack web developer and author.

X X Github Github
Filed in
News Laravel Releases

Sponsored

laravelcloud logo
Laravel Cloud

Easily create and manage your servers and deploy your Laravel applications in seconds.

Visit Laravel Cloud

The latest

View all →
CPX: The Composer Package Executor for PHP image

CPX: The Composer Package Executor for PHP

Read article
Laravel AI SDK Adds Human-in-the-Loop Tool Approval image

Laravel AI SDK Adds Human-in-the-Loop Tool Approval

Read article
Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals image

Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals

Read article
Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs image

Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs

Read article
Blade Formatting in Laravel Pint image

Blade Formatting in Laravel Pint

Read article
Inertia DevTools Is Now on the Chrome Web Store image

Inertia DevTools Is Now on the Chrome Web Store

Read article