라라벨 쿼리 범위

Laravel의 쿼리 범위는 전체 애플리케이션에서 재사용할 수 있도록 모델에서 일반적으로 사용되는 쿼리 메서드를 정의할 수 있는 매우 중요한 기능입니다. 이러한 쿼리 범위는 전역(전체 모델에 적용) 또는 로컬(모델의 메서드에만 적용)일 수 있습니다.

이 글에서는 Laravel의 쿼리 범위에 대한 정의와 사용법, 그리고 주의해야 할 몇 가지 사항을 소개하겠습니다.

1. 쿼리 범위 정의

쿼리 범위는 Eloquent 쿼리 빌더 인스턴스인 $query 매개변수를 받는 익명 함수입니다. 이 익명 함수에서는 where 절 추가, order by 절 추가 등 인스턴스에 대한 일부 쿼리 작업을 수행할 수 있습니다.

다음은 기본 쿼리 범위 정의 예입니다.

public function scopePublished($query)
{
    return $query->where('status', '=', 'published');
}

위 예에서는 게시된 모델을 필터링하기 위해 쿼리할 때 자동으로 where 절을 추가하는 게시된 쿼리 범위를 정의합니다.

2. 쿼리 범위 사용

쿼리 범위 사용은 매우 간단합니다. 모델의 해당 메서드를 호출하기만 하면 됩니다. 예를 들어 위 예에서 게시된 쿼리 범위를 사용하는 경우 다음 코드만 호출하면 됩니다.

$posts = Post::published()->get();

위 코드는 게시된 모든 Post 인스턴스의 컬렉션을 반환합니다.

쿼리 범위에 매개변수를 전달해야 하는 경우 이 메서드에 매개변수를 추가하기만 하면 됩니다. 예:

public function scopeCategory($query, $categoryId)
{
    return $query->where('category_id', '=', $categoryId);
}

이 쿼리 범위는 특정 카테고리에 대한 블로그 게시물을 필터링하는 데 사용할 수 있습니다.

$posts = Post::category(1)->get();

위 코드는 카테고리 ID가 1인 모든 블로그 게시물을 반환합니다.

참고: 쿼리 범위는 연결될 수 있으므로 동시에 여러 쿼리 범위를 사용하여 더 정확한 결과를 얻을 수 있습니다.

3. 쿼리 범위의 전역 정의

전체 모델에서 동일한 쿼리 범위를 사용하려는 경우 전역 쿼리 범위를 정의할 수 있습니다. 이렇게 하려면 모델에서 부팅 메서드를 호출하고 static::addGlobalScope 메서드를 사용하여 전역 쿼리 범위를 정의하면 됩니다.

기본 전역 쿼리 범위 예는 다음과 같습니다.

protected static function boot()
{
    parent::boot();

    static::addGlobalScope('active', function (Builder $builder) {
        $builder->where('active', '=', 1);
    });
}

위 예에서는 active라는 전역 쿼리 범위를 정의하고 활성 필드가 1인 레코드로 제한했습니다.

이제 어떤 방법으로든 모델을 쿼리하면 쿼리 범위가 자동으로 적용됩니다.

4. 쿼리 범위 제거

때때로 특정 모델의 쿼리 범위를 제거해야 할 수도 있습니다. Laravel은 이를 달성하는 데 도움이 되는 RemoveGlobalScope 메소드를 제공합니다.

예를 들어 active라는 전역 쿼리 범위가 있다고 가정하면 다음을 사용하여 이를 제거할 수 있습니다.

$users = User::withoutGlobalScope('active')->get();

위 코드는 활성 범위에 의해 제한되지 않는 모든 사용자를 반환합니다.

참고: 모든 전역 쿼리 범위를 제거하려면 WithoutGlobalScopes 메서드를 사용할 수 있습니다.

$users = User::withoutGlobalScopes()->get();

위 코드는 전역 쿼리 범위에 의해 제한되지 않는 모든 사용자를 반환합니다.

요약

쿼리 범위는 Laravel의 매우 강력한 기능입니다. 쿼리 범위를 사용하면 애플리케이션 전체에서 일반적인 쿼리 작업을 쉽게 재사용하고 코드를 보다 명확하게 구성할 수 있습니다. 쿼리 범위의 올바른 사용법을 배우면 생산성이 향상될 뿐만 아니라 더욱 강력한 애플리케이션을 구축하는 데에도 도움이 됩니다.

위 내용은 라라벨 쿼리 범위의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!