Laravel 11.4 中的可逆表单提示和新的异常 Facade

上次更新于 作者:

Reversible Form Prompts and a New Exceptions Facade in Laravel 11.4 image

本周,Laravel 团队发布了 v11.4,其中包括可逆表单提示、新的异常 Facade、`Collection::mapInto()` 方法中的枚举支持等等。

介绍异常 Facade

Nuno Maduro 贡献了 `Exceptions` Facade

`Exceptions` Facade 提供了一种在 Laravel 应用程序中一致测试异常的方法。以下是 `Exceptions` Facade 提供的方法列表:

  • assertReported
  • assertReportedCount
  • assertNotReported
  • assertNothingReported
  • throwOnReport
  • throwFirstReported

以下是从 pull request 描述 中的示例,说明了 `Exceptions::fake()` 方法和 `assertReported()` 方法

use Illuminate\Support\Facades\Exceptions;
 
test('example', function () {
Exceptions::fake();
 
$this->post('/generate-report', [
'throw' => 'true',
])->assertStatus(503); // Service Unavailable
 
Exceptions::assertReported(ServiceUnavailableException::class);
 
// or
Exceptions::assertReported(function (ServiceUnavailableException $exception) {
return $exception->getMessage() === 'Service is currently unavailable';
});
});

阅读我们的 在 Laravel 测试中断言异常 文章以了解更多详细信息。

Livewire 样式指令

@devajmeireles 贡献了使用布尔值样式指令的能力,无需任何定义的值

{{-- Before --}}
 
<x-fetch wire:poll />
 
{{-- Generates this HTML --}}
 
<div ... wire:poll="wire:poll" />
 
{{-- After --}}
<x-fetch wire:poll />
 
<div ... wire:poll />

提示中的可逆表单

Luke Downing 贡献了表单提示,它们是用户需要完成的一组分组提示。表单包括能够返回到以前的提示并进行更改的能力,而无需取消命令并重新开始

use function Laravel\Prompts\form;
 
$responses = form()
->text('What is your name?', required: true)
->password('What is your password?', validate: ['password' => 'min:8'])
->confirm('Do you accept the terms?')
->submit();

以下是如何使用先前响应中的值的示例

$responses = form()
->text('What is your name?', name: 'name')
->add(fn () => select('What is your favourite language?', ['PHP', 'JS']), name: 'language')
->add(fn ($responses) => note("Your name is {$responses['name']} and your language is {$responses['language']}"))
->submit();

查看 `laravel/prompts` 项目中的 Pull Request #118,以了解实现细节。此功能已在 提示文档 中记录。

在 `mapInto` 集合方法上添加对枚举的支持

Luke Downing 贡献了对 `Collection::mapInto()` 方法上枚举的支持,它允许您从值的数组构建枚举

public function store(Request $request)
{
$request->validate([
'features' => ['array'],
'features.*' => [new Enum(Feature::class)],
]);
 
$features = $request
->collect('features')
->mapInto(Feature::class);
 
if ($features->contains(Feature::DarkMode)) {
// ...
}
}

一个 `afterQuery()` 钩子

Günther Debrauwer 贡献了一个 `afterQuery()` 钩子,在运行查询后运行代码

$query->afterQuery(function ($models) {
// Make changes to the queried models ...
});

以下是从 pull request 的 描述 中的用例示例

// Before
 
public function scopeWithIsFavoriteOf($query, ?User $user = null) : void
{
if ($user === null) {
return $query;
}
 
$query->addSelect([
// 'is_favorite' => some query ...
]);
}
 
$products = Product::withIsFavoriteOf(auth()->user())->get();
 
if (auth()->user() === null) {
$products->each->setAttribute('is_favorite', false);
}

以下是如何使用 `afterQuery()` 钩子的代码

// After
 
public function scopeWithIsFavoriteOf($query, ?User $user = null) : void
{
if ($user === null) {
$query->afterQuery(fn ($products) => $products->each->setAttribute('is_favorite', false));
 
return;
}
 
$query->addSelect([
// 'is_favorite' => some query ...
]);
}
 
