【整理分享】Laravel模型時間戳的8個使用小技巧

Laravel 9 保姆級視訊教學，想學不會都難！進入學習

預設情況下，Laravel Eloquent 模型預設資料表有 created_at 和 updated_at 兩個欄位。當然，我們可以做很多自定義設定，實現很多有趣的功能。下面舉例說明。

1.禁用時間戳

如果資料表沒有這兩個欄位，儲存資料時 Model::create($arrayOfValues); ——會看到 SQL error。Laravel 在自動填充 created_at / updated_at 的時候，無法找到這兩個欄位。

禁用自動填充時間戳，只需要在 Eloquent Model 新增上一個屬性：

class Role extends Model
{
    public $timestamps = FALSE;

    // ... 其他的屬性和方法
}

2. 修改時間戳預設列表

假如當前使用的是非 Laravel 型別的資料庫，也就是你的時間戳列的命名方式與此不同該怎麼辦？ 也許，它們分別叫做 create_time 和 update_time。恭喜，你也可以在模型種這麼定義：

class Role extends Model
{
    const CREATED_AT = 'create_time';
    const UPDATED_AT = 'update_time';

3. 修改時間戳日期/時間格式

以下內容參照官網檔案 official Laravel documentation:

預設情況下，時間戳自動格式為 'Y-m-d H:i:s'。 如果您需要自定義時間戳格式, 可以在你的模型中設定 $dateFormat屬性。這個屬性確定日期在資料庫中的儲存格式，以及在序列化成陣列或JSON時的格式：

class Flight extends Model
{
    /**
     * 日期時間的儲存格式
     *
     * @var string
     */
    protected $dateFormat = 'U';
}

4. 多對多: 帶時間戳的中間表

當在多對多的關聯中，時間戳不會自動填充，例如 使用者表 users 和 角色表roles的中間表role_user。

在這個模型中您可以這樣定義關係：

class User extends Model
{
    public function roles()
    {
        return $this->belongsToMany(Role::class);
    }
}

然後當你想使用者中新增角色時，可以這樣使用：

$roleID = 1;
$user->roles()->attach($roleID);

預設情況下，這個中間表不包含時間戳。並且Laravel不會嘗試自動填充created_at/updated_at

但是如果你想自動儲存時間戳，您需要在遷移檔案中新增created_at/updated_at，然後在模型的關聯中加上->withTimestamps();

public function roles()
{
    return $this->belongsToMany(Role::class)->withTimestamps();
}

5. 使用latest()和oldest()進行時間戳排序

使用時間戳排序有兩個 「快捷方法」。

取而代之：

User::orderBy('created_at', 'desc')->get();

這麼做更快捷：

User::latest()->get();

預設情況，latest() 使用 created_at 排序。

與之對應，有一個 oldest() ，將會這麼排序 created_at ascending

User::oldest()->get();

當然，也可以使用指定的其他欄位排序。例如，如果想要使用 updated_at，可以這麼做：

$lastUpdatedUser = User::latest('updated_at')->first();

6. 不觸發 updated_at的修改

無論何時，當修改 Eloquent 記錄，都將會自動使用當前時間戳來維護 updated_at 欄位，這是個非常棒的特性。

但是有時候你卻不想這麼做，例如：當增加某個值，認為這不是 「整行更新」。

那麼，你可以一切如上—— 只需禁用 timestamps，記住這是臨時的：

$user = User::find(1);
$user->profile_views_count = 123;
$user->timestamps = false;
$user->save();

7. 僅更新時間戳和關聯時間戳

與上一個例子恰好相反，也許您需要僅更新updated_at欄位，而不改變其他列。

所以，不建議下面這種寫法：

$user->update(['updated_at' => now()]);

您可以使用更快捷的方法：

$user->touch();

另一種情況，有時候您不僅希望更新當前模型的updated_at，也希望更新上級關係的記錄。

例如，某個comment被更新，那麼您希望將post表的updated_at也更新。

那麼，您需要在模型中定義$touches屬性：

class Comment extends Model {

    protected $touches = ['post'];

    public function post()
    {
        return $this->belongsTo('Post');
    }

}

8. 時間戳欄位自動轉換Carbon類

最後一個技巧，但更像是一個提醒，因為您應該已經知道它。

預設情況下，created_at和updated_at欄位被自動轉換為$dates，
所以您不需要將他們轉換為Carbon範例，即可以使用Carbon的方法。

例如：

$user->created_at->addDays(3);
now()->diffInDays($user->updated_at);

就這樣，快速但希望有用的提示！

英文原文地址：https://laraveldaily.com/8-tricks-with-laravel-timestamps/

譯文地址：https://learnku.com/laravel/t/39353

以上就是【整理分享】Laravel模型時間戳的8個使用小技巧的詳細內容，更多請關注TW511.COM其它相關文章！