分享8個Laravel模型時間戳使用技巧小結(jié)

 默認(rèn)情況下，Laravel Eloquent 模型默認(rèn)數(shù)據(jù)表有 created_at 和 updated_at 兩個字段。當(dāng)然，我們可以做很多自定義配置，實現(xiàn)很多有趣的功能。下面舉例說明。

1. 禁用時間戳

如果數(shù)據(jù)表沒有這兩個字段，保存數(shù)據(jù)時 Model::create($arrayOfValues); —— 會看到 SQL error。Laravel 在自動填充 created_at / updated_at 的時候，無法找到這兩個字段。

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

class Role extends Model
{
  public $timestamps = FALSE;

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

2. 修改時間戳默認(rèn)列表

假如當(dāng)前使用的是非 Laravel 類型的數(shù)據(jù)庫，也就是你的時間戳列的命名方式與此不同該怎么辦？ 也許，它們分別叫做 create_time 和 update_time。恭喜，你也可以在模型種這么定義：

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

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

以下內(nèi)容引用官網(wǎng)文檔 official Laravel documentation:

默認(rèn)情況下，時間戳自動格式為 'Y-m-d H:i:s'。 如果您需要自定義時間戳格式，可以在你的模型中設(shè)置 $dateFormat 屬性。這個屬性確定日期在數(shù)據(jù)庫中的存儲格式，以及在序列化成數(shù)組或 JSON 時的格式：

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

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

當(dāng)在多對多的關(guān)聯(lián)中，時間戳不會自動填充，例如 用戶表  users 和 角色表 roles 的中間表 role_user。

在這個模型中您可以這樣定義關(guān)系：

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

然后當(dāng)你想用戶中添加角色時，可以這樣使用：

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

默認(rèn)情況下，這個中間表不包含時間戳。并且 Laravel 不會嘗試自動填充 created_at/updated_at

但是如果你想自動保存時間戳，您需要在遷移文件中添加 created_at/updated_at，然后在模型的關(guān)聯(lián)中加上 ->withTimestamps();

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

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

使用時間戳排序有兩個 “快捷方法”。

取而代之：

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

這么做更快捷：

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

默認(rèn)情況，latest() 使用 created_at 排序。

與之對應(yīng)，有一個 oldest() ，將會這么排序 created_at ascending

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

當(dāng)然，也可以使用指定的其他字段排序。例如，如果想要使用 updated_at，可以這么做：

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

6. 不觸發(fā) updated_at 的修改

無論何時，當(dāng)修改 Eloquent 記錄，都將會自動使用當(dāng)前時間戳來維護(hù) updated_at 字段，這是個非常棒的特性。

但是有時候你卻不想這么做，例如：當(dāng)增加某個值，認(rèn)為這不是 “整行更新”。

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

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

7. 僅更新時間戳和關(guān)聯(lián)時間戳

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

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

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

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

$user->touch();

另一種情況，有時候您不僅希望更新當(dāng)前模型的 updated_at，也希望更新上級關(guān)系的記錄。

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

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

class Comment extends Model {

  protected $touches = ['post'];

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

}

8. 時間戳字段自動轉(zhuǎn)換 Carbon 類

最后一個技巧，但更像是一個提醒，因為您應(yīng)該已經(jīng)知道它。

默認(rèn)情況下，created_at 和 updated_at 字段被自動轉(zhuǎn)換為 $dates，
所以您不需要將他們轉(zhuǎn)換為 Carbon 實例，即可以使用 Carbon 的方法。

例如：

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

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

以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。