Laravel 9.30 Released

The Laravel team released 9.29 and 9.30 with a read-only filesystem option, a scoped filesystem driver, the ability to discard model changes, and more.

Note: we last covered Laravel 9.28.0, so this release post covers both 9.29 and 9.30.

Read-only filesystem config option

Frank de Jonge contributed to configuring a filesystem disk to operate in read-only mode. This ensures no write operations are possible on the disk, which is useful when accessing storage you want to ensure doesn't manipulate any files.

Here's a config example from the pull request for this feature:

$disk = $filesystem->build([
    'driver' => 'local',
    'read-only' => true,
    'root' => 'my-custom-path',
    'url' => 'my-custom-url',
    'visibility' => 'public',
]);

Scoped filesystem driver

Frank de Jonge contributed scoped filesystem drivers, which enables a way to reuse disk configurations. Here's an example from the pull request description:

[
    's3' => [
        'driver' => 's3',
        'key' => env('AWS_ACCESS_KEY_ID'),
        'secret' => env('AWS_SECRET_ACCESS_KEY'),
        'region' => env('AWS_DEFAULT_REGION'),
        'bucket' => env('AWS_BUCKET'),
        'url' => env('AWS_URL'),
        'endpoint' => env('AWS_ENDPOINT'),
        'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),
        'throw' => false,
    ],
    's3_videos' => [
        'driver' => 'scoped',
        'prefix' => 'path/for/videos',
        'disk' => 's3',
    ],
]

Add force option to all "make" commands

James Brooks contributed a --force flag to all make:* commands, which is helpful when you need to recreate a file.

"Required if accepted" validation rule

Pascal Baljet contributed a required_if_accepted validation rule which ensures the field under validation is required if another field is accepted (a value of yes, on, 1, or true):

Validator::make([
    'is_company'   => 'on',
    'company_name' => 'Apple',
], [
    'is_company'   => 'required|boolean',
    'company_name' => 'required_if_accepted:is_company',
]);

Ability to discard Eloquent model changes

Mior Muhammad Zaki contributed a discardChanges() method to discard attribute changes and reset attributes to their original state:

$user = new EloquentModelStub([
    'name' => 'Taylor Otwell',
]);
 
$user->getOriginal('name'); // null
 
$user->getAttribute('name'); // Taylor Otwell
$user->discardChanges();
$user->getAttribute('name'); // null

Determine if attachments exist

Andrew Minion contributed to determining if the given attachments are included in a mailable. Three methods were added that can help assert attachments in tests:

$mailable = new InvoicePaid($user);
 
// Test normal attachment.
$this->assertTrue(
    $mailable->hasAttachment('Receipt.pdf')
);
 
// Test attachment from storage disk.
$this->assertTrue(
    $mailable->hasAttachmentFromStorageDisk('s3', 'invoices', $user->latest_invoice->name)
);
 
// Test raw attachment.
$this->assertTrue(
    $mailable->hasAttachedData('12345', 'confirmation.txt')
);

Release Notes

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

v9.30.0

Added

• Added stop_buffering config option to logger (#44071)
• Added read-only filesystem adapter decoration as a config option (#44079)
• Added scoped filesystem driver (#44105)
• Add force option to all make commands (#44100)

Fixed

• Fixed QueryBuilder whereNot with array conditions (#44083)

Changed

• Passing event into viaQueue and viaConnection of Queued Listener (#44080)
• Improve testability of batched jobs (#44075)
• Allow any kind of whitespace in cron expression (#44110)

v9.29.0

Added

• Added RequiredIfAccepted validation rule (#44035)
• Added Illuminate/Foundation/Vite::assetPath() (#44037)
• Added ability to discard Eloquent Model changes (#43772)
• Added ability to determine if attachments exist to Illuminate/Mail/Mailable (#43967)
• Added Illuminate/Support/Testing/Fakes/BusFake::assertNothingBatched() (#44056)

Reverted

• Reverted Fixed RoueGroup::merge to format merged prefixes correctly. (#44072)

Fixed

• Avoid Passing null to parameter exception on PHP 8.1 (#43951)
• Align Remember Me Cookie Duration with CookieJar expiration (#44026)
• Fix Stringable typehints with Enumerable (#44030)
• Fixed middleware "SetCacheHeaders" with file responses (#44063)

Changed

• Don't use locks for queue job popping for PlanetScale's MySQL-compatible Vitess engine (#44027)
• Avoid matching 'use' in custom Stub templates in Illuminate/Console/GeneratorCommand.php (#44049)