HeuJung
2ae1972a3b
공개 이슈 gnuboard/g7 이 지목한 병목은 "같은 일을 반복 실행한다" 축이다. 응답·행의 무게를 다룬 · 과 겹치지 않는다. 공통 계약 — 총 건수 상한과 페이지 이동 범위는 별개 결정이다. 묶으면 필요 없이 기능이 깎인다. 총 건수만 상한을 받고(파생 테이블 COUNT), "다음" 이동은 per_page + 1 실측으로 끝까지 열어 둔다. 계산이 불가능해지는 것은 마지막 페이지 번호 하나뿐이며 그 사실은 last_page: null 이 알린다. 최신순처럼 실제 컬럼으로 정렬하는 목록은 커서로 전환해 깊이와 무관하게 일정 속도로 이동한다. 관련도순은 계산값 정렬이라 커서 키로 쓸 수 없어 offset 을 유지한다. 계약의 입구는 표준 paginate 와 같은 폭이어야 한다. 관계·쿼리 빌더를 받지 못하면 그 좁은 만큼이 그대로 운영 500 이 되고, 실제로 관리자 알림 목록에서 그렇게 터졌다. 응답 조립도 컬렉션마다 손으로 하면 형태가 늘어나는 순간 없는 값을 부르거나 새 필드를 흘리므로, 형태 판정을 paginationMeta 한 곳에 모았다. 표준 paginate 응답은 필드 단위로 이전과 동일하다. 요청당 반복 비용 — 훅 구독마다 남기던 로그 400줄, 요청당 스무 번 넘던 설정 파일 재읽기, 이미 캐시된 목록의 DB 재조회를 없앴다. 권한 판정은 요청 스코프 메모를 두어 화면 요소마다 나가던 조회를 한 번으로 줄였고, 크로스 요청 캐시는 두지 않아 권한 변경이 종전처럼 다음 요청에 반영된다. 검색 질의는 활성 엔진이 만든다. 저장소가 구체 엔진을 지목하면 플러그인이 등록한 엔진은 호출될 기회 자체를 잃고 오류 없이 다른 방식으로 동작한다. 해석기를 두어 활성 엔진에 위임하고, 전문검색이 없는 DBMS 의 부분일치 폴백도 드라이버명 하드코딩 대신 선언형 config 로 옮겼다. 총 건수가 잘린 목록에서 순번을 역산하면 0 과 음수가 나온다. 지어내지 않고 null 을 돌려주며, 그 원칙을 last_page 와 동일하게 적용했다.
69 lines
3.1 KiB
PHP
69 lines
3.1 KiB
PHP
<?php
|
|
|
|
namespace App\Search;
|
|
|
|
use App\Support\Query\KeysetPaginator;
|
|
|
|
/**
|
|
* 검색 목록이 커서(키셋)로 응답할 수 있는지 판정하는 단일 지점
|
|
*
|
|
* 이 판정을 도메인마다 각자 구현하면 같은 규칙이 검색 모듈 수만큼 복제되고, 한 곳만
|
|
* 고치면 다른 도메인은 조용히 옛 규칙으로 남는다. 코어가 규칙을 소유하고, 확장은
|
|
* "내 정렬 이름이 어떤 실제 컬럼인가" 만 선언한다.
|
|
*
|
|
* 커서는 정렬 키를 WHERE 절 경계로 삼으므로 정렬 키가 전부 실제 컬럼이어야 한다.
|
|
* 관련도순처럼 계산값(FULLTEXT 점수)으로 정렬하는 경우에는 쓸 수 없고 offset 을 유지한다.
|
|
*/
|
|
final class SearchPagePolicy
|
|
{
|
|
/**
|
|
* 이 요청을 커서로 응답할지 판정합니다.
|
|
*
|
|
* 커서를 받은 요청만 커서로 처리하면 첫 커서가 만들어질 자리가 없다. 서버는 커서
|
|
* 모드에서만 다음 커서를 내보내므로, 화면은 건넬 커서가 없어 영원히 offset 에 머문다.
|
|
* 첫 페이지에 커서가 없는 것은 정상이므로 "커서 없음" 이 아니라 "시작점" 으로 읽는다.
|
|
*
|
|
* 다만 커서 없이 깊은 페이지를 직접 지목한 요청(주소로 열어 둔 딥링크·북마크)은
|
|
* 그 페이지를 그대로 보여줘야 한다. 커서로 바꾸면 첫 페이지로 되돌아가 링크가
|
|
* 가리키던 자리를 잃으므로, 그 경우에만 offset 을 유지한다.
|
|
*
|
|
* @param string|null $cursor 요청이 보낸 커서 (첫 페이지면 없음)
|
|
* @param array<int, array{0: string, 1: string}> $sortKeys [[컬럼, 방향], ...]
|
|
* @param array<int, string> $cursorColumns 이 도메인에서 커서로 허용한 실제 컬럼
|
|
* @param int $page 요청이 지목한 페이지 번호 (없으면 1)
|
|
* @return bool 커서로 응답할 수 있으면 true
|
|
*/
|
|
public static function usesCursor(?string $cursor, array $sortKeys, array $cursorColumns, int $page = 1): bool
|
|
{
|
|
if (! KeysetPaginator::supports($sortKeys, $cursorColumns)) {
|
|
return false;
|
|
}
|
|
|
|
if ($cursor !== null && $cursor !== '') {
|
|
return true;
|
|
}
|
|
|
|
return $page <= 1;
|
|
}
|
|
|
|
/**
|
|
* 정렬 이름을 정렬 키 배열로 바꿉니다.
|
|
*
|
|
* 확장이 선언한 `정렬이름 => [컬럼, 방향]` 맵을 코어가 해석합니다. 맵에 없는 이름은
|
|
* 커서로 처리할 수 없는 정렬(관련도순 등)로 보고 빈 배열을 돌려주며,
|
|
* {@see self::usesCursor()} 가 이를 "커서 불가" 로 판정합니다.
|
|
*
|
|
* @param string $sort 요청이 보낸 정렬 이름
|
|
* @param array<string, array{0: string, 1: string}> $sortMap 정렬 이름 → [컬럼, 방향]
|
|
* @return array<int, array{0: string, 1: string}> 정렬 키 배열 (해석 불가 시 빈 배열)
|
|
*/
|
|
public static function sortKeys(string $sort, array $sortMap): array
|
|
{
|
|
if (! array_key_exists($sort, $sortMap)) {
|
|
return [];
|
|
}
|
|
|
|
return [$sortMap[$sort]];
|
|
}
|
|
}
|