Laravel 9.29、9.30版本发布

Laravel团队2022年9月9日及13日分别发布了9.29和9.30两个版本，其中包含只读文件系统选项、作用域文件系统驱动程序、丢弃模型更改的能力等等。

注意：

我们上次介绍了Laravel 9.28.0，所以这个发布帖子涵盖了9.29和9.30。

只读文件系统配置选项

Frank de Jonge为将文件系统磁盘配置为以只读模式运行做出了贡献。

这确保了磁盘上不可能有写操作，这在访问要确保不操纵任何文件的存储时很有用。

这是此功能的拉取请求中的配置示例：

$disk = $filesystem->build([
    'driver' => 'local',
    'read-only' => true,
    'root' => 'my-custom-path',
    'url' => 'my-custom-url',
    'visibility' => 'public',
]);

作用域文件系统驱动程序

Frank de Jonge贡献了作用域文件系统驱动程序，它提供了一种重用磁盘配置的方法。

这是拉取请求描述中的一个示例：

[
    's3' => [
        'driver' => 's3',
        'key' => env('AWS_ACCESS_KEY_ID'),
        'secret' => env('AWS_SECRET_ACCESS_KEY'),
        'region' => env('AWS_DEFAULT_REGION'),
        'bucket' => env('AWS_BUCKET'),
        'url' => env('AWS_URL'),
        'endpoint' => env('AWS_ENDPOINT'),
        'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),
        'throw' => false,
    ],
    's3_videos' => [
        'driver' => 'scoped',
        'prefix' => 'path/for/videos',
        'disk' => 's3',
    ],
]

为所有“make”命令添加强制选项

James Brooks为所有命令提供了一个--force标志make:*，这在您需要重新创建文件时很有帮助。

“如果接受则需要”验证规则

Pascal Baljet提供了一个required_if_accepted验证规则，

该规则确保在接受另一个字段时需要验证的字段（值为yes、on、1或true）：

Validator::make([
    'is_company'   => 'on',
    'company_name' => 'Apple',
], [
    'is_company'   => 'required|boolean',
    'company_name' => 'required_if_accepted:is_company',
]);

放弃Eloquent模型更改的能力

Mior Muhammad Zaki提供了discardChanges()一种丢弃属性更改并将属性重置为原始状态的方法：

$user = new EloquentModelStub([
    'name' => 'Taylor Otwell',
]);
 
$user->getOriginal('name'); // null
 
$user->getAttribute('name'); // Taylor Otwell
$user->discardChanges();
$user->getAttribute('name'); // null

判断附件是否存在

Andrew Minion有助于确定给定的附件是否包含在邮件中。

添加了三种方法，可以帮助在测试中断言附件：

$mailable = new InvoicePaid($user);
 
// Test normal attachment.
$this->assertTrue(
    $mailable->hasAttachment('Receipt.pdf')
);
 
// Test attachment from storage disk.
$this->assertTrue(
    $mailable->hasAttachmentFromStorageDisk('s3', 'invoices', $user->latest_invoice->name)
);
 
// Test raw attachment.
$this->assertTrue(
    $mailable->hasAttachedData('12345', 'confirmation.txt')
);

发行说明

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

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

https://github.com/laravel/framework/compare/v9.27.0...v9.28.0
https://github.com/laravel/framework/blob/e4e9df0a304ac427ea0f3e0384281289719fa54c/CHANGELOG.md#v9300---2022-09-13

v9.29.0

添加

添加 RequiredIfAccepted 验证规则 ( #44035 )
添加Illuminate/Foundation/Vite::assetPath()（#44037）
添加了丢弃 Eloquent 模型更改的功能 ( #43772 )
添加了确定附件是否存在到Illuminate/Mail/Mailable( #43967 )的功能
添加Illuminate/Support/Testing/Fakes/BusFake::assertNothingBatched()（#44056）

恢复

恢复了固定的RoueGroup ::merge 以正确格式化合并的前缀。（#44072）

修复

避免在 PHP 8.1 ( #43951 )上将 null 传递给参数异常
将记住我的 Cookie 持续时间与 CookieJar 过期时间对齐 ( #44026 )
使用 Enumerable ( #44030 )修复 Stringable 类型提示
修复了带有文件响应的中间件“SetCacheHeaders”（#44063）

改变了

不要为 PlanetScale 的 MySQL 兼容 Vitess 引擎的队列作业弹出使用锁 ( #44027 )
Illuminate/Console/GeneratorCommand.php避免在( #44049 )中的自定义存根模板中匹配“使用”

v9.30.0

添加

为记录器添加了 stop_buffering 配置选项（#44071）
添加了只读文件系统适配器装饰作为配置选项 ( #44079 )
添加了作用域文件系统驱动程序 ( #44105 )
为所有 make 命令添加强制选项（#44100）

修复

修复了带有数组条件的 QueryBuilder whereNot ( #44083 )

改变

将事件传递到队列监听器的 viaQueue 和 viaConnection ( #44080 )
提高批处理作业的可测试性 ( #44075 )
允许在 cron 表达式中使用任何类型的空格 ( #44110 )