Laravel 8.48 Released


June 24th, 2021

Laravel 8.48 Released

The Laravel team released 8.48 with an on-demand filesystem disk, the ability to prune failed queue jobs, and the latest changes in the 8.x branch:

Prune Failed Queue Jobs Command

Mohamed Said contributed the ability to prune stale entries from the failed jobs table:

# Default 24 hours
php artisan prune:failed
# Specify hours
php artisan prune:failed --hours=12

Build an on-Demand Filesystem Disk

Andrew Brown contributed an on-demand filesystem disk, which allows you to configure a filesystem disk on-the-fly:

// String uses the local driver
// Full control over configuration
'driver' => 'local',
'root' => 'my-custom-path',
'url' => 'my-custom-url',
'visibility' => 'public',

Custom Event Stub File

Ryan Chandler contributed the ability to customize the event.stub used in the make:event command. See Customizing Stubs in Laravel if you’re interested in a hands-on example of publishing and customizing stubs in your application.

Macroable HTTP Client

Tim Robertson contributed making the HTTP Client macroable:

Having the Request macroable will allow for the elimination of excess boilerplate code when faking Http requests with body content other than Form or JSON, XML, for example.

Here’s an example from the pull request’s description:

Request::macro('xml', function () {
return CustomSuperDuperXmlParser::parse($this->body());
'*' => function (Request $request) {
$this->assertSame($request->xml()->someProperty, 'some value')
return Http::response();

Added GIF, WEBP, WBMP, BMP support to FileFactory::image()

Amir Reza Mehrbakhsh added support for GIF, WEBP, WBMP, and BMP when creating test file uploads. This PR updates the code to check the file extension and create the proper test image.

Release Notes

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



  • Added a queue:prune-failed command (#37696, 7aca658)
  • Added Illuminate/Filesystem/FilesystemManager::build() (#37720, c21fc12)
  • Allow customising the event.stub file (#37761)
  • Added Illuminate/Collections/Collection::sliding() and Illuminate/Collections/LazyCollection::sliding() (#37751)
  • Make Illuminate\Http\Client\Request macroable (#37744)
  • Added GIF, WEBP, WBMP, BMP support to FileFactory::image() (#37743)
  • Dispatch ‘connection failed’ event in http client (#37740)


  • Adds a small fix for unicode with blade echo handlers (#37697)
  • Solve the Primary Key issue in databases with sql_require_primary_key enabled (#37715)


  • Removed unnecessary checks in RequiredIf validation, fixed tests (#37700)
  • Replace non ASCII apostrophe in the email notification template (#37709)
  • Change the order of the bindings for a Sql Server query with a offset and a subquery order by (#37728, 401928b)
  • Bind mock instances as singletons so they are not overwritten (#37746)
  • Encode objects when casting as JSON (#37759)
  • Call on_stats handler in Http stub callbacks (#37738)

Filed in:

Paul Redmond

Full stack web developer. Author of Lumen Programming Guide and Docker for PHP Developers.