Laravel之旅 - DB的操作(2) Eloquent ORM

<?php

namespace App;

use Illuminate\Contracts\Auth\MustVerifyEmail;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;

class User extends Authenticatable
{
    use Notifiable;

    /**
     * The attributes that are mass assignable.
     *
     * @var array
     */
    protected $fillable = [
        'name', 'email', 'password', 'isAdmin'
    ];

    /**
     * The attributes that should be hidden for arrays.
     *
     * @var array
     */
    protected $hidden = [
        'password', 'remember_token',
    ];

    /**
     * The attributes that should be cast to native types.
     *
     * @var array
     */
    protected $casts = [
        'email_verified_at' => 'datetime',
    ];
}

// 資料表的名稱
protected $table = 'users';

// 預設的主鍵名稱為 id，若不是則需要設設定 
protected $primaryKey = 'user_id';

// 若主鍵不是使用流水編號 ex. 1,2,3.....N 
public $incrementing = false;

// 主鍵的類型
protected $keyType = 'string';

// 使不使用時間戳記，預設為true
// 使用時間戳必須要有 created_at 和 updated_at 這兩個欄位
public $timestamps = false;

// 設定時間戳的欄位名稱
const CREATED_AT = 'creation_date';
const UPDATED_AT = 'last_update';

// 也可以獨立設定資料表的連線方式，設定後該資料表存取時就不會去使用.env中的方式
protected $connection = 'connection-name';

// 拿User這個model舉例

// 查詢PK = 1的資料
User::find(1);

// 查詢多筆資料 By PK欄位
User::find([1, 2, 3]);

// Where條件式，第一個參數為欄位名稱，第二個參數為值
User::where('name', 'Yee');

// Where也可以這樣用
User::where('age', '>', '18');

// Where還能這樣用 ((我最愛這方法ＸＤ
$query = [['name', '=', 'Yee'], ['age', '>', '18']]
User::where($query);

// 當然也有where NULL
User::whereNull('name')->get();
User::whereNotNull('name')->get();

// Insert 的方法一
$user = new User;
$user->name = 'Yee';
...
$user->save();

// Insert 的方法二
$attributes = [['name'=>'Yee', 'email'=>'yee@gmail.com']];
$user = User::create($attributes);

// 兩個新增的方法都會讓 $user 擁有剛剛新增得值

// Update 的方法一
$user = User::find(1);
$user->name = 'Yee2';
$user->save();

// Update 的方法二
// where條件請參考上面的方法
$user = User::where($query)->update($attributes);

// Delete 的方法，
User::find(1)->delete();

// 取第一筆
User::find(1)->first();

// 取全部
User::where('age', '>', '18')->get();

// 有資料回傳資料否則拋出Exception
User::find(1)->firstOrFail()

// 有資料回傳資料，否則使用另一個條件式查詢
User::where('name', 'Yee')->firstOr(['name', 'Yee2'])

// 有資料就回傳，否則新增一筆資料，方法一
$user = User::firstOrNew(
    ['email' =>  'yee@gmail.com'],
    ['name' => 'yee']
);

$user->save();

// 有資料就回傳，否則新增一筆資料，方法二
// 這方法不需要 $user->save();
$user = User::firstOrCreate(
    ['email' =>  'yee@gmail.com'],
    ['name' => 'Yee']
);

// 有資料就更新，否則新增一筆資料
$user = User::updateOrCreate(
    ['email' =>  'yee@gmail.com'],
    ['name' => 'Yee']
);