Laravel Airlock 正式更名为 Sanctum

上周，Laravel blog宣布，由于Airlock涉及到一些商标或版权争议，决定将Airlock进行改名。
新的名称为Laravel Sanctum。

在安装 v1.x 版本时，您可能看到 airlock 软件包的放弃警告:

如果您的代码依赖于 laravel/airlock，那么下面可以找到一些更新依赖的详细信息。

TLDR

您需要在您的代码中查找到所有Airlock 或者 airlock 并且分别替换成 Sanctum 或 sanctum。

更新步骤

所有的功能都保持不变，但是您需要进行一些更改才能使用新的扩展包，并且弃用 laravel/airlock。如果您需要更新您的项目，那么 新旧文档差异 应该对您很有帮助。

从 Airlock 更改的步骤粗略涉及以下内容：

1. 增加 laravel/sanctum composer 依赖
2. 将已经发布的 config/airlock.php 配置迁移到 sannctum 的配置中
3. 替换 Airlock 为 Sanctum、 airlock 为 sanctum
   • 如果您正在使用 SPA 中间件, 将 Airlock 改为 Sanctum
   • 将环境变量配置 AIRLOCK_STATEFUL_DOMAINS 更新为 SANCTUM_STATEFUL_DOMAINS
4. 删除 config/airlock.php文件
5. 从项目的 composer 依赖中取出 laravel/airlock

注意: 请务必记住保留config/airlock.php

以下是所有步骤的大致命令：

# 步骤1-安装Sanctum
composer install laravel/sanctum

# 步骤2-发布Sanctum供应商配置
php artisan vendor:publish
  --provider="Laravel\Sanctum\SanctumServiceProvider"

# 步骤3-手动查找/替换代码中的Airlock实例
# Manually find/replace Airlock instances in your code

# 步骤4-前提是你发布了config/Sanctum.php
rm config/airlock.php

# 步骤5
composer remove laravel/airlock

下面是导入Sanctum中间件的文档示例，如果您已经在项目中完成了此操作，请更改use Laravel\Airlock\…为use Laravel\Sanctum\…：

use Laravel\Sanctum\Http\Middleware\EnsureFrontendRequestsAreStateful;

'api' => [
    EnsureFrontendRequestsAreStateful::class,
    'throttle:60,1',
    \Illuminate\Routing\Middleware\SubstituteBindings::class,
],

更多

要了解有关使用Sanctum的更多信息，请查看官方文档。源代码在GitHub的[laravel/sanctum]上(https://GitHub.com/laravel/sanctum)。

本文中的所有译文仅用于学习和交流目的，转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议，如果我们的工作有侵犯到您的权益，请及时联系我们。

原文地址：https://laravel-news.com/laravel-airlock...

译文地址：https://learnku.com/laravel/t/42668