Laravel 代码重构：使用 Services, Events, Jobs, Actions 来重构控制器方法

![roles-and-permissions-for-laravel-apps.png](https://cdn.tyrantg.com/van/static/img/f4b57062dba419e6114e79705c08f268.roles-and-permissions-for-laravel-apps.png)
经过多年开发，56 次发布，130万下载，并且超过2800的主动关注 **[Bouncer](https://github.com/JosephSilber/bouncer) 终于来到了 1.0** 版本。 在相当长的一段时间里，它一直非常可靠和稳定，并被世界各地无数的app用于生产。

这是我个人的更新，包含了我多年来的一些思考——从最初到最终发行。关于如何每天使用Bouncer的技术信息，请查看 [the extensive documentation](https://github.com/JosephSilber/bouncer/blob/master/readme.md#introduction) 或者在 [The Laravel Podcast](https://laravelpodcast.com/episodes/bouncer-with-joseph-silber) 听我和马特·斯托弗讨论。



* * * * *

## 什么是Bouncer?



在开始我的个人旅程之前，这里先简要介绍一下 Bouncer 是什么，以及它如何融入更大的 Laravel 生态系统。

> **Bouncer 是一个开源包，用于动态管理数据库中的角色和权限，与 Laravel 的 Gate** 完全集成。

在不深入细节的情况下，以下是其一些主要功能的简短列表：

-   [Simple abilities](https://github.com/JosephSilber/bouncer/blob/master/readme.md#giving-a-user-an-ability-directly):

    ```php
    Bouncer::allow($user)->to('access-dashboard');
    ```

-   [Model abilities](https://github.com/JosephSilber/bouncer/blob/master/readme.md#restricting-an-ability-to-a-model):

    ```php
    Bouncer::allow($user)->to('view', Invoice::class);
    Bouncer::allow($user)->to('delete', $invoice);
    ```

-   [Flexible roles](https://github.com/JosephSilber/bouncer/blob/master/readme.md#assigning-roles-to-a-user):

    ```php
    Bouncer::allow('admin')->everything();
    Bouncer::assign('admin')->to($user);
    ```

-   [Forbidding abilities](https://github.com/JosephSilber/bouncer/blob/master/readme.md#forbidding-an-ability):

    ```php
    Bouncer::allow($user)->to('view', Invoice::class);
    Bouncer::forbid($user)->to('view', $confidentialInvoice);
    ```

-   [Powerful ownership](https://github.com/JosephSilber/bouncer/blob/master/readme.md#allowing-a-user-or-role-to-own-a-model):

    ```php
    Bouncer::allow($user)->toOwn(Post::class);
    ```

-   [Straighforward multi-tenancy](https://github.com/JosephSilber/bouncer/blob/master/readme.md#multi-tenancy):

    ```php
    Bouncer::scope()->to($tenantId);
    ```

-   [Built-in caching](https://github.com/JosephSilber/bouncer/blob/master/readme.md#enabling-cache)

    ```php
    Bouncer::cache();
    ```



...还有更多。有关详细信息，请查看[完整的文档](https://github.com/JosephSilber/bouncer/blob/master/readme.md)，或只需浏览[备忘单](https://github.com/JosephSilber/bouncer/blob/master/readme.md#cheat-sheet).

## Bouncer 最初的想法

早在 2015 年 8 月，[Taylor](https://github.com/taylorotwell) 添加了一个[Laravel 5.2 中的新授权系统](https://github.com/laravel/framework/commit/9a5189822bba546f33a550752b57161e9689c6cd)，称为 `Gate`。这提供了一个很好用的 API，用于应用程序中定义各种操作的权限检查，[简单 `定义` 回调](https://laravel.com/docs/9.x/authorization#writing-gates) 和完整的 [policies](https://laravel.com/docs/9.x/authorization#creating-policies)，以及根据您定义的内容在 [整个系统中挂接检查权限](https://laravel.com/docs/9.x/authorization#authorizing-actions-using-policies)。



当我开始使用它时，我就知道这将是所有 Laravel 应用程序的 [ACL](https://en.wikipedia.org/wiki/Access-control_list) 的未来。 真是太好了，Taylor 对清晰和直观的 API 有这种惊人的感觉，而「Gate」抽象真正地揭示了这一点。

**然而，内置授权系统缺少一件事：动态权限，存储在数据库中**。 构建 Gate 的方式，所有检查都由应用程序中定义的硬编码函数执行，因此无法让您的管理员在运行时通过某些仪表板 UI 控制其中任何一个。 正如泰勒的 [原始提交](https://github.com/laravel/framework/commit/9a5189822bba546f33a550752b57161e9689c6cd) 明确指出：
> [内置 Gate] 为组织逻辑提供了一种结构，该逻辑授权对实体进行操作。 它没有对「用户角色」的定义做出任何决定。


当时，还有许多其他流行的 [ACL](https://en.wikipedia.org/wiki/Access-control_list) 操作系统支持在运行时调整权限，但它们有一个主要缺点：它们都是在 Laravel 的 `Gate` 之前构建的。它们是完全分离的系统；如果您决定使用它们，你将放弃 Laravel 的 gate 提供的所有细节和漂亮的集成。

因此，我决定构建一个开源包，它可以让您两全其美：动态数据库驱动的权限，与 Laravel 的 gate 完全集成。[我们在Laravel 5.3中对 gate 检查做了一些改进](https://josephsilber.com/posts/2016/08/03/authorization-improvements-in-laravel-5-3#normalizing-ability-names)，使其更加简化和可预测，从而更容易将这些功能存储在数据库中。



## Bouncer 的名称和 logo

我很早就想到了「保镖」(Bouncer) 这个名字。 [保镖](https://en.wikipedia.org/wiki/Bouncer) 的职责是在门口提供安全保障并检查人们的权限。 所以这是与 Laravel 中的「Gate」非常自然的配对。

有趣的是，当时与我合作的标志设计师（不是以英语为母语的人）没有得到参考。 以下是他设计的 [一些原始logo](https://twitter.com/joseph_silber/status/967037000812498944)：


![1656226915472.jpeg](https://cdn.tyrantg.com/van/static/img/c93e1a160ae15ea2f713b18f8bfe263e.1656226915472.jpeg)

右边的两个显然是受到弹跳动作的启发。 

在快速阐明了保镖这个词的含义之后，我们开始迭代实际的保镖 logo。 我们尝试了友好的保镖、威胁的保镖、大胡子的保镖、方下巴的保镖，以及大量不同的变体。 这里仅仅是少数：


![1656226931187.jpeg](https://cdn.tyrantg.com/van/static/img/0b94dbaadc7cc19e42271ec7ed7adb5f.1656226931187.jpeg)

我非常喜欢我们最终得到的结果：


![1656226943633.jpeg](https://cdn.tyrantg.com/van/static/img/6eb793b9c3252edb6a49a6c5d8257692.1656226943633.jpeg)

它散发出强烈的安全感，但它的圆润让人感觉更友好，威胁更小

## 技术基础

Bouncer's 的存在理由是与 Laravel 的 gate 无缝集成的。为了实现这一点，我心中的只有一个目标：在为用户分配角色和能力时，您只需和 `Bouncer` 进行交互。对于实际的授权检查，整个系统中 Laravel 的钩子应该自动工作，而不需任何特殊的 Bouncer 语法。ically, without any special Bouncer syntax.

将 Bouncer 挂钩到 Laravel 的 gate 检查方式是相当简单的。`Gate` 让你定义 [一个全局的 `before` 回调](https://laravel.com/docs/9.x/authorization#intercepting-gate-checks)，它将会在任何您定义的检查之前被调用：如果您的 `before` 回调允许或不许与某个操作，则不会运行进一步检查。




虽然 `before` 回调最初是为 「允许管理员执行所有操作」之类的东西而设计的，但我立即意识到这将是连接动态检查的理想场所，允许我查询数据库以获得任何权限。这就是它最初的工作方式（我们后来将其切换为使用 [`after` 回调](https://github.com/laravel/framework/pull/24935) - 你可以阅读更多关于 [在此线程](https://github.com/JosephSilber/bouncer/issues/264#issuecomment-406921249)）



## 文档

从一开始，文档对我来说就非常重要。 **开源项目的生死取决于他们的文档**，所以我希望 Bouncer 的文档尽可能做到最好。尤其是在 Laravel 生态系统中，Taylor 为细致的文档设定了极高的标准。




在某种程度上，清晰的文档有时甚至比代码本身更重要。如果不告诉你的用户如何使用你的工具，他们中很少有人会使用源代码来解决这个问题。他们只会继续做下一件事。

我将 Bouncer 的成功很大程度上归功于清晰的文档，但在这方面还有很多工作要做。作为创建者，对整个谜题有一个清晰的了解，很容易忘记刚接触该工具的人会遇到什么困难。

例如：如前所述，Bouncer 仅用于为用户分配角色和权限。实际的授权检查将像在任何标准 Laravel 应用程序中一样处理。所以我想我不必重复所有这些，因为 [Laravel 文档中清楚地概述了它](https://laravel.com/docs/9.x/authorization#authorizing-actions-using-policies)。尽管如此，我仍然看到人们为此苦苦挣扎。他们设置了自己的角色和权限，然后不知道从哪里开始。这是我仍然想在文档中充实的一个领域。


## 准备发布

将 1.0 版本推迟到现在对我的用户造成了伤害。 Bouncer 多年来一直很稳定，并在世界各地的生产中积极使用。 然而，我总是犹豫要不要发布它，因为我知道我想添加的东西太多了。 我在 [播客](https://laravelpodcast.com/episodes/bouncer-with-joseph-silber) 上与 Matt 详细讨论了这个问题：我掉进了想要在发布之前让它变得完美的陷阱，这显然是 不可能的。 正如伏尔泰 [已警告](https://en.wikipedia.org/wiki/Perfect_is_the_enemy_of_good)：「完美是良好的敌人」。

因此，当我发布 Bouncer 1.0 版时，我仍然希望在初始版本中包含 2 个出色的功能，但没有成功：

1. **每个模型的角色**。 很长一段时间以来，人们一直在吵着要一种方法，只为给定的模型（或模型类）分配角色给用户。 这是该代码的样子：
    ```
    // 注意：这还没有实现
	Bouncer::allow('editor')->to(['view', 'edit'])->everything();
	Bouncer::assign('editor')->to($user)->for(Invoice:class);
    ```

    这样，用户就可以查看和编辑所有发票，但不能做其他任何事情。 当然，这现在可以在没有角色的情况下直接完成，但通过角色来完成会提供另一层灵活性。

     我已经尝试过多次解决这个问题，但结果非常棘手，因为缓存变成了一场真正的噩梦。 我仍然希望有一天能解决它。 走着瞧。

2.  **能力限制**。 允许对给定能力进行任意限制将增加更精细的控制：

    ```
    // 注意：这还没有实现
	Bouncer::allow($user)
	->to('view', Post::class)
	->where('is_confidential', false);
    ```

   如果你探索过 Bouncer 的源码，你会发现一些 [代码](https://github.com/JosephSilber/bouncer/tree/master/src/Constraints) 和 [测试](https://github.com/JosephSilber/bouncer/tree/master/tests/Unit/Constraints) 我开始实现这个的地方。 它远未完成，但请继续关注。



总的来说，Bouncer 处于一个非常好的位置。每个好的产品都有一个漫长的路线图，认为我可以在发布 1.0 之前走到这条路的尽头，这是愚蠢和不切实际的。

所以，[在播客期间直播](https://overcast.fm/+LF1UtwFlc/22:26)，我发布了 Bouncer。感觉很棒！

## 享受使用它！

好了，到此为止。我希望您尝试在您的应用程序中使用 [Bouncer](https://github.com/JosephSilber/bouncer)，并享受使用它。 Bouncer 的 API 被设计的像散文一样，每个方法调用读起来都像是一个合适的英文句子。试一试，如果您也有这种感觉，请告诉我！

> 原文地址：[https://laravel-news.com/bouncer-v1](https://laravel-news.com/bouncer-v1)
> 译文地址：[https://learnku.com/laravel/t/68970](https://learnku.com/laravel/t/68970)

[扩展推荐]  Bouncer —— 角色和权限管理工具

![terminal-an-elegant-wrapper-around-the-symfony-process-component.png](https://cdn.tyrantg.com/van/static/img/b3e799bf5a7b317aa4fe675bb32ce70e.terminal-an-elegant-wrapper-around-the-symfony-process-component.png)

**Terminal** 是 Titas Gailius 提供的一个简洁的 PHP 扩展包，它封装了 “Symfony 的 Process 组件”，并且拥有流畅的接口。这使得执行终端命令更加轻松便捷。



```php
Terminal::in(storage_path('sites/123'))
    ->timeout(120)
    ->retries(3)
    ->run('wp cli update');
```

最简单的使用方式，可以像下面这样执行一个命令。这样去除了大量样板和symfony process组件中的低层次信息：

```php
$response = Terminal::run('rm -rf vendor');
```




下面是一些可以对响应结果做的一些操作：

```php
$response->code() : int;
$response->ok() : bool;
$response->successful() : bool;

$response->lines() : array;
$response->output() : string;
(string) $response: string;

// 抛出终端可以捕获的异常
$response->throw();

// 您可以访问 symfony 进程
$response->process();

// 所有在响应上找不到的调用都会被传递到 Symfony 进程
// \Symfony\Component\Process\Process::isRunning()
$response->isRunning();
```

下面是一些简洁的示例:

```php
// 给命令传递参数
Terminal::with([
    'firstname' => 'John',
    'lastname' => 'Doe',
])->run('echo Hello, {{ $firstname}} {{ $lastname }}');

// 每次重试之间的重试次数和持续时间
Terminal::retries(3, 100)->run('rm -rf vendor');

// 环境变量
Terminal::withEnvironmentVariables([
    'APP_ENV' => 'testing',
])->run('rm -rf $DIRECTORY');
```

您可以在[TitasGailius/terminal](https://github.com/TitasGailius/terminal) 了解更多关于这个包的信息、完整的安装说明或者查看源代码。

> 原文地址: [https://laravel-news.com/terminal-an-elegant-wrapper-around-the-symfony-process-component](https://laravel-news.com/terminal-an-elegant-wrapper-around-the-symfony-process-component)
> 译文地址：[https://learnku.com/laravel/t/42663](https://learnku.com/laravel/t/42663)

[扩展推荐]  Terminal —— 封装 Symfony Process，优雅地在 PHP 中调用 Linux 命令

![travel-notes-of-abc-training-part01-xizang-lasa.jpg](https://cdn.tyrantg.com/van/static/img/f005de00191073455b7c4b5f0e30a47d.travel-notes-of-abc-training-part01-xizang-lasa.jpg)



## 在飞机上简单拍摄一下

![1656083972673.jpg](https://cdn.tyrantg.com/van/static/img/4c7cf5118ee2caf7cb12c93770d76fee.1656083972673.jpg)

![1656083980921.jpg](https://cdn.tyrantg.com/van/static/img/baf5b8cc1895380c519dfba77fe83ccb.1656083980921.jpg)

![1656083986800.jpg](https://cdn.tyrantg.com/van/static/img/5330285c93e56025fc9f76c3883f2e71.1656083986800.jpg)


## 前往研修院的路上

![1656084024128.jpg](https://cdn.tyrantg.com/van/static/img/2f483b9b95c761b839feb84eb5e319ae.1656084024128.jpg)

![1656084029620.jpg](https://cdn.tyrantg.com/van/static/img/c6021813cd66575305e84238c2de75aa.1656084029620.jpg)

## 第三日，进展顺利，夜游拉萨
（用了一些奇怪的滤镜）

![1656084067364.jpg](https://cdn.tyrantg.com/van/static/img/f005de00191073455b7c4b5f0e30a47d.travel-notes-of-abc-training-part01-xizang-lasa.jpg)

![1656084102763.jpg](https://cdn.tyrantg.com/van/static/img/14e412c794b82778fddd8f294c32fb16.1656084102763.jpg)

![1656084114757.jpg](https://cdn.tyrantg.com/van/static/img/73ba5b06c99f354fa141bd0c3adf0986.1656084114757.jpg)

![1656084154626.jpg](https://cdn.tyrantg.com/van/static/img/3b8cf7226d22b56c38737c2772f740a2.1656084154626.jpg)

![1656084263652.jpg](https://cdn.tyrantg.com/van/static/img/f9aac9052e4548c5c25553d18040163c.1656084263652.jpg)

![1656084268910.jpg](https://cdn.tyrantg.com/van/static/img/3ffae8074b76b97d925bc638b906d4d5.1656084268910.jpg)

![1656084273768.jpg](https://cdn.tyrantg.com/van/static/img/fe2500812a72ef8ba9103dd1828baf8b.1656084273768.jpg)

![1656084278809.jpg](https://cdn.tyrantg.com/van/static/img/784917186997d717fe431169fdacfc25.1656084278809.jpg)

![1656084283844.jpg](https://cdn.tyrantg.com/van/static/img/2e4fd9ef24c5228cb5df6988d1893b0b.1656084283844.jpg)

![1656084290888.jpg](https://cdn.tyrantg.com/van/static/img/44ce04365015d8fc4a3b60d3f16251a8.1656084290888.jpg)

## 随手拍拍

![IMG20220626130147.jpg](https://cdn.tyrantg.com/van/static/img/0669bc1135dee1b4b268c8ba16baa3bf.IMG20220626130147.jpg)

![IMG20220626130328.jpg](https://cdn.tyrantg.com/van/static/img/81818a02677321252d22cb7ab0e01313.IMG20220626130328.jpg)

![IMG20220626204042.jpg](https://cdn.tyrantg.com/van/static/img/e4cec1a0d5937e3915c3c2eecbfba471.IMG20220626204042.jpg)

![IMG20220626204116.jpg](https://cdn.tyrantg.com/van/static/img/d65a0dad5b52e7ccda91ee18d92f3eb6.IMG20220626204116.jpg)

![IMG20220626204128.jpg](https://cdn.tyrantg.com/van/static/img/5db7e6fb4885c5baf9b7b706d3b90f7a.IMG20220626204128.jpg)

![IMG20220627202629.jpg](https://cdn.tyrantg.com/van/static/img/767aace9e754e1824dd109d5ea872f5c.IMG20220627202629.jpg)

![IMG20220627202830.jpg](https://cdn.tyrantg.com/van/static/img/1fb4b898cefd608e894dbe0c4d3fb34c.IMG20220627202830.jpg)

![IMG20220627202845.jpg](https://cdn.tyrantg.com/van/static/img/2aafe1de07c44ffd2550220566db2f99.IMG20220627202845.jpg)

![IMG20220627202920.jpg](https://cdn.tyrantg.com/van/static/img/c5189d5993c1c96527be37e56771cfcb.IMG20220627202920.jpg)

![IMG20220627202931.jpg](https://cdn.tyrantg.com/van/static/img/75b777235f53c4bd11b44ced0ec4f76a.IMG20220627202931.jpg)

![IMG20220627203012.jpg](https://cdn.tyrantg.com/van/static/img/a02f8736cd692402977c21fcf7579b40.IMG20220627203012.jpg)

## 前往机场

![IMG20220701153805.jpg](https://cdn.tyrantg.com/van/static/img/371a1bd1428e07e269ddbb768109b895.IMG20220701153805.jpg)

![IMG20220701154151.jpg](https://cdn.tyrantg.com/van/static/img/332b6f93b9a26af19d306df9a6db0c5b.IMG20220701154151.jpg)

## 飞机上

![IMG20220701181347.jpg](https://cdn.tyrantg.com/van/static/img/bcaf85a27dd9804429e59a1b8765d74d.IMG20220701181347.jpg)

![IMG20220701181418.jpg](https://cdn.tyrantg.com/van/static/img/2a45a44bb6646f5873c9e27287eef55b.IMG20220701181418.jpg)

## 到达武汉

![IMG20220701204521.jpg](https://cdn.tyrantg.com/van/static/img/ce9cff958f8cccdaae42ff60aca8624f.IMG20220701204521.jpg)

![IMG20220701204526.jpg](https://cdn.tyrantg.com/van/static/img/9d43c53a2b3f6dc6834c0937d81dae05.IMG20220701204526.jpg)

![IMG20220701204630.jpg](https://cdn.tyrantg.com/van/static/img/946adcd1205333f0d164ee928b55e493.IMG20220701204630.jpg)

农行研修行记 Part.01 西藏-拉萨

```shell
sed -i -r 's#http://(archive|security).ubuntu.com#https://mirrors.aliyun.com#g' /etc/apt/sources.list && apt-get update
```