哈囉，大家好！在上一篇文章中，我們成功地使用 Laravel 的 Migration 建立了資料庫結構。現在，是時候來探索 Laravel 中的另一個重要組件：Model（模型）。
透過 Model，我們可以輕鬆地與資料庫互動，實現資料的讀取、寫入和關聯操作。
一、什麼是 Laravel 的 Model？
在 Laravel 中，Model 是應用程式與資料庫之間的橋樑。它使用了 Eloquent ORM（Object-Relational Mapping），讓我們可以用物件的方式來操作資料庫，而不需要撰寫繁瑣的 SQL 語句。為什麼要使用 Model？
- 簡化資料庫操作：透過 Model，我們可以輕鬆地進行 CRUD（Create、Read、Update、Delete）操作。
- 物件導向：將資料庫中的資料映射為 PHP 物件，符合現代開發的最佳實踐。
- 關聯關係：方便地定義和使用資料表之間的關聯，如一對多、多對多關係。
- 提高可讀性：程式碼更加直觀，易於理解和維護。
個人經驗分享：還記得剛開始接觸 Laravel 時，對 Eloquent ORM 感到驚艷。以前需要寫大量的 SQL 語句，現在只需幾行程式碼就能完成。同時，程式碼的可讀性也大大提升，讓開發變得更輕鬆有趣。
二、建立 Model
1. 使用 Artisan 指令建立 Model
Laravel 提供了 Artisan 命令列工具，讓我們可以快速地生成 Model。
在終端機中執行以下指令：
php artisan make:model User
這將在 app/Models 目錄下建立一個 User.php 的檔案。
小提醒：Laravel 8 之後，Model 預設存放在 app/Models 目錄下。如果你使用的是較舊的版本，Model 可能位於 app 目錄下。
2. 為其他資料表建立 Model
按照同樣的方式，為我們的資料表建立相應的 Model。
- 建立 BankAccount Model：
php artisan make:model BankAccount
- 建立 Category Model：
php artisan make:model Category
- 建立 Transaction Model：
php artisan make:model Transaction
現在，我們已經為每個資料表建立了對應的 Model。接下來，讓我們來設定這些 Model，使其與資料表正確對應。
三、設定 Model 與資料表的關係
1. 基本設定
Laravel 的 Eloquent 會自動推斷資料表名稱，例如，User Model 對應到 users 資料表。但有時候，我們的資料表名稱可能與預設規則不符，這時需要在 Model 中明確指定。
舉例來說，如果我們的資料表名稱是 bank_accounts，Eloquent 會自動將 BankAccount Model 對應到 bank_accounts 資料表。但為了保險起見，我們可以在 Model 中指定：
class BankAccount extends Model
{
protected $table = 'bank_accounts';
}
2. 指定主鍵
如果資料表的主鍵名稱不是 id，需要在 Model 中指定主鍵欄位。例如：
class User extends Model
{
protected $primaryKey = 'user_id';
}
3. 關閉時間戳記
如果資料表中沒有 created_at 和 updated_at 欄位，可以在 Model 中關閉時間戳記：
class Category extends Model
{
public $timestamps = false;
}
四、定義 Model 之間的關聯
資料表之間的關聯可以透過 Model 來定義，這是 Eloquent 強大的地方。接下來，我們將為各個 Model 定義關聯關係。
1. User Model
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class User extends Model
{
// 一個使用者有多個銀行帳戶
public function bankAccounts()
{
return $this->hasMany(BankAccount::class);
}
// 一個使用者有多個分類
public function categories()
{
return $this->hasMany(Category::class);
}
// 一個使用者有多筆交易
public function transactions()
{
return $this->hasMany(Transaction::class);
}
}
2. BankAccount Model
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class BankAccount extends Model
{
// 屬於一個使用者
public function user()
{
return $this->belongsTo(User::class);
}
// 一個銀行帳戶有多筆交易
public function transactions()
{
return $this->hasMany(Transaction::class);
}
}
3. Category Model
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class Category extends Model
{
// 屬於一個使用者
public function user()
{
return $this->belongsTo(User::class);
}
// 一個分類有多筆交易
public function transactions()
{
return $this->hasMany(Transaction::class);
}
}
4. Transaction Model
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class Transaction extends Model
{
// 屬於一個使用者
public function user()
{
return $this->belongsTo(User::class);
}
// 屬於一個銀行帳戶
public function bankAccount()
{
return $this->belongsTo(BankAccount::class);
}
// 屬於一個分類
public function category()
{
return $this->belongsTo(Category::class);
}
}
五、使用 Model 進行資料庫操作
現在，我們已經設定好了 Model 和關聯關係。接下來，讓我們來看看如何使用 Model 進行資料庫操作。
1. 新增資料（Create）
範例：新增一個使用者
$user = new User();
$user->username = 'john_doe';
$user->email = 'john@example.com';
$user->password = bcrypt('secret');
$user->save();
範例：為使用者新增一個銀行帳戶
$bankAccount = new BankAccount();
$bankAccount->account_name = '薪資帳戶';
$bankAccount->account_number = '123456789';
$bankAccount->bank_name = '台灣銀行';
// 關聯到使用者
$user->bankAccounts()->save($bankAccount);
2. 查詢資料（Read）
範例：取得使用者的所有銀行帳戶
$user = User::find(1);
$bankAccounts = $user->bankAccounts;
範例：取得一筆交易的詳細資訊，包括使用者、銀行帳戶和分類
$transaction = Transaction::with(['user', 'bankAccount', 'category'])->find(1);
3. 更新資料（Update）
範例：更新銀行帳戶的餘額
$bankAccount = BankAccount::find(1);
$bankAccount->balance += 5000;
$bankAccount->save();
4. 刪除資料（Delete）
範例：刪除一個分類
$category = Category::find(1);
$category->delete();
5. 使用關聯進行操作
範例：透過使用者新增交易
$transaction = new Transaction([
'type' => 'expense',
'amount' => 2000,
'transaction_date' => now(),
'description' => '購買書籍',
]);
$user->transactions()->save($transaction);
六、還有沒有？
1. 使用 Eloquent 查詢構建器
Eloquent 提供了強大的查詢構建器，可以方便地進行各種複雜查詢。
範例：取得特定期間的收入總額
$totalIncome = Transaction::where('user_id', $user->id)
->where('type', 'income')
->whereBetween('transaction_date', [$startDate, $endDate])
->sum('amount');
2. 建立 Scope 簡化查詢
可以在 Model 中定義 Scope，讓常用的查詢條件更簡潔。
範例：在 Transaction Model 中定義 Scope
public function scopeIncome($query)
{
return $query->where('type', 'income');
}
public function scopeExpense($query)
{
return $query->where('type', 'expense');
}
使用 Scope 進行查詢
$totalIncome = Transaction::income()->sum('amount');
$totalExpense = Transaction::expense()->sum('amount');
3. 善用 Mutators 和 Accessors
可以在 Model 中定義 Mutators 和 Accessors，對欄位的值進行修改或格式化。
範例：在 User Model 中定義密碼的 Mutator
在模型中定義了一個名為 setPasswordAttribute 的方法時，這個方法會被自動觸發，因為 Laravel 提供了一個特性，允許開發者為模型屬性定義 "setter" 方法。這個 "setter" 方法會在你試圖為模型的屬性賦值時自動調用。
public function setPasswordAttribute($value)
{
$this->attributes['password'] = bcrypt($value);
}
這樣，當我們設定使用者密碼時，會自動進行加密：
$user->password = 'new_password'; // 會自動加密
具體原因：
- Laravel 的 Mutator 特性：
在 Laravel 中，當模型的屬性被設定時，會檢查是否有對應的 Mutator（即 set{AttributeName}Attribute 方法）。在這個例子中，屬性名稱是 password，因此 Laravel 會檢查模型中是否有一個名為 setPasswordAttribute 的方法。這個方法的命名遵循以下規則： - set：前綴，表示這是 “setter” 方法。
- Password：這是屬性的名稱，也就是模型中的 password 屬性。
- Attribute：固定的後綴，Laravel 用於識別這個方法是屬性 Mutator。
- 自動加密密碼：
當你給 $user→password 設置一個值時，Laravel 會自動調用 setPasswordAttribute 方法。在這個方法中，你可以定義如何處理這個值。你使用 bcrypt() 函數將明文密碼加密，然後再將加密後的值存儲到模型的 attributes 數組中，這個數組是用來保存模型的實際屬性值的。
小結
透過本篇文章，我們深入了解了 Laravel 的 Model 以及如何使用 Eloquent ORM 與資料庫進行互動。我們明白了：
- 建立 Model 並設定與資料表的關係。
- 定義 Model 之間的關聯，方便進行關聯操作。
- 使用 Model 進行資料的新增、查詢、更新和刪除。
- 善用 Eloquent 的特性，優化程式碼。
- 當你有一定要讓某個欄位進行相關處理時Mutators 和 Accessors是最好的控制點
希望這些內容能夠幫助你在開發中更加得心應手，寫出乾淨、可維護的程式碼。
But… 光是Model 就有很多可以講，但我們不要讓篇幅太多冗長，所以內容未來有機會，會在某個環節提出分享
Next
我們將開始開發後端 API，這部分開始會連通幾個關鍵行為，這樣會比較有脈絡。讓我們繼續這段充滿挑戰與樂趣的開發之旅吧！
