在Laravel中如何使用數(shù)據(jù)庫事務(wù)

小編給大家分享一下在Laravel中如何使用數(shù)據(jù)庫事務(wù)，希望大家閱讀完這篇文章之后都有所收獲，下面讓我們一起去探討吧！

什么是數(shù)據(jù)庫事務(wù)?

在我們開始研究 Laravel 的數(shù)據(jù)庫事務(wù)之前，讓我們先看看它們是什么以及它們?nèi)绾斡幸妗?/p>

對于什么是數(shù)據(jù)庫事務(wù)，有許多聽起來復(fù)雜的技術(shù)解釋。但是，對于大多數(shù) web 開發(fā)人員來說，我們只需要知道事務(wù)是完成數(shù)據(jù)庫中整個工作單元的方式。

為了理解這實際上意味著什么，讓我們來看一個基本的例子，它將給出一點上下文。

假設(shè)我們有一個允許用戶注冊的應(yīng)用程序。每當(dāng)用戶注冊時，我們都希望為他們創(chuàng)建一個新帳戶，然后為他們分配一個默認(rèn)角色“ general”。

我們的代碼可能是這樣的:

$user = User::create([
    'email' => $request->email,
]);

$user->roles()->attach(Role::where('name', 'general')->first());

乍一看，這段代碼似乎完全沒問題。但是，當(dāng)我們仔細(xì)觀察的時候，我們可以發(fā)現(xiàn)實際上有一些事情可能會出錯。我們可以創(chuàng)建用戶，但是不能為他們分配角色。這可能是由許多不同的原因造成的，比如分配角色的代碼中的錯誤，或者甚至是阻止我們到達(dá)數(shù)據(jù)庫的硬件問題。

由于這種情況的發(fā)生，這將意味著系統(tǒng)中將有一個沒有角色的用戶。正如您可以想象的那樣，這可能會在您的應(yīng)用程序中的其他地方引起異常和 bug，因為您總是假設(shè)用戶有一個角色(這是正確的)。

因此，為了解決這個問題，我們可以使用數(shù)據(jù)庫事務(wù)。通過使用事務(wù)，它可以確保在執(zhí)行代碼時，如果出現(xiàn)任何錯誤，事務(wù)內(nèi)部對數(shù)據(jù)庫的任何更改都將回滾。例如，如果用戶被插入到數(shù)據(jù)庫中，但是由于任何原因分配角色的查詢失敗，那么事務(wù)將被回滾，用戶行將被刪除。通過這樣做，它意味著我們不能創(chuàng)建沒有分配角色的用戶。

換句話說，它“要么全有，要么全沒有”。

在 Laravel 中使用數(shù)據(jù)庫事務(wù)

現(xiàn)在我們對事務(wù)是什么以及它們實現(xiàn)了什么有了一個簡單的概念，讓我們來看看如何在 Laravel 中使用它們。

在 Laravel 中，由于我們可以在 DB 門面上訪問 transaction() 方法，因此開始使用事務(wù)實際上是很容易的事。繼續(xù)使用之前的示例代碼，讓我們看看在創(chuàng)建用戶并為其分配角色時如何使用事務(wù)。

use Illuminate\Support\Facades\DB;

DB::transaction(function () use ($user, $request): void {
    $user = User::create([
        'email' => $request->email,
    ]);

    $user->roles()->attach(Role::where('name', 'general')->first());
});

現(xiàn)在我們的代碼被包裹在一個數(shù)據(jù)庫事務(wù)中，如果在其中的任意一點拋出異常，對數(shù)據(jù)庫的任何更改都將返回到事務(wù)開始之前的狀態(tài)。

在 Laravel 中手動使用數(shù)據(jù)庫事務(wù)

有時，您可能希望對事務(wù)進(jìn)行更精細(xì)的控制。例如，假設(shè)您正在與第三方服務(wù)集成，比如 Mailchinp 或 Xero。我們會說，每當(dāng)您創(chuàng)建一個新用戶時，您還需要向他們的 API 發(fā)出 HTTP 請求，以將他們也創(chuàng)建為該系統(tǒng)中的用戶。

我們可能想要更新我們的代碼，以便如果我們無法在我們自己的系統(tǒng) 且 在第三方系統(tǒng)中創(chuàng)建用戶，則兩個系統(tǒng)都不創(chuàng)建用戶。 如果您正在與第三方系統(tǒng)交互，那么您可能有一個可用于發(fā)出請求的類。 或者，可能有一個您可以使用的包。 有時，當(dāng)某些請求無法完成時，發(fā)出請求的類可能會拋出異常。 然而，其中一些類可能會消除錯誤，而只是從您調(diào)用的方法中返回 false，并將錯誤放置在類的字段中。

