Laravel 10.14版本发布

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

本周, Laravel团队发布了v10.14版本，新增了can验证规则，定义自定义Gate拒绝响应，全局HTTP客户端中间件，HTTP客户端便利方法，以及更多：

 >最近合并到Laravel, Rule::can验证规则, 允许你在表单输入上授权一个能力!
  这允许你将一些授权逻辑从控制器中移到表单请求中 -- 并显示一个验证错误，而不是自己处理它。 
  pic.twitter.com/UvC52Q8WZa
  
 - Steve Bauman (@ste_bau) 6月22日, 2023

Rule::can()验证规则

Steve Bauman贡献了Rule::can()验证规则，它提供了一种为给定表单字段授权能力的方法。

下面是Pull Request #47371中给出的例子。

给出以下PostPolicy：

// Given the following policy
class PostPolicy
{
    // ...
 
    public function updateAuthor(User $user, Post $post)
    {
        return $user->isAdmin();
    }
}

我们可以验证用户是否有能力更新作者：

use App\Models\Post;
 
class PostRequest extends FormRequest
{
    public function rules()
    {
        return [
            'author' => Rule::can('update-author', Post::class, $this->route('post')),
            'title' => '...',
            'body' => '...',
        ];
    }
}

为Gate@inspect()中的拒绝设定一个自定义响应

Luke Kuzmish 贡献了在 Gate 的 inspect() 方法失败时设置返回响应的能力。

例如，当与can()中间件一起使用时：

class AppServiceProvider extends ServiceProvider
{
    public function boot()
    {
        Gate::setDenialResponse(Response::denyAsNotFound());
    }
}

全局HTTP中间件

Tim MacDonald贡献了定义全局HTTP客户端中间件的能力，它被应用于HTTP客户端的每个请求：

// In a service provider...
 
use Illuminate\Support\Facades\Http;
 
// Global request middleware
Http::globalRequestMiddleware(
    fn ($request) => $request->withHeader('User-Agent', 'Laravel Framework/1.0')
);
 
// Global response middleware
Http::globalResponseMiddleware(
    fn ($response) => $response->withHeader('X-Finished-At', now()->toDateTimeString())
);
 
// Complete global middleware that wraps both request and response
Http::globalMiddleware(function ($handler) {
    return function ($request, $options) use ($handler) {
        $startedAt = now();
 
        return $handler($request, $options)
            ->then(fn ($response) => $response->withHeader(
                'X-Duration', $startedAt->diffInMilliseconds(now())
            ));
    };
});

你也可以定义一次性的middlware--查看Pull Request #47525中的所有细节，看看有什么可能!

为PendingRequest增加一个withHeader()方法

Ralph J. Smit贡献了一个withHeader方法，用于在使用HTTP客户端时设置一个单一的头：

// Using an array
Http::baseUrl(config('services.active-campaign.endpoint') . '/api/3')
    ->withHeaders([
        'Api-Token' => config('services.active-campaign.token')
    ])
    ->acceptJson();
 
 
// Setting a single header using `withHeader()`
Http::baseUrl(config('services.active-campaign.endpoint') . '/api/3')
    ->withHeader('Api-Token', config('services.active-campaign.token'))
    ->acceptJson();

在HTTP客户端添加withQueryParameters便利方法

Matthieu Napoli贡献了一个withQueryParameters()方法，作为定义查询参数的便利方法，这些参数应该总是在HTTP请求中被定义：

// Using `withOptions()`
Http::baseUrl('https://api.convertkit.com/v3/')
    ->withOptions([
        'query' => [
            'api_secret' => config('services.convertkit.api_secret'),
        ],
    ])
    ->acceptJson();
 
// Using the new `withQueryParameters()` method
Http::baseUrl('https://api.convertkit.com/v3/')
    ->withQueryParameters([
        'api_secret' => config('services.convertkit.api_secret'),
    ])
    ->acceptJson();

发布说明

你可以在GitHub上看到以下完整的新功能和更新列表以及10.13.0和10.14.0之间的差异。

下面的发行说明直接来自更新日志：

https://github.com/laravel/framework/compare/v10.13.0...v10.14.0
https://github.com/laravel/framework/blob/fff5b0bf6eefccbedfa88405b97435f9eb4e3452/CHANGELOG.md#v10140---2023-06-27

v10.14.0

[10.x] 添加RedirectResponse中withCookies方法的测试
by @milwad-dev in https://github.com/laravel/framework/pull/47383

[10.x] 增加新的错误信息 "SSL: Handshake timed out "处理到PDO Dete...
by @yehorherasymchuk in https://github.com/laravel/framework/pull/47392

[10.x] 增加新的错误信息以检测丢失的连接
由 @mfn 在https://github.com/laravel/framework/pull/47398

[10.x] 更新中间件的phpdoc except方法
by @milwad-dev 在 https://github.com/laravel/framework/pull/47408

[10.x] 修复$passwordTimeoutSeconds的不一致的类型提示
by @devfrey 在 https://github.com/laravel/framework/pull/47414

改变FileStore.php中路径方法的可见性
作者：@foremtehan 在 https://github.com/laravel/framework/pull/47413

