在 Laravel 8.36 中使用自定义 Stub 创建控制器

Laravel 团队发布了 8.36，其中包含在创建控制器时使用自定义 Stub 的选项，MySQL 中蓝图日期时间列的 useCurrentOnUpdate 方法，dispatch_sync() 辅助函数，以及 8.x 分支的最新变更。

#支持 MySQL Datetime 列的 useCurrentOnUpdate

Tim Martin 为 MySQL DATETIME 列类型贡献了 对 useCurrentOnUpdate 的支持

这允许更有效地使用 DATETIME 列来存储元数据，例如 created_at 和 updated_at。由于 MySQL 中的 TIMESTAMP 列存在 2038 年问题，因此在某些应用程序中，使用 DATETIME 列更可取。

以下是一个测试用例

$blueprint = new Blueprint('users');
$blueprint->dateTime('foo')->useCurrentOnUpdate();
$statements = $blueprint->toSql($this->getConnection(), $this->getGrammar());
$this->assertCount(1, $statements);
$this->assertSame('alter table `users` add `foo` datetime on update CURRENT_TIMESTAMP not null', $statements[0]);

#队列 dispatch_sync() 辅助函数

Dries Vints 贡献了一个 dispatch_sync() 辅助函数，作为 dispatch_now() 的替代方案。dispatchSync() 方法是执行同步调度（立即执行）的推荐方法。有关更多详细信息，请参阅 同步调度 文档。

#允许通过闭包跳过 TransformRequests 中间件

Taylor Otwell 贡献了跳过 TrimStrings 和 ConvertEmptyStringsToNull 中间件的能力。该 拉取请求 描述了这如何帮助 Laravel 包，如 Livewire 和 Octane。

目前，Livewire 必须进行一些不好的操作来跳过某些请求上的这些中间件，并且这种方法不适合与 Octane 一起使用。添加此功能将允许 Livewire 和其他库在框架启动过程期间向此基本中间件注册一个回调函数，以确定是否应该跳过中间件。该回调函数将在每次调用时接收当前请求。

以下是在拉取请求中给出的一些示例，但通常情况下，您不需要在 Laravel 应用程序中使用此功能，除非您正在构建非常具体的包（例如 Livewire），这些包需要这种高级控制。

TrimStrings::skipWhen(fn ($request) => shouldBeSkipped($request));
ConvertEmptyStringsToNull::skipWhen(fn ($request) => shouldBeSkipped($request));

#在创建控制器时使用自定义 Stub 类型

Brian Dillingham 为 make:controller 命令贡献了一个 --type 标志，用于为控制器定义自定义 Stub 类型。

php artisan make:controller CustomController --type=custom

这将查找应用程序中的 /stubs/controller.custom.stub 文件，并在创建文件时使用它。自定义 Stub 有助于在项目中创建新控制器时获得更多控制权，并减少手动编辑的需要。

#queue:prune-batches 命令的 Unfinished 选项

Dries Vints 为 queue:prune-batches 控制台命令贡献了一个 --unfinished 选项，该选项接受一个整数，表示保留未完成批处理数据的时长（以小时为单位）。使用 --unfinished 选项，该命令将根据批处理创建时间（早于 X 小时）来修剪已完成的批处理和未完成的批处理。

#字符串重复方法

Jona Löffler 为 Str 和 Stringable 类贡献了 repeat() 方法。以下是一个拉取请求测试用例

$this->assertSame('aaaaa', Str::repeat('a', 5));
$this->assertSame('aaaaa', (string) $this->stringable('a')->repeat(5));

#发行说明

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

#v8.36.0

#还原

• 还原 "[8.x] 允许从生成器实例化延迟集合" (#36844)

#新增

• 添加了对 MySQL datetime 列类型 useCurrentOnUpdate 的支持 (#36817)
• 添加了 dispatch_sync() 辅助函数 (#36835)
• 允许通过闭包跳过 TransformRequests 中间件 (#36856)
• 为 make 控制器命令添加了 type 选项 (#36853)
• 在 Illuminate\Support\Manager::forgetDrivers() 中添加了缺失的 return $this (#36859)
• 为 PruneBatchesCommand 添加了 unfinished 选项 (#36877)
• 添加了一个简单的 Str::repeat() 辅助函数 (#36887)

#修复

• 修复了带标签缓存的 getMultiple 和 increment/decrement (0d21194)
• 在缓存 increment 和 decrement 中实现了正确的返回类型 (#36836)
• 修复了 blade 编译器正则表达式问题 (#36843, #36848)
• 在创建 flysystem 时添加了缺失的 temporary_url (#36860)
• 修复了读写主机为数组时的 PostgreSQL schema:dump (#36881)

#变更

• 改进了 Response::setContent() 中 JSON 编码响应内容失败时抛出的异常 (#36851, #36868)
• 还原 isDownForMaintenance 函数以使用 file_exists() (#36889)