perf(core): 대용량 목록 상한 총 건수·커서 계약 신설 및 요청당 반복 실행 비용 정리
공개 이슈 gnuboard/g7 이 지목한 병목은 "같은 일을 반복 실행한다" 축이다. 응답·행의 무게를 다룬 · 과 겹치지 않는다. 공통 계약 — 총 건수 상한과 페이지 이동 범위는 별개 결정이다. 묶으면 필요 없이 기능이 깎인다. 총 건수만 상한을 받고(파생 테이블 COUNT), "다음" 이동은 per_page + 1 실측으로 끝까지 열어 둔다. 계산이 불가능해지는 것은 마지막 페이지 번호 하나뿐이며 그 사실은 last_page: null 이 알린다. 최신순처럼 실제 컬럼으로 정렬하는 목록은 커서로 전환해 깊이와 무관하게 일정 속도로 이동한다. 관련도순은 계산값 정렬이라 커서 키로 쓸 수 없어 offset 을 유지한다. 계약의 입구는 표준 paginate 와 같은 폭이어야 한다. 관계·쿼리 빌더를 받지 못하면 그 좁은 만큼이 그대로 운영 500 이 되고, 실제로 관리자 알림 목록에서 그렇게 터졌다. 응답 조립도 컬렉션마다 손으로 하면 형태가 늘어나는 순간 없는 값을 부르거나 새 필드를 흘리므로, 형태 판정을 paginationMeta 한 곳에 모았다. 표준 paginate 응답은 필드 단위로 이전과 동일하다. 요청당 반복 비용 — 훅 구독마다 남기던 로그 400줄, 요청당 스무 번 넘던 설정 파일 재읽기, 이미 캐시된 목록의 DB 재조회를 없앴다. 권한 판정은 요청 스코프 메모를 두어 화면 요소마다 나가던 조회를 한 번으로 줄였고, 크로스 요청 캐시는 두지 않아 권한 변경이 종전처럼 다음 요청에 반영된다. 검색 질의는 활성 엔진이 만든다. 저장소가 구체 엔진을 지목하면 플러그인이 등록한 엔진은 호출될 기회 자체를 잃고 오류 없이 다른 방식으로 동작한다. 해석기를 두어 활성 엔진에 위임하고, 전문검색이 없는 DBMS 의 부분일치 폴백도 드라이버명 하드코딩 대신 선언형 config 로 옮겼다. 총 건수가 잘린 목록에서 순번을 역산하면 0 과 음수가 나온다. 지어내지 않고 null 을 돌려주며, 그 원칙을 last_page 와 동일하게 적용했다.
This commit is contained in:
1 parent
97ab99b7cd
commit
2ae1972a3b
101 files changed
+6160
-322
No files matched your search
@@ -2,7 +2,13 @@
|
||||
|
||||
namespace App\Search\Engines;
|
||||
|
||||
use App\Enums\TotalRelation;
|
||||
use App\Search\Contracts\FulltextSearchable;
|
||||
use App\Search\Contracts\KeywordPredicateProvider;
|
||||
use App\Search\DTO\KeywordSearchContext;
|
||||
use App\Search\KeywordSearch;
|
||||
use App\Support\Query\BoundedPaginator;
|
||||
use App\Support\Query\PaginationLimits;
|
||||
use Illuminate\Database\Eloquent\Collection;
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
@@ -18,7 +24,7 @@ use Laravel\Scout\Engines\Engine;
|
||||
*
|
||||
* MySQL 자체가 인덱스 소스이므로 update/delete/flush는 no-op입니다.
|
||||
*/
|
||||
class DatabaseFulltextEngine extends Engine
|
||||
class DatabaseFulltextEngine extends Engine implements KeywordPredicateProvider
|
||||
{
|
||||
/**
|
||||
* MariaDB 감지 결과 캐시 (프로세스 수명 동안 유지)
|
||||
@@ -53,20 +59,52 @@ class DatabaseFulltextEngine extends Engine
|
||||
* FULLTEXT 검색을 수행합니다.
|
||||
*
|
||||
* @param Builder $builder Scout 빌더
|
||||
* @return array{query: \Illuminate\Database\Eloquent\Builder, total: int}
|
||||
* @return array{query: \Illuminate\Database\Eloquent\Builder|null, total: int|null, total_relation: TotalRelation|null, result_cap: int|null}
|
||||
*/
|
||||
public function search(Builder $builder): array
|
||||
{
|
||||
return $this->performSearch($builder);
|
||||
}
|
||||
|
||||
/**
|
||||
* 검색 결과의 키 목록만 조회합니다.
|
||||
*
|
||||
* 총 건수를 쓰지 않는 경로이므로 COUNT 를 아예 실행하지 않고, SELECT 도 키 컬럼과
|
||||
* 정렬용 스코어로만 좁힙니다. 좁히지 않으면 매칭된 전 행의 모든 컬럼(본문 포함)을
|
||||
* 읽고 나서 ID 만 뽑아내게 됩니다.
|
||||
*
|
||||
* @param Builder $builder Scout 빌더
|
||||
* @return \Illuminate\Support\Collection 키 컬렉션
|
||||
*/
|
||||
public function keys(Builder $builder): \Illuminate\Support\Collection
|
||||
{
|
||||
return $this->mapIds($this->performSearch($builder, withTotal: false, keysOnly: true));
|
||||
}
|
||||
|
||||
/**
|
||||
* 검색 결과를 모델 컬렉션으로 조회합니다.
|
||||
*
|
||||
* 총 건수를 쓰지 않는 경로이므로 COUNT 를 실행하지 않습니다.
|
||||
*
|
||||
* @param Builder $builder Scout 빌더
|
||||
* @return Collection 모델 컬렉션
|
||||
*/
|
||||
public function get(Builder $builder): Collection
|
||||
{
|
||||
return $this->map(
|
||||
$builder,
|
||||
$builder->applyAfterRawSearchCallback($this->performSearch($builder, withTotal: false)),
|
||||
$builder->model
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* 페이지네이션 적용 FULLTEXT 검색을 수행합니다.
|
||||
*
|
||||
* @param Builder $builder Scout 빌더
|
||||
* @param int $perPage 페이지당 결과 수
|
||||
* @param int $page 페이지 번호
|
||||
* @return array{query: \Illuminate\Database\Eloquent\Builder, total: int}
|
||||
* @return array{query: \Illuminate\Database\Eloquent\Builder|null, total: int|null, total_relation: TotalRelation|null, result_cap: int|null}
|
||||
*/
|
||||
public function paginate(Builder $builder, $perPage, $page): array
|
||||
{
|
||||
@@ -85,7 +123,13 @@ class DatabaseFulltextEngine extends Engine
|
||||
return collect();
|
||||
}
|
||||
|
||||
return $query->pluck($query->getModel()->getKeyName());
|
||||
// `pluck()` 은 이미 걸려 있는 SELECT 를 보존한다(onceWithColumns). 검색 쿼리는
|
||||
// 관련도 점수를 위해 `table.*` 를 선택해 두므로, 그대로 두면 ID 만 필요한 자리에서
|
||||
// 전 컬럼을 읽는다. 사본에서 키 컬럼만 남겨 좁힌다.
|
||||
$model = $query->getModel();
|
||||
$key = $model->getQualifiedKeyName();
|
||||
|
||||
return $query->clone()->select($key)->pluck($model->getKeyName());
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -129,7 +173,31 @@ class DatabaseFulltextEngine extends Engine
|
||||
*/
|
||||
public function getTotalCount($results): int
|
||||
{
|
||||
return $results['total'] ?? 0;
|
||||
return (int) ($results['total'] ?? 0);
|
||||
}
|
||||
|
||||
/**
|
||||
* 검색 결과의 총 건수 정확도를 반환합니다.
|
||||
*
|
||||
* 상한을 넘겨 정확히 세지 않은 경우 `AtLeast` 입니다.
|
||||
*
|
||||
* @param array $results 검색 결과
|
||||
* @return TotalRelation 총 건수 정확도
|
||||
*/
|
||||
public function getTotalRelation($results): TotalRelation
|
||||
{
|
||||
return $results['total_relation'] ?? TotalRelation::Exact;
|
||||
}
|
||||
|
||||
/**
|
||||
* 총 건수 집계에 적용된 상한을 반환합니다.
|
||||
*
|
||||
* @param array $results 검색 결과
|
||||
* @return int|null 상한 (무제한이면 null)
|
||||
*/
|
||||
public function getResultCap($results): ?int
|
||||
{
|
||||
return $results['result_cap'] ?? null;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -239,6 +307,14 @@ class DatabaseFulltextEngine extends Engine
|
||||
* MySQL 파싱 오류(ER_PARSE_ERROR)를 유발하므로, 사용자 입력을 일반 검색어로만
|
||||
* 취급하도록 연산자를 제거하고 남은 토큰을 따옴표 구문으로 묶습니다.
|
||||
*
|
||||
* 토큰은 공백으로 잇습니다 — BOOLEAN MODE 에서 공백 결합은 OR 입니다. 각 토큰에 `+` 를
|
||||
* 붙이면 AND 가 되어 매칭 집합이 줄고 대용량에서 검색 시간이 짧아질 여지가 있지만,
|
||||
* **의도적으로 OR 을 유지합니다**. 입력한 단어 중 하나만 든 문서가 결과에서 통째로
|
||||
* 사라지는 손실이 성능 이득보다 크기 때문입니다. 한글은 ngram 파서가 2글자 단위로
|
||||
* 토큰을 쪼개므로 AND 전환의 결과 축소 폭이 특히 큽니다. 성능 축이 문제가 되면 결합
|
||||
* 방식이 아니라 전용 검색 엔진(core.search.engine_drivers)으로 해결합니다.
|
||||
* 배경·실측: docs/backend/search-system.md, docs/backend/pagination.md
|
||||
*
|
||||
* @param string $keyword 원본 검색어
|
||||
* @return string 안전하게 정제된 BOOLEAN MODE 검색식 (정제 결과가 없으면 빈 문자열)
|
||||
*/
|
||||
@@ -267,32 +343,114 @@ class DatabaseFulltextEngine extends Engine
|
||||
*
|
||||
* DBMS별로 MATCH...AGAINST 또는 LIKE fallback을 자동 적용합니다.
|
||||
*
|
||||
* 검색어는 반드시 이 헬퍼를 거쳐야 합니다. BOOLEAN MODE 는 `+ - * " ( )` 등을
|
||||
* 연산자로 해석하므로, 원문 키워드를 그대로 바인딩하면 사용자가 `+` 하나만 입력해도
|
||||
* 파싱 오류로 500 이 됩니다. 정제는 sanitizeBooleanModeKeyword 한 곳에서만 합니다.
|
||||
*
|
||||
* **컬럼을 배열로 넘기면 하나의 `MATCH(a, b)` 가 됩니다.** MySQL 은 이 형태에 정확히
|
||||
* 그 컬럼 조합의 **복합 FULLTEXT 인덱스**를 요구하며, 없으면
|
||||
* `Can't find FULLTEXT index matching the column list` 오류가 납니다.
|
||||
* 컬럼별 단일 인덱스만 있는 테이블은 {@see self::whereFulltextAny()} 를 쓰세요.
|
||||
*
|
||||
* @param \Illuminate\Database\Eloquent\Builder $query Eloquent 쿼리 빌더
|
||||
* @param string $column 검색 대상 컬럼명
|
||||
* @param string $keyword 검색어
|
||||
* @param string|array<int, string> $columns 검색 대상 컬럼명 (배열이면 복합 인덱스 필요)
|
||||
* @param string $keyword 검색어 (원문 — 정제는 이 메서드가 수행)
|
||||
* @param string $boolean 조건 결합 방식 ('and' 또는 'or')
|
||||
*/
|
||||
public static function whereFulltext(
|
||||
\Illuminate\Database\Eloquent\Builder $query,
|
||||
string $column,
|
||||
string|array $columns,
|
||||
string $keyword,
|
||||
string $boolean = 'and'
|
||||
): void {
|
||||
if (static::supportsFulltext()) {
|
||||
$ftKeyword = static::sanitizeBooleanModeKeyword($keyword);
|
||||
if ($ftKeyword === '') {
|
||||
// 정제 결과 없음 → 항상 false 조건으로 빈 결과 (void 반환 계약 유지)
|
||||
$falseMethod = $boolean === 'or' ? 'orWhereRaw' : 'whereRaw';
|
||||
$query->$falseMethod('1 = 0');
|
||||
// 활성 엔진 해석을 거친다 — 다른 엔진이 켜져 있으면 그 엔진이 조건을 만든다.
|
||||
// 이 정적 헬퍼를 직접 부르던 코드도 이 경유로 엔진 교체 혜택을 받는다.
|
||||
KeywordSearch::apply($query, $columns, $keyword, $boolean);
|
||||
}
|
||||
|
||||
return;
|
||||
}
|
||||
$method = $boolean === 'or' ? 'orWhereRaw' : 'whereRaw';
|
||||
$query->$method("MATCH(`{$column}`) AGAINST(? IN BOOLEAN MODE)", [$ftKeyword]);
|
||||
} else {
|
||||
$method = $boolean === 'or' ? 'orWhere' : 'where';
|
||||
$query->$method($column, 'LIKE', "%{$keyword}%");
|
||||
/**
|
||||
* {@inheritDoc}
|
||||
*
|
||||
* 이 엔진의 술어는 `MATCH ... AGAINST IN BOOLEAN MODE` 입니다. DBMS 가 FULLTEXT 를
|
||||
* 지원하지 않으면 같은 자리에서 부분일치로 내려갑니다.
|
||||
*
|
||||
* `$context->keyCap` 은 쓰지 않습니다 — 이 엔진의 술어는 SQL 조건 그 자체라 중간
|
||||
* 키 집합을 만들지 않으므로 상한을 적용할 대상이 없습니다. 상한은 키 집합을 만들어
|
||||
* 조건으로 붙이는 엔진(외부 검색 서버 등)을 위한 것입니다.
|
||||
*/
|
||||
public function applyKeywordPredicate(
|
||||
\Illuminate\Database\Eloquent\Builder $query,
|
||||
array $columns,
|
||||
string $keyword,
|
||||
string $boolean,
|
||||
KeywordSearchContext $context
|
||||
): void {
|
||||
static::applyFulltextPredicate($query, $columns, $keyword, $boolean);
|
||||
}
|
||||
|
||||
/**
|
||||
* FULLTEXT 조건을 실제로 조립합니다.
|
||||
*
|
||||
* @param \Illuminate\Database\Eloquent\Builder $query Eloquent 쿼리 빌더
|
||||
* @param array<int, string> $columns 검색 대상 컬럼명
|
||||
* @param string $keyword 검색어 원문
|
||||
* @param string $boolean 조건 결합 방식 ('and' 또는 'or')
|
||||
*/
|
||||
protected static function applyFulltextPredicate(
|
||||
\Illuminate\Database\Eloquent\Builder $query,
|
||||
array $columns,
|
||||
string $keyword,
|
||||
string $boolean = 'and'
|
||||
): void {
|
||||
$columns = array_values($columns);
|
||||
|
||||
if (! static::supportsFulltext()) {
|
||||
// 전문검색을 제공하지 않는 DBMS 로 설치된 사이트에서는 부분일치가 정상 경로다.
|
||||
// 연산자 선택과 와일드카드 escape 는 코어 해석기가 단독으로 수행한다 —
|
||||
// 여기서 다시 조립하면 DBMS 가 늘 때마다 고쳐야 할 곳이 둘이 된다.
|
||||
KeywordSearch::applyLikeMatch($query, $columns, $keyword, $boolean);
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
$ftKeyword = static::sanitizeBooleanModeKeyword($keyword);
|
||||
|
||||
if ($ftKeyword === '') {
|
||||
// 정제 결과 없음(연산자만 입력) → 빈 결과. 빌더가 바인딩까지 처리하도록
|
||||
// 빈 whereIn 을 쓴다 (raw '1 = 0' 은 쓰지 않는다).
|
||||
$method = $boolean === 'or' ? 'orWhereIn' : 'whereIn';
|
||||
$query->$method($query->getModel()->getQualifiedKeyName(), []);
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
$match = 'MATCH(`'.implode('`, `', $columns).'`)';
|
||||
$method = $boolean === 'or' ? 'orWhereRaw' : 'whereRaw';
|
||||
$query->$method($match.' AGAINST(? IN BOOLEAN MODE)', [$ftKeyword]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 여러 컬럼 중 하나라도 매칭하면 되는 FULLTEXT 조건을 추가합니다.
|
||||
*
|
||||
* 컬럼마다 별도의 `MATCH(col)` 를 만들어 OR 로 묶습니다. 컬럼별 단일 FULLTEXT 인덱스만
|
||||
* 있는 테이블(대부분의 경우)에서 쓰는 형태이며, 복합 인덱스가 없어도 동작합니다.
|
||||
*
|
||||
* 복합 인덱스가 있어 `MATCH(a, b)` 한 번으로 끝내야 하는 테이블은
|
||||
* {@see self::whereFulltext()} 에 배열을 넘기세요.
|
||||
*
|
||||
* @param \Illuminate\Database\Eloquent\Builder $query Eloquent 쿼리 빌더
|
||||
* @param array<int, string> $columns 검색 대상 컬럼명 목록
|
||||
* @param string $keyword 검색어 (원문 — 정제는 내부에서 수행)
|
||||
* @param string $boolean 바깥 쿼리와의 결합 방식 ('and' 또는 'or')
|
||||
*/
|
||||
public static function whereFulltextAny(
|
||||
\Illuminate\Database\Eloquent\Builder $query,
|
||||
array $columns,
|
||||
string $keyword,
|
||||
string $boolean = 'and'
|
||||
): void {
|
||||
// 활성 엔진 해석을 거친다 ({@see self::whereFulltext()} 와 동일한 이유).
|
||||
KeywordSearch::applyAny($query, $columns, $keyword, $boolean);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -329,39 +487,37 @@ class DatabaseFulltextEngine extends Engine
|
||||
* @param Builder $builder Scout 빌더
|
||||
* @param int|null $perPage 페이지당 결과 수
|
||||
* @param int|null $page 페이지 번호
|
||||
* @return array{query: \Illuminate\Database\Eloquent\Builder, total: int}
|
||||
* @param bool $withTotal 총 건수를 계산할지 여부 (쓰지 않는 경로에서는 false)
|
||||
* @param bool $keysOnly 키 컬럼과 정렬용 스코어만 조회할지 여부
|
||||
* @return array{query: \Illuminate\Database\Eloquent\Builder|null, total: int|null, total_relation: TotalRelation|null, result_cap: int|null}
|
||||
*/
|
||||
protected function performSearch(Builder $builder, ?int $perPage = null, ?int $page = null): array
|
||||
{
|
||||
protected function performSearch(
|
||||
Builder $builder,
|
||||
?int $perPage = null,
|
||||
?int $page = null,
|
||||
bool $withTotal = true,
|
||||
bool $keysOnly = false
|
||||
): array {
|
||||
$model = $builder->model;
|
||||
$keyword = $builder->query;
|
||||
|
||||
// 빈 검색어인 경우 빈 결과 반환
|
||||
if (empty(trim($keyword))) {
|
||||
return [
|
||||
'query' => null,
|
||||
'total' => 0,
|
||||
];
|
||||
return self::emptyResult();
|
||||
}
|
||||
|
||||
$query = $model->newQuery();
|
||||
|
||||
// FulltextSearchable 인터페이스 구현 확인
|
||||
if (! ($model instanceof FulltextSearchable)) {
|
||||
return [
|
||||
'query' => null,
|
||||
'total' => 0,
|
||||
];
|
||||
return self::emptyResult();
|
||||
}
|
||||
|
||||
$columns = $model->searchableColumns();
|
||||
$weights = $model->searchableWeights();
|
||||
|
||||
if (empty($columns)) {
|
||||
return [
|
||||
'query' => null,
|
||||
'total' => 0,
|
||||
];
|
||||
return self::emptyResult();
|
||||
}
|
||||
|
||||
$useFulltext = static::supportsFulltext();
|
||||
@@ -375,10 +531,7 @@ class DatabaseFulltextEngine extends Engine
|
||||
$ftKeyword = static::sanitizeBooleanModeKeyword($keyword);
|
||||
if ($ftKeyword === '') {
|
||||
// 연산자만 입력 → 500 대신 빈 결과 (빈 검색어와 동일 반환 형태)
|
||||
return [
|
||||
'query' => null,
|
||||
'total' => 0,
|
||||
];
|
||||
return self::emptyResult();
|
||||
}
|
||||
|
||||
// MATCH...AGAINST WHERE 조건 생성 (MySQL, MariaDB)
|
||||
@@ -399,7 +552,7 @@ class DatabaseFulltextEngine extends Engine
|
||||
$scoreBindings[] = $ftKeyword;
|
||||
}
|
||||
$scoreRaw = '('.implode(' + ', $scoreExpressions).') as _ft_score';
|
||||
$query->selectRaw($qualifiedTable.'.*, '.$scoreRaw, $scoreBindings);
|
||||
$this->applySelect($query, $model, $qualifiedTable, $scoreRaw, $scoreBindings, $keysOnly);
|
||||
} else {
|
||||
// LIKE fallback (PostgreSQL, SQLite 등)
|
||||
$query->where(function ($q) use ($columns, $keyword) {
|
||||
@@ -409,7 +562,7 @@ class DatabaseFulltextEngine extends Engine
|
||||
});
|
||||
|
||||
// 스코어 고정 0 (관련성 순위 불가)
|
||||
$query->selectRaw($qualifiedTable.'.*, 0 as _ft_score');
|
||||
$this->applySelect($query, $model, $qualifiedTable, '0 as _ft_score', [], $keysOnly);
|
||||
}
|
||||
|
||||
// Scout Builder 콜백 적용 (추가 where 조건 등)
|
||||
@@ -459,8 +612,16 @@ class DatabaseFulltextEngine extends Engine
|
||||
$query->orderByDesc('_ft_score');
|
||||
}
|
||||
|
||||
// 전체 건수 계산 (페이지네이션 전)
|
||||
$total = $query->toBase()->getCountForPagination();
|
||||
// 전체 건수 계산 (페이지네이션 전).
|
||||
// 총 건수를 쓰지 않는 경로에서는 아예 세지 않는다 — 대용량 매칭에서 COUNT 한 번이
|
||||
// 조회 본체보다 비쌀 수 있다.
|
||||
$resultCap = PaginationLimits::resultCap('search');
|
||||
$total = null;
|
||||
$relation = null;
|
||||
|
||||
if ($withTotal) {
|
||||
[$total, $relation] = BoundedPaginator::countWithCap($query, $resultCap);
|
||||
}
|
||||
|
||||
// 페이지네이션 적용
|
||||
if ($perPage !== null) {
|
||||
@@ -468,11 +629,62 @@ class DatabaseFulltextEngine extends Engine
|
||||
$query->limit($perPage)->offset($offset);
|
||||
} elseif ($builder->limit !== null) {
|
||||
$query->limit($builder->limit);
|
||||
} elseif ($resultCap !== null) {
|
||||
// perPage 도 limit 도 없으면 LIMIT 이 아예 붙지 않아 매칭 전량을 PHP 로 끌어온다.
|
||||
// 상한을 걸어 한 요청이 읽는 행 수에 천장을 둔다.
|
||||
$query->limit($resultCap);
|
||||
}
|
||||
|
||||
return [
|
||||
'query' => $query,
|
||||
'total' => $total,
|
||||
'total_relation' => $relation,
|
||||
'result_cap' => $resultCap,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 조회 컬럼을 적용합니다.
|
||||
*
|
||||
* 키만 필요한 경로에서는 키 컬럼과 정렬용 스코어로 좁힙니다. 스코어는 `ORDER BY` 가
|
||||
* 참조하므로 좁힐 때도 함께 남겨야 합니다.
|
||||
*
|
||||
* @param \Illuminate\Database\Eloquent\Builder $query 대상 쿼리
|
||||
* @param Model $model 기준 모델
|
||||
* @param string $qualifiedTable 프리픽스 포함 테이블명
|
||||
* @param string $scoreRaw 스코어 SELECT 표현식 (`... as _ft_score`)
|
||||
* @param array<int, mixed> $scoreBindings 스코어 표현식 바인딩
|
||||
* @param bool $keysOnly 키 컬럼만 조회할지 여부
|
||||
*/
|
||||
protected function applySelect(
|
||||
$query,
|
||||
Model $model,
|
||||
string $qualifiedTable,
|
||||
string $scoreRaw,
|
||||
array $scoreBindings,
|
||||
bool $keysOnly
|
||||
): void {
|
||||
if ($keysOnly) {
|
||||
$query->select($model->getQualifiedKeyName())->selectRaw($scoreRaw, $scoreBindings);
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
$query->selectRaw($qualifiedTable.'.*, '.$scoreRaw, $scoreBindings);
|
||||
}
|
||||
|
||||
/**
|
||||
* 검색이 성립하지 않을 때의 빈 결과 형태를 반환합니다.
|
||||
*
|
||||
* @return array{query: null, total: int, total_relation: TotalRelation, result_cap: null}
|
||||
*/
|
||||
protected static function emptyResult(): array
|
||||
{
|
||||
return [
|
||||
'query' => null,
|
||||
'total' => 0,
|
||||
'total_relation' => TotalRelation::Exact,
|
||||
'result_cap' => null,
|
||||
];
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user