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 ofIlluminate\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
The post Laravel 10.40 - With a Number Clamp Method, an APA-Style Helper, Vite Asset Path Customization, and More appeared first on Laravel News.
Join the Laravel Newsletter to get Laravel articles like this directly in your inbox.