Laravel 9.48 Released
The Laravel team released 9.48 this week with conditional fragment helpers, HTTP configuration options for Symfony mailers, a new DB schema helper, and more:
DB Schema helper to toggle foreign key constraints
Patrick Hesselberg contributed a withoutForeignKeyConstraints Schema method to conveniently disable foreign key constraints while managing a DB schema:
// Before
Schema::disableForeignKeyConstraints();
Schema::dropIfExists('table1');
Schema::dropIfExists('table2');
Schema::enableForeignKeyConstraints();
// After
Schema::withoutForeignKeyConstraints(function () {
Schema::dropIfExists('table1');
Schema::dropIfExists('table2');
});
New fragment helpers
Arko Elsenaar contributed a fragmentIf()
method to return a fragment of a view conditionally. Sending a fragment is useful when sending a partial HTML view over the wire in XHR requests, for example:
// Before
if (request()->hasHeader('HX-Request')) {
return view('products.index')->fragment('products-list');
}
return view('products.index');
// After
return view('products.index')
->fragmentIf(
request()->hasHeader('HX-Request'),
'products-list'
);
Arko also contributed a fragments()
method to return multiple fragments conveniently:
// Before using concatenation
view('welcome')->fragment('fragment1') . view('welcome')->fragment('fragment2');
// After
view('welcome')->fragments(['fragment1', 'fragment2']);
Building on Arko's first PR, the fragmentIf()
has an accompanying fragmentsIf()
method to conditionally render an array of fragments:
view('welcome')
->fragmentsIf(
request()->hasHeader('HX-Request'),
['fragment1', 'fragment2']
);
Increment each query builder method
Iman contributed an incrementEach()
method to increment multiple columns with a single query atomically:
DB::table('products')->where('id', 2)->incrementEach([
'in_store' => 2,
'in_stock' => 3,
'total' => 5,
], ['updated_at' => now()]);
Drop an index when modifying a column
Hafez Divandari contributed the ability to drop an index by its conventional name when modifying a column by passing false
to unique
:
$table->string('name')->unique(false)->change();
Configure custom HTTP client options for mailers
Dries Vints contributed the configuration of custom HTTP client options for Symfony's Postmark and Mailgun mailers:
'mailgun' => [
'transport' => 'mailgun',
'client' => [
'timeout' => 7.5 // Seconds
],
],
You can find the configuration options referenced in the Symfony Docs.
402 status code exception view
Zep Fietje contributed an exception view for the nonstandard 402
status code:
Currently no error page exists for exceptions with an HTTP status code of 402 Payment Required.
Even though it's a nonstandard response status code , it's used by multiple large companies to indicate functionality limited due to a payment being required.
HTTP client "notFound()" response helper
Erik Gaal contributed a notFound()
HTTP client response helper that provides a convenience around checking for a 404
response:
$response = Http::get('https://laravel.com');
// Checking the status code
if ($response->status() === 404) {
doSomething();
}
// New helper method
if ($response->notFound()) {
doSomething();
}
Release Notes
You can see the complete list of new features and updates below and the diff between 9.47.0 and 9.48.0 on GitHub. The following release notes are directly from the changelog:
v9.48.0 - 2023-01-17
Added
- Added
Illuminate/Database/Schema/Builder::withoutForeignKeyConstraints()
(#45601) - Added
fragments()
\fragmentIf()
\fragmentsIf()
methods toIlluminate/View/View.php
class (#45656, #45669) - Added
incrementEach()
anddecrementEach()
toIlluminate/Database/Query/Builder
(#45577) - Added ability to drop an index when modifying a column (#45513)
- Allow to set HTTP client for mailers (#45684)
- Added 402 exception view (#45682)
- Added
notFound()
helper to Http Client response (#45681)
Fixed
- Fixed decimal cast (#45602)
Changed
- Ignore whitespaces/newlines when finding relations in model:show command (#45608)
- Fail queued job with a string messag (#45625)
- Allow fake() helper in unit tests (#45624)
- allow egulias/email-validator v4 (#45649)
- Force countBy method in EloquentCollection to return base collection (#45663)
- Allow for the collection of stubs to be published (#45653)