# 查詢范圍 ### [](https://octobercms.com/docs/database/model#query-scopes)查詢范圍 范圍使您可以定義常見的約束集，可以輕松地在整個應用程序中重復使用這些約束。例如，您可能需要經常檢索所有被認為“受歡迎”的用戶。要定義范圍，只需在模型方法前添加前綴`scope`： ~~~ class User extends Model { /** * Scope a query to only include popular users. */ public function scopePopular($query) { return $query->where('votes', '>', 100); } /** * Scope a query to only include active users. */ public function scopeActive($query) { return $query->where('is_active', 1); } } ~~~ #### 利用查詢范圍 定義范圍后，可以在查詢模型時調用范圍方法。但是，`scope`在調用方法時不需要包括前綴。您甚至可以將調用鏈接到各種范圍，例如： ~~~ $users = User::popular()->active()->orderBy('created_at')->get(); ~~~ #### 動態范圍 有時您可能希望定義一個接受參數的范圍。首先，只需將其他參數添加到您的范圍。范圍參數應在`$query`參數后定義： ~~~ class User extends Model { /** * Scope a query to only include users of a given type. */ public function scopeApplyType($query, $type) { return $query->where('type', $type); } } ~~~ 現在，您可以在調用范圍時傳遞參數： ~~~ $users = User::applyType('admin')->get(); ~~~