Laravel 9.7版本发布

Laravel 团队发布了 Laravel v9.7.0，其中包含 whereIn() 路由参数约束方法、Str::squish() 助手、JSON 路径查询增强等：

查询生成器 whereBelongsTo() 接受集合

Erik Gaal 贡献了将集合传递给查询构建器中 whereBelongsTo() 方法的能力：

// Previously
$query
    ->whereBelongsTo($category[0])
    ->orWhereBelongsTo($category[1])
    // ...
 
// Or...
$query->whereIn('category_id', $categories->modelKeys());
 
 
// >=9.7 can use collections:
$query->whereBelongsTo($categories);
$query->whereBelongsTo($categories, 'category');

包含 Json Paths 的数据库查询支持数组索引

Derek MacDonald 贡献了在包含 JSON paths 的数据查询中支持数组索引:

DB::table('json_table')
    ->where('column->json_option[0]', 'foo')
    ->update(['column->json_option[0]', => 'bar']);

参见 Pull Request #41767 了解更多详细信息和相关 PRs/issues。

https://github.com/laravel/framework/pull/41767

路由事件在路由匹配之前触发

Tim Roberson 贡献了一个在路由器尝试匹配路由之前触发的事件。

这个事件允许开发者在路由开始前立即访问请求：

use Illuminate\Routing\Events\Routing;
Event::listen(function (Routing $event) {
    // ...
});

路由 whereIn () 参数约束方法

@Propaganistas 贡献了一个 whereIn() 路由参数约束方法，该方法可用于将路由参数与允许的值数组相匹配：

Route::get('/foo/{bar}')->whereIn('bar', $values);

Beanstalkd and SQS 队列的批处理作业延迟

OMAR.A 贡献了使用批处理作业延迟的能力。

在这些 PR 贡献之前， SQS 很 Beanstalkd 在向队列发送消息时忽略了延迟时间，现在，他们考虑到了预期的延迟。

use  App\Jobs\ImportCsv;
use  Illuminate\Bus\Batch;
use  Illuminate\Support\Facades\Bus;

$batch =  Bus::batch([
    (new  ImportCsv(1, 100))->delay($delay),
    (new  ImportCsv(101, 200))->delay($delay)
])->dispatch();

字符串操作助手类

Dwight Watson 提供了一个 squish() 字符串助手来删除给定字符串中的所有“额外”空格。

以下是拉取请求测试中的一些示例，以了解 squish 的作用：

$this->assertSame(
    'laravel php framework',
    Str::squish(' laravel php framework '));
 
$this->assertSame(
    'laravel php framework',
    Str::squish("laravel\t\tphp\n\nframework")
);
 
$this->assertSame(
    'laravel php framework',
    Str::squish('
        laravel
        php
        framework
    ')
);

查询生成器“whereJsonContainsKey()”方法

Derek MacDonald 贡献了 whereJsonContainsKey() 方法。 

它支持检查数组整数键并支持 SQLite。 以下是拉取请求描述中的一些示例：

DB::table('users')
    ->whereJsonContainsKey('options->languages')
    ->get();
 
DB::table('users')
    ->whereJsonDoesntContainKey('options->language->primary')
    ->get();
 
DB::table('users')
    ->whereJsonContainsKey('options->2fa[0]')
    ->get();
 
DB::table('users')
    ->whereJsonDoesntContainKey('options->2fa[0][1]')
    ->get();

响应后调度批处理

OMAR.A 提供了在向用户发送响应后调度批处理的能力：

$batch = Bus::batch([
    new ImportCsv(1, 100),
    new ImportCsv(101, 200),
    new ImportCsv(201, 300),
    new ImportCsv(301, 400),
    new ImportCsv(401, 500),
])->then(function (Batch $batch) {
    // All jobs completed successfully...
})->catch(function (Batch $batch, Throwable $e) {
    // First batch job failure detected...
})->finally(function (Batch $batch) {
    // The batch has finished executing...
})->dispatchAfterResponse();
 
// also, it returns a batch object so you can access batch id
return $batch->id;

发行说明

您可以在下面查看新功能和更新的完整列表以及 GitHub 上 9.6.0 和 9.7.0 之间的差异。 

以下发行说明直接来自变更日志：

https://github.com/laravel/framework/compare/v9.6.0...v9.7.0 

https://github.com/laravel/framework/blob/f981e239acca710d89ea91c2206fe543b3c7dd4c/CHANGELOG.md#v970---2022-04-05

v9.7.0

添加

让 whereBelongsTo 接受 Collection (#41733)
包含 JSON 路径的数据库查询支持数组索引大括号 (#41767)
路由匹配前触发事件 (#41765)
添加到 Illuminate/Http/Resources/ConditionallyLoadsAttributes::whenNotNull 方法 (#41769)
添加“whereIn”路由参数约束方法（#41794）
添加了 Illuminate/Queue/BeanstalkdQueue::bulk() (#41789)
添加了 Illuminate/Queue/SqsQueue::bulk() (#41788)
添加了 String::squish() 助手 (#41791)
添加了查询构建器方法 whereJsonContainsKey() (#41802)
为批处理启用 dispatchAfterResponse (#41787)

修复

工厂代修复 (#41688)
修复 Http Client throw 重试方法的布尔参数 (#41762, #41792)
忽略 PhpRedisConnector 中的空 redis 用户名字符串 (#41773)
修复了对 AsArrayObject/AsCollection 可空类型的支持 (#41797, 05846e7)
修复了将作业从可迭代添加到待处理批次 (#41786)
Http 客户端：修复连接异常的重试处理 (#41811)

改变了

为数据库队列启用批处理作业延迟 (#41758)
为 redis 队列启用批处理作业延迟 (#41783)
Http 客户端：为每次重试尝试发送“收到响应”事件 (#41793)
Http 客户端：提供挂起的请求以重试回调 (#41779)
允许 postgresql 的非长度限制字符串和字符 (#41800)
恢复一些 Carbon::setTestNow() 删除 (#41810)
使用并行测试时允许清理数据库 (#41806)

转：

https://laravel-news.com/laravel-9-7-0