在laravel中,軟刪除指的是資料表記錄並未真的從資料庫中刪除,而是將表記錄的表示狀態標記為軟刪除,這樣在查詢時就可以進行過濾,讓對應表記錄看起來像是被「刪除」了。
本文操作環境:Windows10系統、Laravel6版、Dell G3電腦。
1、刪除模型
1.1 使用delete刪除模型
#刪除模型很簡單,先取得要刪除的模型實例,然後呼叫delete
方法即可:
$post = Post::find(5); if($post->delete()){ echo '删除文章成功!'; }else{ echo '删除文章失败!'; }
該方法傳回true
或false
。
1.2 使用destroy刪除模型
當然如果已知要刪除的模型id的話,可以用更簡單的方法destroy
直接刪除:
$deleted = Post::destroy(5);
你也可以一次傳入多個模型id刪除多個模型:
$deleted = Post::destroy([1,2,3,4,5]);
呼叫destroy
方法傳回被刪除的記錄數。
1.3 使用查詢建構器刪除模型
既然前面提到Eloquent模型本身就是查詢建構器,也可以使用查詢建構器風格刪除模型,例如我們要刪除所有瀏覽數為0的文章,可以使用以下方式:
$deleted = Models\Post::where('views', 0)->delete();
傳回結果為刪除的文章數。
2.1 軟刪除實作
上述刪除方法都會記錄資料表從資料庫刪除,此外Eloquent模型也支援軟刪除。
所謂軟刪除指的是資料表記錄並未真的從資料庫刪除,而是將表記錄的標識狀態標記為軟刪除,這樣在查詢的時候就可以加以過濾,讓對應表記錄看上去是被」刪除「了。 Laravel中使用了一個日期欄位作為識別狀態,這個日期欄位可以自定義,這裡我們使用deleted_at
,如果對應模型被軟刪除,則deleted_at
欄位的值為刪除時間,否則該值為空。
要讓Eloquent模型支援軟刪除,還要做一些設定。首先在模型類別中要使用SoftDeletes
trait,該trait為軟體刪除提供一系列相關方法,具體可參考原始碼Illuminate\Database\Eloquent\SoftDeletes
,此外也要設定$date
屬性數組,將deleted_at
放在其中:
<?php namespace App\Models; use Illuminate\Database\Eloquent\Model; use Illuminate\Database\Eloquent\SoftDeletes; class Post extends Model { use SoftDeletes; //设置表名 public $table = 'posts'; //设置主键 public $primaryKey = 'id'; //设置日期时间格式 public $dateFormat = 'U'; protected $guarded = ['id','views','user_id','updated_at','created_at']; protected $dates = ['delete_at']; }
然後對應的資料庫posts
中新增deleted_at
列,我們使用遷移來實現,先執行Artisan命令:
php artisan make:migration alter_posts_deleted_at --table=posts
然後編輯生成的PHP檔案如下:
<?php use Illuminate\Database\Schema\Blueprint; use Illuminate\Database\Migrations\Migration; class AlterPostsDeletedAt extends Migration { /** * Run the migrations. * * @return void */ public function up() { Schema::table('posts', function (Blueprint $table) { $table->softDeletes(); }); } ...//其它方法 }
然後運行:
php artisan migrate
這樣posts
中就有了deleted_at
列。接下來,我們在控制器中編寫測試程式碼:
$post = Post::find(6); $post->delete(); if($post->trashed()){ echo '软删除成功!'; dd($post); }else{ echo '软删除失败!'; }
在瀏覽器中存取http://laravel.app:8000/test
,頁面輸出如下:
當我們再次透過下面這段程式碼取得所有文章:
$posts = Post::all(); dd($posts);
已經看不到id為6的文章的身影了。
2.2 查詢結果包含軟刪除模型
那如果想要在查詢結果中包含軟刪除的記錄呢?可以使用SoftDeletes
trait上的withTrashed
方法:
$posts = Post::withTrashed()->get(); dd($posts);
執行後頁面顯示如下:
id為6的文章又出現在了查詢結果中。有時候我們只想要查看被軟刪除的模型,這也有招,透過SoftDeletes
上的onlyTrashed
方法即可:
$posts = Post::onlyTrashed()->get(); dd($posts);
執行後頁面顯示結果如下:
2.3 軟體刪除恢復
有時候我們需要恢復被軟體刪除的模型,可以使用SoftDeletes
提供的restore
方法:
還原單一模型
$post = Post::find(6); $post->restore();
還原多個模型
Post::withTrashed()->where('id','>',1)->restore();
恢復所有模型
Post::withTrashed()->restore();
恢復關聯查詢模型
$post = Post::find(6); $post->history()->restore();
2.4 強制刪除
#如果模型配置了軟體刪除但我們確實要刪除改模型對應資料庫表記錄,則可以使用SoftDeletes
提供的forceDelete
方法:
$post = Post::find(6); $post->forceDelete();
查看資料表可以發現id=6的表記錄已經被刪除,不復存在:
#【相關推薦:laravel影片教學】
以上是laravel軟刪除的原理是什麼的詳細內容。更多資訊請關注PHP中文網其他相關文章!