Product::withIsFavoriteOf(auth()->user())->get();

发行说明

您可以在下面查看新功能和更新的完整列表,以及 GitHub 上 11.3.0 和 11.4.0 之间的差异。以下发行说明直接来自 变更日志

v11.4.0

Paul Redmond photo

Laravel News 的撰稿人。全栈式网络开发人员和作家。

Cube

Laravel 新闻通讯

加入 40,000 多名其他开发者,永不错过新的技巧、教程等等。

Laravel Forge logo

Laravel Forge

轻松创建和管理您的服务器,并在几秒钟内部署您的 Laravel 应用程序。

Laravel Forge
Tinkerwell logo

Tinkerwell

Laravel 开发人员必备的代码运行器。使用 AI、自动完成和对本地和生产环境的即时反馈进行试验。

Tinkerwell
No Compromises logo

绝不妥协

Joel 和 Aaron,来自“绝不妥协”播客的两位经验丰富的开发者,现在可以为您的 Laravel 项目聘用。 ⬧ 固定价格为每月 7500 美元。 ⬧ 没有冗长的销售流程。 ⬧ 没有合同。 ⬧ 100% 退款保证。

绝不妥协
Kirschbaum logo

Kirschbaum

提供创新和稳定性,以确保您的 Web 应用程序取得成功。

Kirschbaum
Shift logo

Shift

运行旧版 Laravel 版本?即时、自动化的 Laravel 升级和代码现代化,使您的应用程序保持新鲜。

Shift
Bacancy logo

Bacancy

用一位经验丰富的 Laravel 开发人员为您的项目充电,该开发人员拥有 4-6 年的经验,每月仅需 2500 美元。获得 160 小时的专业知识和无风险的 15 天试用期。立即安排通话!

Bacancy
Lucky Media logo

Lucky Media

现在就获得 Lucky - Laravel 开发的理想选择,拥有十多年的经验!

Lucky Media
Lunar: Laravel E-Commerce logo

Lunar: Laravel 电子商务

Laravel 的电子商务。一个开源软件包,将现代无头电子商务功能的力量带到 Laravel。

Lunar: Laravel 电子商务
LaraJobs logo

LaraJobs

官方 Laravel 职位板

LaraJobs
SaaSykit: Laravel SaaS Starter Kit logo

SaaSykit: Laravel SaaS 启动套件

SaaSykit 是一个 Laravel SaaS 启动套件,它包含运行现代 SaaS 所需的所有功能。支付、漂亮的结账、管理面板、用户仪表板、身份验证、准备好的组件、统计数据、博客、文档等等。

SaaSykit: Laravel SaaS 启动套件
Rector logo

Rector

您无缝升级 Laravel、降低成本和加速创新的合作伙伴,以帮助成功企业。

Rector
MongoDB logo

MongoDB

通过 MongoDB 和 Laravel 的强大集成增强您的 PHP 应用程序,使开发人员能够轻松高效地构建应用程序。支持事务、搜索、分析和移动用例,同时使用熟悉的 Eloquent API。了解 MongoDB 的灵活、现代数据库如何改变您的 Laravel 应用程序。

MongoDB
Maska is a Simple Zero-dependency Input Mask Library image

Maska 是一个简单的零依赖输入掩码库

阅读文章
Add Swagger UI to Your Laravel Application image

在您的 Laravel 应用程序中添加 Swagger UI

阅读文章
Assert the Exact JSON Structure of a Response in Laravel 11.19 image

在 Laravel 11.19 中断言响应的精确 JSON 结构

阅读文章
Build SSH Apps with PHP and Laravel Prompts image

使用 PHP 和 Laravel 提示构建 SSH 应用程序

阅读文章
Building fast, fuzzy site search with Laravel and Typesense image

使用 Laravel 和 Typesense 构建快速、模糊的网站搜索

阅读文章
Add Comments to your Laravel Application with the Commenter Package image

使用 Commenter 软件包向您的 Laravel 应用程序添加评论

阅读文章