[10.x] 修正buildException方法的返回类型
by @milwad-dev 在 https://github.com/laravel/framework/pull/47422

[10.x] 允许NotificationSent的序列化
由 @cosmastech 在https://github.com/laravel/framework/pull/47375

[10.x] PredisConnector和PhpRedisConnector中不正确的注释
由 @hungthai1401 在 https://github.com/laravel/framework/pull/47438 发表

[10.x] 可以在Gate@inspect()中设置自定义的Response进行拒绝，
由@cosmastech在https://github.com/laravel/framework/pull/47436。

[10.x] 删除addSingletonUpdate中不必要的参数
作者：@milwad-dev 在 https://github.com/laravel/framework/pull/47446

[10.x] 修正prefixedResource & prefixedResource的返回类型
by @milwad-dev in https://github.com/laravel/framework/pull/47445

[10.x] 增加Factory::getNamespace()
作者：@tylernathanreed 在 https://github.com/laravel/framework/pull/47463

[10.x] 为ConditionallyLoadsAttributes特性添加whenAggregated方法
by @akr4m in https://github.com/laravel/framework/pull/47417

[10.x] 添加PendingRequest withHeader()方法
by @ralphjsmit 在 https://github.com/laravel/framework/pull/47474

[10.x] 修正$exceptTables，允许使用表名数组，
作者：@cwilby 在https://github.com/laravel/framework/pull/47477

[10.x] 修正HasManyThrough关系中的eachById，
由@cristiancalara在https://github.com/laravel/framework/pull/47479。

[10.x] 允许禁用自定义类铸造者的对象缓存
由 @CalebDW 在 https://github.com/laravel/framework/pull/47423 发表

[10.x] "Can "验证规则
由 @stevebauman 在https://github.com/laravel/framework/pull/47371

[10.x] 重构(Parser.php)： 删除多余的 "else "语句
作者：@saMahmoudzadeh 在 https://github.com/laravel/framework/pull/47483

[10.x] 在 ValidationServiceProvider 中的 provides() 中添加 UncompromisedVerifier::class，
由 @xurshudyan 在 https://github.com/laravel/framework/pull/47500 发表

[10.x] Reindex appends attributes
by @hungthai1401 in https://github.com/laravel/framework/pull/47519

[10.x] 修复ListenerMakeCommand的弃用
由 @dammy001 在 https://github.com/laravel/framework/pull/47517 发表

[10.x] 增加HandlesPotentiallyTranslatedString特性
by @xurshudyan 在https://github.com/laravel/framework/pull/47488

[10.x] 更新[JsonResponse]：使用匹配表达式而不是if-elseif-else
by @saMahmoudzadeh 在 https://github.com/laravel/framework/pull/47524

[10.x] 在HTTP客户端中添加withQueryParameters
由 @mnapoli 在 https://github.com/laravel/framework/pull/47297 发表

[10.x] 允许组件属性名称中的%符号
由 @JayBizzle 在 https://github.com/laravel/framework/pull/47533 发表

[10.x] 修复Http客户端池的返回类型
由 @srdante 在 https://github.com/laravel/framework/pull/47530 中提供

[10.x] 在resolveSynchronousFake中使用匹配表达式
by @osbre in https://github.com/laravel/framework/pull/47540

[10.x] 在compileHaving中使用匹配表达式
by @osbre in https://github.com/laravel/framework/pull/47548

[10.x] 在getArrayableItems中使用匹配表达式
by @osbre in https://github.com/laravel/framework/pull/47549

[10.x] 修复SessionGuard的返回类型
by @PerryvanderMeer 在 https://github.com/laravel/framework/pull/47553

[10.x] 修复DatabaseQueue中的返回类型
by @PerryvanderMeer 在https://github.com/laravel/framework/pull/47552

[10.x] 修复DumpCommand中的返回类型
by @PerryvanderMeer 在https://github.com/laravel/framework/pull/47556

[10.x] 修复MigrateMakeCommand的返回类型
by @PerryvanderMeer in https://github.com/laravel/framework/pull/47557

[10.x] 添加缺失的回报给工厂，
由 @PerryvanderMeer 在https://github.com/laravel/framework/pull/47559

[10.x] 更新Eloquent模型中的文档
由 @alirezasalehizadeh 在https://github.com/laravel/framework/pull/47562

[10.x] 修正返回类型
由 @PerryvanderMeer 在 https://github.com/laravel/framework/pull/47561 发表

[10.x] 修复PHPDoc的抛出类型
作者：@fernandokbs 在 https://github.com/laravel/framework/pull/47566

[10.x] 为ComponentAttributeBag添加hasAny函数，允许has函数中的多个键
由@indykoning在https://github.com/laravel/framework/pull/47569。

[10.x] 确保捕获的时间是在配置的时区
由 @timacdonald 在 https://github.com/laravel/framework/pull/47567 发表

[10.x] 增加只报告已记录的异常的方法
by @joelharkes 在 https://github.com/laravel/framework/pull/47554

[10.x] 为Http客户端添加全局中间件
by @timacdonald in https://github.com/laravel/framework/pull/47525

这个版本时隔半个月，终于发布了，看起来东西有点多。

转：

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