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.

Sponsored

serpapi logo
SerpApi

The Web Search API for Your LLM and AI Applications

Visit SerpApi

The latest

View all →
Laravel monitoring that doesn't bill you by your traffic image

Laravel monitoring that doesn't bill you by your traffic

Read article
Mock PHP Classes in Tests With the Double Library image

Mock PHP Classes in Tests With the Double Library

Read article
Laravel Discount: Coupon Codes, Usage Limits, and Stacking image

Laravel Discount: Coupon Codes, Usage Limits, and Stacking

Read article
Laravel Truss: Live Interactive Database ER Diagrams image

Laravel Truss: Live Interactive Database ER Diagrams

Read article
Laravel artisan dev: Run Server, Queue, Logs, and Vite image

Laravel artisan dev: Run Server, Queue, Logs, and Vite

Read article
Validate and Convert HEIC Images in Laravel image

Validate and Convert HEIC Images in Laravel

Read article