因此，我們假設(shè)我們有以下調(diào)用 API 的基本示例類：

class ThirdPartyService
{
    private $errors;

    public function createUser($userData)
    {
        $request = $this->makeRequest($userData);

        if ($request->successful()) {
            return $request->body();
        }

        $errors = $request->errors();

        return false;
    }

    public function getErrors()
    {
        return $this->errors;
    }
}

當(dāng)然，上面的請求類代碼是不完整的，我下面的代碼示例也不是很清楚，但它應(yīng)該能讓您大致了解我要表達(dá)的觀點。所以讓我們使用這個請求類并將其添加到我們之前的代碼示例中：

use Illuminate\Support\Facades\DB;
use App\Services\ThirdPartyService;

DB::beginTransaction();

$thirdPartyService = new ThirdPartyService();

$userData = [
    'email' => $request->email,
];

$user = User::create($userData);

$user->roles()->attach(Role::where('name', 'general')->first());

if ($thirdPartyService->createUser($userData)) {
    DB::commit();

    return;
}

DB::rollBack();

report($thirdPartyService->getErrors());

查看上面的代碼，我們可以看到我們啟動了一個事務(wù)，創(chuàng)建了用戶并為他們分配了一個角色，然后我們調(diào)用了第三方服務(wù)。如果在外部服務(wù)中成功創(chuàng)建了用戶，知道所有內(nèi)容都已正確創(chuàng)建，我們就可以安全地提交數(shù)據(jù)庫更改。但是，如果沒有在外部服務(wù)中創(chuàng)建用戶，則回滾數(shù)據(jù)庫中的更改(刪除用戶及其角色分配)，然后報告錯誤。

與第三方服務(wù)交互的技巧

作為一個額外的技巧，我通常建議將任何影響第三方系統(tǒng)、文件存儲或緩存的代碼放在數(shù)據(jù)庫調(diào)用之后。

為了更深入地理解這一點，讓我們以上面的代碼示例為例。請注意，在向第三方服務(wù)發(fā)出請求之前，我們是如何首先對數(shù)據(jù)庫進(jìn)行所有更改的。這意味著，如果從第三方請求返回任何錯誤，將回滾我們自己數(shù)據(jù)庫中的用戶和角色分配。

然而， 如果我們反過來做，我們在修改數(shù)據(jù)庫之前發(fā)出請求，那就不是這種情況了。出于任何原因，如果我們在數(shù)據(jù)庫中創(chuàng)建用戶時發(fā)生任何錯誤，我們會在第三方系統(tǒng)中創(chuàng)建一個新用戶，但是在我們系統(tǒng)中卻沒有創(chuàng)建。如你所想， 這可能會導(dǎo)致更多問題。通過編寫一個清理方法將用戶從第三方系統(tǒng)中刪除，可以降低這個問題的嚴(yán)重性。 但是，正如您可以想象的那樣， 這可能會導(dǎo)致更多的問題，并導(dǎo)致編寫、維護(hù)和測試更多的代碼。

所以，我總是建議把數(shù)據(jù)庫調(diào)用放在API調(diào)用之前。但并不總是這樣，有時可能需要將第三方請求返回的值保存到數(shù)據(jù)庫中。如果是這種情況，就需要API調(diào)用放到數(shù)據(jù)庫調(diào)用之前了，只要您確保有一些代碼可以處理任何失敗，這是完全可以的。

使用自動或手動事務(wù)

同樣值得注意的是，因為我們最初的示例使用DB:transaction()方法，在拋出異常時回滾事務(wù)，所以我們也可以使用這種方法向我們的第三方服務(wù)發(fā)出請求。相反，我們可以這樣更新類:

use Illuminate\Support\Facades\DB;
use App\Services\ThirdPartyService;

DB::transaction(function () use ($user, $request): void {
    $user = User::create([
        'email' => $request->email,
    ]);

    $user->roles()->attach(Role::where('name', 'general')->first());

    if (! $thirdPartyService->createUser($userData)) {
        throw new \Exception('User could not be created');
    }
});

這絕對是一個可行的解決方案，并將按照預(yù)期成功回滾事務(wù)。事實上，就我個人的偏好而言，我實際上更喜歡這種方式，而不是手動使用事務(wù)。我認(rèn)為它看起來更容易閱讀和理解。

然而，與手動提交或回滾事務(wù)時使用 'if' 語句相比，異常處理在時間和性能方面可能會比較昂貴。

因此，舉個例子，如果這段代碼用于導(dǎo)入包含10,000個用戶數(shù)據(jù)的 CSV 文件，您可能會發(fā)現(xiàn)拋出異常會大大減慢導(dǎo)入速度。

