A New String Helper, Assert Enums in AssertableJson, and more in Laravel 11.20
Last updated on by Paul Redmond
![A New String Helper, Assert Enums in AssertableJson, and more in Laravel 11.20 image](https://picperf.io/https://laravelnews.s3.amazonaws.com/featured-images/laravel11.jpg)
The Laravel team released v11.20 this week, including a new collection method, a deduplicate string method, the ability to use Enums with AssertableJson
, and more.
collapseWithKeys
to Collection
Add Jason McCreary contributed a collapseWithKeys()
method to the Illuminate\Support\Collection
class that collapses nested arrays while preserving their keys:
$c = collect([[1 => 'a'], [3 => 'c'], [2 => 'b']]);$c->collapseWithKeys();/*[ 1 => "a", 3 => "c", 2 => "b",]*/
deduplicate
to strings
Add Jason McCreary contributed a deduplicate
string helper that replaces consecutive occurrences of a character with a character:
Str::deduplicate('random double spaces'); // 'random double spaces'Str::deduplicate('/some//odd/path//', '/'); // '/some/odd/path/'(string) str('zondaaaa')->deduplicate('a'); // 'zonda'
Allow Custom View Path When Making Components
Andrew Brown contributed the ability to define a --path
flag when you need to create the view path in a custom file location:
php artisan make:component Foo --path custom/path
By default, the make:component
command will continue to use the resources/views/components
folder.
MixFileNotFoundException
Exception Class
Introduce a Ihor Vereshchynskyi contributed a new MixFileNotFoundException
class to handle missing Mix files. This exception provides a more precise error-handling mechanism when this exception gets thrown.
where
methods
Allow enums to be passed to AssertableJson Patrick O'Meara contributed the ability to use Enums while using where*
methods with AssertableJson
instances:
// Beforefn (AssertableJson $json) => $json->where('role', UserRole::Developer->value) // Afterfn (AssertableJson $json) => $json->where('role', UserRole::Developer)
Prompt to Create a Markdown Template When Making Notifications
Christoph Rumpel updated the make:notification
command to prompt for creating an optional markdown view when you don't provide any initial input:
php artisan make:notification
You will get the following prompts to select a markdown view for your notification class:
![Markdown view prompts in the make:notification command](https://laravelnews.s3.amazonaws.com/images/UrW1sB9wZpeCOitJ18k1CBvgVko2s3f9f3XKcaDq.png)
make:notification
commandstackContains()
and hiddenStackContains()
Methods to Context Stacks
Add @lessevv contributed the ability to check if a value (or hidden value) is contained in a context stack. Here are a few examples from Pull Request #52346:
// NormalContext::push('foo', 'bar', 'lorem'); Context::stackContains('foo', 'bar'); // trueContext::stackContains('foo', 'lorem'); // trueContext::stackContains('foo', 'doesNotExist'); // false // HiddenContext::pushHidden('foo', 'bar', 'lorem'); Context::hiddenStackContains('foo', 'bar'); // trueContext::hiddenStackContains('foo', 'lorem'); // trueContext::hiddenStackContains('foo', 'doesNotExist'); // false
Inverse Fake Queue Assertion Methods
Günther Debrauwer contributed assertNotDeleted
, assertNotFailed
, and assertNotReleased
assertions to the queue that you can use to assert the inverse of these methods:
use App\Jobs\ProcessPodcast; $job = (new ProcessPodcast)->withFakeQueueInteractions(); $job->handle(); $job->assertNotDeleted();$job->assertNotFailed();$job->assertNotReleased();
Facade::isFake()
Public
Make Caleb White contributed an update to the isFake()
method, making the visibility public:
use Illuminate\Support\Facades\Bus; Bus::isFake(); // falseBus::fake();Bus::isFake(); // true
Release notes
You can see the complete list of new features and updates below and the diff between 11.19.0 and 11.20.0 on GitHub. The following release notes are directly from the changelog:
v11.20.0
- Update testcase for
whereNone
method by @einar-hansen in https://github.com/laravel/framework/pull/52351 - Improve
Lock->block
method by @RedmarBakker in https://github.com/laravel/framework/pull/52349 - [11.x] Use correct pluralization rules in trans_choice for fallback strings by @stefanvdlugt in https://github.com/laravel/framework/pull/52343
- [11.x] Replace dead link in Security Policy by @Jubeki in https://github.com/laravel/framework/pull/52338
- Add compatible query type to
Model::resolveRouteBindingQuery
by @sebj54 in https://github.com/laravel/framework/pull/52339 - [10.x] Fix
Factory::afterCreating
callable argument type by @villfa in https://github.com/laravel/framework/pull/52335 - [11.x] Remove undefined class PreventRequestsDuringMaintenance by @seriquynh in https://github.com/laravel/framework/pull/52322
- [11.x] Add middleware before sending request and dispatching events by @eduance in https://github.com/laravel/framework/pull/52323
- Add
collapseWithKeys
toCollection
by @jasonmccreary in https://github.com/laravel/framework/pull/52347 - [11.x] Inverse Fake Queue Interactions:
assertNotDeleted
,assertNotFailed
, andassertNotReleased
by @gdebrauwer in https://github.com/laravel/framework/pull/52320 - Add
deduplicate
to strings by @jasonmccreary in https://github.com/laravel/framework/pull/52350 - [11.x] feat: make
Facade::isFake()
public by @calebdw in https://github.com/laravel/framework/pull/52357 - [11.x] Ask about markdown template for notification command with no initial input by @christophrumpel in https://github.com/laravel/framework/pull/52355
- [11.x] allow custom view path when making components by @browner12 in https://github.com/laravel/framework/pull/52219
- [11.x] chore: update to PHPStan Level 1 by @calebdw in https://github.com/laravel/framework/pull/51956
- [11.x] Support passing default as named parameter in whenLoaded, whenAggregated, whenCounted by @hn-seoai in https://github.com/laravel/framework/pull/51342
- Declare exceptions unreportable using the ShouldntReport interface by @chrispage1 in https://github.com/laravel/framework/pull/52337
- [11.x] Enable extension of connection inspection methods by @GromNaN in https://github.com/laravel/framework/pull/52231
- [11.x] Add
whenExistsLoaded
method to conditionally include relationship existence attribute by @CodeWithKyrian in https://github.com/laravel/framework/pull/52295 - [11.x] Add
in()
andinHidden()
functions to Context Stacks by @lessevv in https://github.com/laravel/framework/pull/52346 - [11.x] Use Command::fail() method for single error messages by @seriquynh in https://github.com/laravel/framework/pull/52387
- [11.x] Rework
Context::stackContains
with Closures. by @timacdonald in https://github.com/laravel/framework/pull/52381 - [11.x] Allow enums to be passed to AssertableJson where methods by @patrickomeara in https://github.com/laravel/framework/pull/52360
- [11.x] Made
list
validation rule as array for "size rules" in validation messages by @siarheipashkevich in https://github.com/laravel/framework/pull/52385 - [11.x] Add contextual attributes to resolve drivers by @ziadoz in https://github.com/laravel/framework/pull/52265
- [11.x] Fix docblocks for where(All|Any|None) query methods by @einar-hansen in https://github.com/laravel/framework/pull/52388
- [10.x] backport #52204 by @calebdw in https://github.com/laravel/framework/pull/52389
- [11.x] Fix Http Client Pool requests that have no response by @andrewbroberg in https://github.com/laravel/framework/pull/52393
- [11.x] Introduce MixFileNotFoundException for handling missing Mix files by @Ex10Dios in https://github.com/laravel/framework/pull/52400
- [10.x] In MySQL, harvest last insert ID immediately after query is executed by @piurafunk in https://github.com/laravel/framework/pull/52390