在 Laravel 7 中優雅使用 UUID 教程

最近我必須在 Laravel 7 實作 通用唯一識別碼 （ UUIDs ），並遇到一些問題。我希望這篇貼文可為其他正在做相同事情的人解惑。

使用UUIDs 的高階理由

A) 它們從你的統一資源定位符號移除編號的識別號，故用戶不能看到你的應用程式已建立多少確定的物件。例如：

https://myapp.com/api/users/5

對比：

https://myapp.com/api/users/0892b118-856e-4a15-af0c-66a3a4a28eed

B) 它們讓 識別號碼 遠難於猜測。這有益於安全性，但我們可能應該實現其他技術以防範之。

作為主鍵實作UUIDs

#如何改變資料庫遷移

##首先，在資料庫遷移中，你要將目前自動遞增的ID 欄位替換為UUIDs 。你也可以遵循以下方法：保留自動遞增ID 並將UUID 作為表中的附加字段，在用戶展示URL 時使用(在這種情況下，你將ID 隱藏到模型中)，但這不是我們能在這裡做的。讓我們看看假設的 employees 表是什麼樣子的。

public function up()
    {
        Schema::create('employees', function (Blueprint $table) {
            $table->uuid('id')->primary;
            $table->string('name');
            $table->string('email')->unique();
            $table->string('work_location')->nullable();
            $table->timestamps();
        });
    }

在這裡，注意我們用 uuid（） 取代了 normal id() ；並使其成為主鍵。

讓我們把它變成一種特質

接下來，我們可以實作Laravel 生命週期掛鉤，以確保在建立此模型的新實例時分配了UUID。我們可以直接在模型中編寫程式碼，但是如果你要在多個模型中使用 UUID，我建議用 Trait (我在這篇開發文章中學到了這一點，非常感謝 Dev)。 trait 基本上允許你創建功能，並透過 use 關鍵字呼叫它在多個模型中使用。

要建立新的Trait，請建立一個\App\Http\Traits\資料夾（這只是我的愛好，你也可以將其放到其他位置），並為Trait 建立一個新文件。我們將呼叫檔案 UsesUuid.php。

這是 trait 的具體程式碼:

<?php
namespace App\Http\Traits;
use Illuminate\Support\Str;
trait UsesUuid
{
  protected static function bootUsesUuid() {
    static::creating(function ($model) {
      if (! $model->getKey()) {
        $model->{$model->getKeyName()} = (string) Str::uuid();
      }
    });
  }
  public function getIncrementing()
  {
      return false;
  }
  public function getKeyType()
  {
      return &#39;string&#39;;
  }
}

使用 \Illuminate\Support\Str 輕鬆產生 UUID.。 getIncrementing () 方法告訴 Laravel 該模型的主鍵不會自增 (因為我們設定的是 false), 而 getKeyType () 方法告訴 Laravel 該模型的主鍵是字串類型。 bootUsesUuid () 方法讓我們可以使用 Laravel 強大的生命週期鉤子。你可以 在這來哦藕節更多詳細資訊。基本上我們的程式碼已經可以告訴 Laravel，當建立該模型的新實例時，為其設定 UUID 主鍵！

現在，我們可以使用 use 關鍵字在模型上輕鬆實現此特徵。

<?php
namespace App;
use Illuminate\Database\Eloquent\Model;
...
class Employee extends Model
{
    ...
    use \App\Http\Traits\UsesUuid;
    ...
}

將 UUID 引用為外鍵

要將表上的 UUID 引用為外鍵，只需更改表上外鍵欄位的類型。如下...

 Schema::create('another_table', function(Blueprint $table) {
        $table->id();
        $table->unsignedBigInteger('employee_id');
        $table->string('some_field');
        $table->foreign('employee_id')
            ->references('id')
            ->on('shifts')
            ->onDelete('cascade');
    });

... 我們在引用 employee_id 外鍵時創建了一個無符號大整數的資料類型，對此進行如下修改:

 Schema::create('another_table', function(Blueprint $table) {
        $table->id();
        $table->uuid('employee_id');
        $table->string('some_field');
        $table->foreign('employee_id')
            ->references('id')
            ->on('shifts')
            ->onDelete('cascade');
    });

那樣簡單！還有一件事...

UUID 和多態關係

您可能會發現自己透過自己的操作或要引入的套件以多態關係引用了該模型。在遷移中，該表可能看起來像這樣：

    public function up()
    {
        Schema::create('some_package_table', function (Blueprint $table) 
        {
            $table->bigIncrements('id');
            $table->morphs('model');
            ...
        }
    }

在這裡，morphs () 方法將在資料庫中建立兩個字段，即無符號大整數類型的model_id 和字串類型的model_type 。問題在於我們的模型現在使用的是UUID 而不是遞增的整數ID，因此這會給您帶來錯誤，並顯示類似以下內容：:

Data truncated for column 'model_id' at row 1

我們現在需要model_id 欄位來支援我們的新UUID，它的型別是CHAR (36)。別擔心！ Laravel 讓這件事變得超級簡單，你不需要手動做這件事。只需將遷移更改為：

    public function up()
    {
        Schema::create('some_package_table', function (Blueprint $table) 
        {
            $table->bigIncrements('id');
            $table->uuidMorphs('model');
            ...
        }
    }

愛 Laravel 的另一個原因！編碼愉快！

推薦教學：《

Laravel教學》

以上是在 Laravel 7 中優雅使用 UUID 教程的詳細內容。更多資訊請關注PHP中文網其他相關文章！