Laravel 10.20版本发布

Laravel  /  管理员 发布于 1年前   344

本周，Laravel 团队发布了 v10.20，其中包括 createOrFirst() 方法、单一可调用基准、新的响应 JSON 断言等：

能说会道的 createOrFirst() 方法

Tony Messias 提供了 createOrFirst() 方法，该方法可尝试创建新记录。

如果发生违反唯一约束的情况，该方法会尝试查找匹配的记录：

$result = Model::createOrFirst(
    ['email' => '[email protected]'], // Attributes to find
    ['name' => 'Example User'] // values merged with attributes if created
);

即使没有软删除也能使用已销毁关系

Mior Muhammad Zaki 进行了一些更新，以支持在变形关系中使用 withTrashed()、withoutTrashed()、onlyTrashed()：

>这对某些第三方软件包很有用，因为这已成为一个问题，即无法定义关系，如 
$this->morphTo()->withTrashed()，除非所有关系都使用了 SoftDeletes 特质。
关系使用 SoftDeletes 特质...

您可以在 Pull Request #47880 的描述中了解有关此更改的更多信息。

对单个可调用代码进行基准测试并获得结果

Tim MacDonald 为基准工具类贡献了 value() 方法，您可以使用该方法内联测量给定的可调用代码并获取结果值：

public function list()
{
    [$response, $duration] = Benchmark::value(
        fn () => Http::get('https://external-service.com/list.json')
    );
 
    if ($duration > 1000) {
      Log::warning('external-service.com is running slow');
    }
 
    return $response->json();
}

将数据合并到 API 资源时允许使用默认值

Choraimy Kroonstuiver 提供了向 mergeWhen() 传递将使用的默认值的功能。

当需要提供默认值时，这将清理 mergeWhen() 和 mergeUnless 的逻辑：

下面是拉取请求中的一个示例，展示了在 Laravel 10.20 之前如何做到这一点：

class MyResource extends JsonResource
{
    public function toArray($request): array
    {
        return [
            /* other properties */
            $this->mergeWhen($this->hasSpecificData(), $this->specificData()),
            $this->mergeUnless($this->hasSpecificData(), static::genericData()),
        ];
    }
}

这就是你现在能做的：

class MyResource extends JsonResource
{
    public function toArray($request): array
    {
        return [
            /* other properties */
            $this->mergeWhen($this->hasSpecificData(), $this->specificData(), static::genericData()),
        ];
    }
}

典型 JSON 路径断言

Günther Debrauwer 提供了一个 assertJsonPathCanonicalizing() 方法，

您可以用它来检查 JSON 响应是否不按给定顺序包含所有预期值。

$users = User::factory()->count(2)->create();
 
$response = $this->get('/api/users');
$response->assertJsonPathCanonicalizing(
    'data.*.id',
    $users->pluck('id')->all()
);

有关更多详细信息和演示此功能的示例测试，请参见 Pull Request #48117。

版本说明

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

以下版本说明直接来自更新日志：

https://github.com/laravel/framework/compare/v10.19.0...v10.20.0
https://github.com/laravel/framework/blob/7f287ed2ee8aa0067b66c002b582f8ff7eedc00c/CHANGELOG.md#v10200---2023-08-22

v10.20.0

[10.x] 合并值到资源时允许使用默认值 
by @axlon in https://github.com/laravel/framework/pull/48073

[10.x] 为 Eloquent 添加 createOrFirst 方法
（作者 @tonysm，发布于 https://github.com/laravel/framework/pull/47973

[10.x] 允许在 MorphTo 关系上使用 withTrashed()、withTrashed() 和 onlyTrashed()，即使没有 SoftDeletes 模型 
by @crynobone in https://github.com/laravel/framework/pull/47880

[10.x] 将请求的 JSON 数据标记为 docblocks 中的 InputBag（输入包） 
by @jnoordsij in https://github.com/laravel/framework/pull/48085

[10.x] Markdown 邮件： 允许在自定义组件时省略页脚和页眉 
by @jorisnoo in https://github.com/laravel/framework/pull/48080

[10.x] 更新电子邮件验证请求返回 docblock 
by @ahmedash95 in https://github.com/laravel/framework/pull/48087

[10.x] 从第一方软件包中添加可重复使用的 Composer 相关常用命令，
作者 @crynobone 发布于 https://github.com/laravel/framework/pull/48096

[10.x] 添加测量单个调用并获取结果的功能，
作者 @timacdonald 发布于 https://github.com/laravel/framework/pull/48077

[10.x] 修正不正确的方法可见性，并为 Illuminate\Support\Composer 添加单元测试，
作者 @crynobone 发布于 https://github.com/laravel/framework/pull/48104

[10.x] 跳过将空字符串转换为 null 的测试 
by @hungthai1401 in https://github.com/laravel/framework/pull/48105

[10.x] 在将迁移转储附加到模式文件时使用完整插入 mysqldump 
by @emulgeator in https://github.com/laravel/framework/pull/48126

[10.x] 在 Composer 类中添加 hasPackage 方法，
作者 @emargareten 发布于 https://github.com/laravel/framework/pull/48124

[10.x] 添加 assertJsonPathCanonicalizing 方法，
作者 @gdebrauwer，原文地址：https://github.com/laravel/framework/pull/48117

[10.x] 可通过环境变量配置存储路径，
作者 @sl0wik，原文地址：https://github.com/laravel/framework/pull/48115

[10.x] 支持将子查询作为值提供给 where 生成器方法，
作者 @gdebrauwer，原文地址：https://github.com/laravel/framework/pull/48116

[10.x] 细微调整 
作者：@utsavsomaiya 发布于 https://github.com/laravel/framework/pull/48138

转：

https://laravel-news.com/laravel-10-20-0