下面由Laravel教程欄目給大家分享8個(gè)Laravel模型時(shí)間戳使用小技巧,看看你都沒用過,沒用就快來收藏吧,希望對大家有所幫助!
Laravel 9 保姆級視頻教程,想學(xué)不會(huì)都難!進(jìn)入學(xué)習(xí)
默認(rèn)情況下,Laravel Eloquent
模型默認(rèn)數(shù)據(jù)表有 created_at
和 updated_at
兩個(gè)字段。當(dāng)然,我們可以做很多自定義配置,實(shí)現(xiàn)很多有趣的功能。下面舉例說明。
1.禁用時(shí)間戳
如果數(shù)據(jù)表沒有這兩個(gè)字段,保存數(shù)據(jù)時(shí) Model::create($arrayOfValues); ——會(huì)看到 SQL error
。Laravel
在自動(dòng)填充 created_at / updated_at
的時(shí)候,無法找到這兩個(gè)字段。
禁用自動(dòng)填充時(shí)間戳,只需要在 Eloquent Model
添加上一個(gè)屬性:
class Role extends Model { public $timestamps = FALSE; // ... 其他的屬性和方法 }
2. 修改時(shí)間戳默認(rèn)列表
假如當(dāng)前使用的是非 Laravel
類型的數(shù)據(jù)庫,也就是你的時(shí)間戳列的命名方式與此不同該怎么辦? 也許,它們分別叫做 create_time 和 update_time。恭喜,你也可以在模型種這么定義:
class Role extends Model { const CREATED_AT = 'create_time'; const UPDATED_AT = 'update_time';
3. 修改時(shí)間戳日期/時(shí)間格式
以下內(nèi)容引用官網(wǎng)文檔 official Laravel documentation:
默認(rèn)情況下,時(shí)間戳自動(dòng)格式為 'Y-m-d H:i:s'
。 如果您需要自定義時(shí)間戳格式, 可以在你的模型中設(shè)置 $dateFormat
屬性。這個(gè)屬性確定日期在數(shù)據(jù)庫中的存儲格式,以及在序列化成數(shù)組或JSON時(shí)的格式:
class Flight extends Model { /** * 日期時(shí)間的存儲格式 * * @var string */ protected $dateFormat = 'U'; }
4. 多對多: 帶時(shí)間戳的中間表
當(dāng)在多對多的關(guān)聯(lián)中,時(shí)間戳不會(huì)自動(dòng)填充,例如 用戶表 users 和 角色表roles的中間表role_user。
在這個(gè)模型中您可以這樣定義關(guān)系:
class User extends Model { public function roles() { return $this->belongsToMany(Role::class); } }
然后當(dāng)你想用戶中添加角色時(shí),可以這樣使用:
$roleID = 1; $user->roles()->attach($roleID);
默認(rèn)情況下,這個(gè)中間表不包含時(shí)間戳。并且Laravel
不會(huì)嘗試自動(dòng)填充created_at/updated_at
但是如果你想自動(dòng)保存時(shí)間戳,您需要在遷移文件中添加created_at/updated_at
,然后在模型的關(guān)聯(lián)中加上->withTimestamps();
public function roles() { return $this->belongsToMany(Role::class)->withTimestamps(); }
5. 使用latest()
和oldest()
進(jìn)行時(shí)間戳排序
使用時(shí)間戳排序有兩個(gè) “快捷方法”。
取而代之:
User::orderBy('created_at', 'desc')->get();
這么做更快捷:
User::latest()->get();
默認(rèn)情況,latest() 使用 created_at 排序。
與之對應(yīng),有一個(gè) oldest() ,將會(huì)這么排序 created_at ascending
User::oldest()->get();
當(dāng)然,也可以使用指定的其他字段排序。例如,如果想要使用 updated_at,可以這么做:
$lastUpdatedUser = User::latest('updated_at')->first();
6. 不觸發(fā) updated_at
的修改
無論何時(shí),當(dāng)修改 Eloquent
記錄,都將會(huì)自動(dòng)使用當(dāng)前時(shí)間戳來維護(hù) updated_at 字段,這是個(gè)非常棒的特性。
但是有時(shí)候你卻不想這么做,例如:當(dāng)增加某個(gè)值,認(rèn)為這不是 “整行更新”。
那么,你可以一切如上—— 只需禁用 timestamps
,記住這是臨時(shí)的:
$user = User::find(1); $user->profile_views_count = 123; $user->timestamps = false; $user->save();
7. 僅更新時(shí)間戳和關(guān)聯(lián)時(shí)間戳
與上一個(gè)例子恰好相反,也許您需要僅更新updated_at字段,而不改變其他列。
所以,不建議下面這種寫法:
$user->update(['updated_at' => now()]);
您可以使用更快捷的方法:
$user->touch();
另一種情況,有時(shí)候您不僅希望更新當(dāng)前模型的updated_at,也希望更新上級關(guān)系的記錄。
例如,某個(gè)comment被更新,那么您希望將post表的updated_at
也更新。
那么,您需要在模型中定義$touches
屬性:
class Comment extends Model { protected $touches = ['post']; public function post() { return $this->belongsTo('Post'); } }
8. 時(shí)間戳字段自動(dòng)轉(zhuǎn)換Carbon
類
最后一個(gè)技巧,但更像是一個(gè)提醒,因?yàn)槟鷳?yīng)該已經(jīng)知道它。
默認(rèn)情況下,created_at和updated_at字段被自動(dòng)轉(zhuǎn)換為$dates,
所以您不需要將他們轉(zhuǎn)換為Carbon
實(shí)例,即可以使用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