但是，如果它只是在一個用戶可以注冊的簡單web請求中使用，那么拋出異?？赡軟]有問題。當(dāng)然，這取決于應(yīng)用程序的大小，性能是關(guān)鍵因素；所以你需要根據(jù)具體情況來決定。

在數(shù)據(jù)庫事務(wù)中調(diào)度隊列

每當(dāng)您在事務(wù)中處理隊列時，您都需要注意一個“陷阱”。

為了提供一些上下文，讓我們繼續(xù)使用之前的代碼示例。我們可以想象，在我們創(chuàng)建了我們的用戶之后，我們想要運行一個任務(wù)來提醒管理員通知他們新注冊并向新用戶發(fā)送歡迎電子郵件。我們將通過分派一個名為 AlertNewUser 的隊列任務(wù)來做到這一點，如下所示：

use Illuminate\Support\Facades\DB;
use App\Jobs\AlertNewUser;
use App\Services\ThirdPartyService;

DB::transaction(function () use ($user, $request): void {
    $user = User::create([
        'email' => $request->email,
    ]);

    $user->roles()->attach(Role::where('name', 'general')->first());

    AlertNewUser::dispatch($user);
});

當(dāng)您開始一個事務(wù)并對其中的任何數(shù)據(jù)進(jìn)行更改時，這些更改僅對正在運行事務(wù)的請求/進(jìn)程可用。對于任何其他訪問您更改的數(shù)據(jù)的請求或進(jìn)程，必須先提交事務(wù)。因此，這意味著如果我們從事務(wù)內(nèi)部分派任何排隊的隊列、事件監(jiān)聽器、郵件，通知或廣播事件。由于競爭條件，我們的數(shù)據(jù)更改可能在事務(wù)內(nèi)部不可用。

如果隊列在事務(wù)提交之前開始處理排隊的代碼，就會發(fā)生這種情況。因此，這可能導(dǎo)致您的排隊代碼可能試圖訪問不存在的數(shù)據(jù)，并可能導(dǎo)致錯誤。在我們的例子中，如果在事務(wù)提交之前運行隊列AlertNewUser作業(yè)，那么我們的作業(yè)將嘗試訪問一個尚未實際存儲在數(shù)據(jù)庫中的用戶。如您所料，這將導(dǎo)致作業(yè)失敗。

為了防止這種競爭條件的發(fā)生，我們可以對我們的代碼和/或我們的配置進(jìn)行一些更改，以確保僅在事務(wù)成功提交后才調(diào)度隊列。

我們可以更新 config/queue.php 并添加 after commit 字段。讓我們想象一下，我們正在使用 redis 隊列驅(qū)動程序，所以我們可以這樣更新配置：

<?php

return [

    // ...

    'connections' => [

        // ...

        'redis' => [
            'driver' => 'redis',
            // ...
            'after_commit' => true,
        ],

        // ...

    ],

    // ...
];

通過進(jìn)行此更改，如果我們嘗試在事務(wù)內(nèi)調(diào)度隊列，則隊列將在實際調(diào)度隊列之前等待事務(wù)提交。 方便的是，如果事務(wù)回滾，它也會阻止隊列被調(diào)度。

然而，可能有一個原因，您不希望在配置中全局設(shè)置此選項。 如果是這種情況，Laravel 仍然提供了一些很好的助手方法，我們可以根據(jù)具體情況使用它們。
如果我們想更新事務(wù)中的代碼，只在任務(wù)提交后才分派任務(wù)，可以使用afterCommit()方法，如下所示：

use Illuminate\Support\Facades\DB;
use App\Jobs\AlertNewUser;
use App\Services\ThirdPartyService;

DB::transaction(function () use ($user, $request): void {
    $user = User::create([
        'email' => $request->email,
    ]);

    $user->roles()->attach(Role::where('name', 'general')->first());

    AlertNewUser::dispatch($user)->afterCommit();
});

Laravel 還提供了另一個我們可以使用的方便的beforeCommit()方法。 如果我們在隊列配置中設(shè)置了全局after_commit => true，但不關(guān)心等待事務(wù)被提交，就可以使用這個。 要做到這一點，我們可以簡單地像這樣更新我們的代碼：

use Illuminate\Support\Facades\DB;
use App\Jobs\AlertNewUser;
use App\Services\ThirdPartyService;

DB::transaction(function () use ($user, $request): void {
    $user = User::create([
        'email' => $request->email,
    ]);

    $user->roles()->attach(Role::where('name', 'general')->first());

    AlertNewUser::dispatch($user)->beforeCommit();
});

看完了這篇文章，相信你對“在Laravel中如何使用數(shù)據(jù)庫事務(wù)”有了一定的了解，如果想了解更多相關(guān)知識，歡迎關(guān)注億速云行業(yè)資訊頻道，感謝各位的閱讀！