Improved HTTP Client URL Parameter Merging in Laravel 12.33

The Laravel team released version 12.33.0, introducing a Stringable doesntContain() method, merging (instead of replacing) HTTP client URL parameters, improved broadcast manager resolution errors, and more.

Stringable `doesntContain()` Method

Michael Contento contributed a doesntContain() method on Stringable to match the Str helper and provide symmetry with the existing contains() method.

$str = str('laravel-news.com');
 
$str->contains('laravel'); // true
$str->doesntContain('laravel'); // false
$str->doesntContain('NEWS'); // true
$str->doesntContain('NEWS', ignoreCase: true); // false

Http Client Merge Parameters

Chris Jones proposed a mergeUrlParameters() method to Http PendingRequest because withUrlParameters replaces all parameters. Instead, Taylor Otwell updated to PR to always merge parameters instead of introducing a new method:

Http::macro('service', function () {
    return Http::baseUrl('https://api.example.com')
        ->withUrlParameters(['version' => 'v1', 'tenant' => 'acme']);
});
 
// Before: <12.33, `version` is removed.
Http::service()->withUrlParameters(['tenant' => 'beta']);
// ['tenant' => 'beta']
 
// After: +12.33, params are merged.
Http::service()->withUrlParameters(['tenant' => 'beta']);
// ['version' => 'v1', 'tenant' => 'beta']

The withUrlParameters() change is non-breaking—if you need to customize URL parameters on a reusable pending request, you can solely provide any parameters you intend to override.

Improve BroadcastManager Error Messages

Mathias Grimm contributed a clearer error message when a broadcast driver fails to initialize:

// Before:
//   TypeError: Pusher\Pusher::__construct(): Argument #3 ($app_id) must be of type string, null given
 
// After:
//   BroadcastException: Failed to create broadcaster for connection "my-connection" with error:
//   Pusher\Pusher::__construct(): Argument #3 ($app_id) must be of type string, null given

Release notes

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