Laravel 10.40 - With a Number Clamp Method, an APA-Style Helper, Vite Asset Path Customization, and More

The Laravel team released v10.40 with a Number clamp method, an APA-style title case string helper, Vite asset path customization, and more. With Laravel 11 less than a month away, the community is moving full speed ahead on delivering new features, fixes, and improvements each week.

Here's some of the new features released this week:

#Add a Number clamp Method

James Brooks contributed a Number::clamp() method that clamps a given number between two numbers. This provides a way to restrict a given number between two other numbers. This method is probably best illustrated with some examples:

Number::clamp(number: 53, min:0, max: 999); // 53
Number::clamp(number: 0.5, min: 0, max: 1); // 0.5
Number::clamp(number: 20, min: 0, max: 1); // 1
Number::clamp(number: 10, min: 20, max: 30); // 20

#Add Session "except" method

Volodya Kurshudyan contributed an except() method to retrieve all session data except the specified array of items:

Session::all(); // 'email' => 'user@example.com', 'name' => 'Example User']
Session::except(['name']); // ['email' => 'user@example.com']

#Schema Builder is Macroable

Kevin Bui added the Macroable trait to the schema builder, which enables developers to define custom methods for the schema builder. Here's an example the author of the pull request provided:

use Illuminate\Database\Schema\Builder;
 
Builder::macro('hasForeignKey', function ($table, $key) {
    $foreignKeys = Schema::getForeignKeys($table);
 
    foreach ($foreignKeys as $foreignKey) {
        if ($foreignKey['name'] == $key) {
            return true;
        }
    }
 
    return false;
});

#Test Assertion for an empty view

Dwight Watson contributed an assertViewEmpty() method for the TestView class. You can now assert if the output of a view component is empty as follows:

$view = $this->view('welcome', ['name' => 'Example User', 'enabled' => false]);
 
$view->assertViewEmpty();

#Add dark mode support for Tailwind Pagination

Sabin Chacko contributed dark mode support for simple-paginate.blade.php and tailwind.blade.php files. See Pull Request #49515 for details.

#Allow Vite asset path customization

Tim MacDonald contributed the ability to customize the Vite asset path in more advanced situations where you cannot rely on a static value for app.asset_url using the following method in a service provider:

Vite::createAssetPathsUsing(function ($path, $secure) {
    return //...
});

#Assert job count using the QueueFake

Volodya Kurshudyan contributed an assertCount() assertion to the QueueFake

use Illuminate\Support\Facades\Queue;
 
Queue::fake();
Queue::assertNothingPushed();
 
// ...act...
 
Queue::assertCount(3);

#APA-style Title String Helper

Adam Campbell contributed an APA-style title helper that formats strings according to the APA Title Case Capitalization guidelines:

Str::apa($string);
 
str($string)->apa();

#Release notes

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

#v10.40.0

• [10.x] Model::preventAccessingMissingAttributes() raises exception for enums & primitive castable attributes that were not retrieved by @cosmastech in https://github.com/laravel/framework/pull/49480
• [10.x] Include system versioned tables for MariaDB by @hafezdivandari in https://github.com/laravel/framework/pull/49509
• [10.x] Fixes the Arr::dot() method to properly handle indexes array by @kayw-geek in https://github.com/laravel/framework/pull/49507
• [10.x] Expand Gate::allows & Gate::denies signature by @antonkomarev in https://github.com/laravel/framework/pull/49503
• [10.x] Improve numeric comparison for custom casts by @imahmood in https://github.com/laravel/framework/pull/49504
• [10.x] Add session except method by @xurshudyan in https://github.com/laravel/framework/pull/49520
• [10.x] Add Number::clamp by @jbrooksuk in https://github.com/laravel/framework/pull/49512
• [10.x] Fix Schedule test by @michaelnabil230 in https://github.com/laravel/framework/pull/49538
• [10.x] Use correct format of date by @buismaarten in https://github.com/laravel/framework/pull/49541
• [10.x] Clean Arr by @michaelnabil230 in https://github.com/laravel/framework/pull/49530
• [10.x] Make ComponentAttributeBag Arrayable by @iamgergo in https://github.com/laravel/framework/pull/49524
• [10.x] Fix whenAggregated when default is not specified by @lovePizza in https://github.com/laravel/framework/pull/49521
• [10.x] Update AsArrayObject.php to use ARRAY_AS_PROPS flag by @pintend in https://github.com/laravel/framework/pull/49534
• [10.x] Remove invalid RedisCluster::client() call by @tillkruss in https://github.com/laravel/framework/pull/49560
• [10.x] Remove unused code from PhpRedisConnector by @tillkruss in https://github.com/laravel/framework/pull/49559
• [10.x] Flush about command during test runs by @timacdonald in https://github.com/laravel/framework/pull/49557
• [10.x] Fix parentOfParameter method by @iamgergo in https://github.com/laravel/framework/pull/49548
• [10.x] Make the Schema Builder macroable by @kevinb1989 in https://github.com/laravel/framework/pull/49547
• [10.x] Remove unused code from tests by @imahmood in https://github.com/laravel/framework/pull/49566
• [10.x] Update Query/Builder.php $columns typehint by @Grldk in https://github.com/laravel/framework/pull/49563
• [10.x] Add assertViewEmpty to TestView by @dwightwatson in https://github.com/laravel/framework/pull/49558
• [10.x] Update tailwind.blade.php for dark mode by @sabinchacko03 in https://github.com/laravel/framework/pull/49515
• [10.x] Fix deprecation with null value in cache FileStore by @driesvints in https://github.com/laravel/framework/pull/49578
• [10.x] Allow Vite asset path customization by @timacdonald in https://github.com/laravel/framework/pull/49437
• [10.x] Type hinting of the second parameter of date- and time-related where*() methods of Illuminate\Database\Query\Builder by @lorenzolosa in https://github.com/laravel/framework/pull/49599
• [10.x] Fix Stringable::convertCase() return type by @vaites in https://github.com/laravel/framework/pull/49590
• Allow \Blade::stringable() to be called on native Iterables by @tsjason in https://github.com/laravel/framework/pull/49591
• [10.x] Refactor time handling using InteractsWithTime trait method by @xurshudyan in https://github.com/laravel/framework/pull/49601
• [10.x] Add assertCount test helper by @xurshudyan in https://github.com/laravel/framework/pull/49609
• [10.x] Ability to establish connection without using Config Repository by @deleugpn in https://github.com/laravel/framework/pull/49527
• [10.x] Add APA style title helper by @hotmeteor in https://github.com/laravel/framework/pull/49572
• [10.x] Fix usage of alternatives in error output by @Mrjavaci in https://github.com/laravel/framework/pull/49614
• [10.x] Use locks for queue job popping for PlanetScale's MySQL-compatible Vitess 19 engine by @crynobone in https://github.com/laravel/framework/pull/49561