Ver2.0 드루팔 Search API 마스터하기: 초보자도 쉽게 따라하는 고급 검색 기능 구현 가이드 🔍

드루팔 Search API 마스터하기: 초보자도 쉽게 따라하는 고급 검색 기능 구현 가이드 🔍
안녕? 오늘은 드루팔에서 정말 강력한 기능 중 하나인 Search API에 대해 함께 알아볼 거야! 🚀 웹사이트에 멋진 검색 기능을 추가하고 싶은데 어디서부터 시작해야 할지 모르겠다고? 걱정 마! 이 글에서는 초보자도 쉽게 따라할 수 있도록 단계별로 설명해 줄게. 드루팔의 Search API를 활용해서 사용자 경험을 한층 업그레이드해보자!
📚 목차
- 드루팔 Search API란 무엇인가?
- Search API 설치 및 기본 설정
- 검색 인덱스 생성 및 관리하기
- 고급 검색 필터 구현하기
- 검색 결과 커스터마이징
- Facet API로 검색 필터링 강화하기
- 검색 성능 최적화 팁
- 실전 사례: 복잡한 검색 시나리오 해결하기
- Search API와 Views 통합하기
- 마무리 및 추가 자료
1. 드루팔 Search API란 무엇인가? 🤔
드루팔의 Search API는 웹사이트에 강력한 검색 기능을 추가할 수 있게 해주는 모듈이야. 기본 검색 기능보다 훨씬 더 많은 옵션과 유연성을 제공하지. 사실 드루팔 코어에 내장된 기본 검색 기능은 간단한 사이트에는 충분할 수 있지만, 복잡한 콘텐츠 구조나 대량의 데이터를 다루는 사이트에서는 한계가 있어.
Search API는 이런 한계를 뛰어넘어 다양한 검색 백엔드(Solr, Elasticsearch 등)와 연동할 수 있고, 복잡한 쿼리와 필터링, 패싯 검색 등을 지원해. 마치 구글이나 네이버 같은 검색 엔진처럼 정교한 검색 기능을 내 사이트에 구현할 수 있다고 생각하면 돼! 😎
Search API의 주요 특징
- 다양한 검색 백엔드 지원 (Database Search, Solr, Elasticsearch)
- 복잡한 검색 쿼리 및 필터링 기능
- 검색 결과 정렬 및 페이징 옵션
- 패싯(Facet) 검색 지원
- 검색 인덱스 자동 업데이트
- Views 모듈과의 완벽한 통합
- REST API를 통한 헤드리스 검색 기능
재능넷과 같은 재능 공유 플랫폼에서는 사용자들이 원하는 서비스나 재능을 빠르게 찾을 수 있도록 검색 기능이 매우 중요해. Search API를 활용하면 카테고리별, 가격대별, 인기도별로 재능을 필터링하는 기능을 쉽게 구현할 수 있지! 🎯
2. Search API 설치 및 기본 설정 ⚙️
자, 이제 실제로 Search API를 설치하고 기본 설정을 해보자! 생각보다 어렵지 않으니 따라와봐!
2.1 필요한 모듈 설치하기
먼저 Composer를 사용해서 필요한 모듈들을 설치할게. 터미널을 열고 드루팔 루트 디렉토리에서 다음 명령어를 실행해봐:
composer require drupal/search_api
composer require drupal/search_api_db
여기서 search_api는 코어 모듈이고, search_api_db는 데이터베이스 백엔드를 제공하는 모듈이야. 더 고급 기능을 원한다면 Solr이나 Elasticsearch 백엔드도 설치할 수 있어:
composer require drupal/search_api_solr
# 또는
composer require drupal/elasticsearch_connector
2.2 모듈 활성화하기
이제 Drush를 사용하거나 관리자 UI를 통해 모듈을 활성화해보자:
drush en search_api search_api_db -y
또는 관리자 페이지(/admin/modules)에서 모듈을 찾아 체크박스를 선택하고 '모듈 설치' 버튼을 클릭해도 돼.
🔔 참고: 대규모 사이트를 운영 중이라면 Solr이나 Elasticsearch 같은 전용 검색 엔진을 사용하는 것이 좋아. 데이터베이스 검색은 소규모 사이트에서는 잘 작동하지만, 콘텐츠가 많아지면 성능 이슈가 발생할 수 있어.
2.3 검색 서버 설정하기
모듈을 활성화했다면, 이제 검색 서버를 설정해보자:
- 관리자 메뉴에서
구성 > 검색 및 메타데이터 > Search API로 이동해. - '서버 추가' 버튼을 클릭해.
- 서버 이름(예: '내 검색 서버')을 입력하고, 백엔드로 'Database'를 선택해.
- '저장' 버튼을 클릭해.
2.4 검색 인덱스 생성하기
서버를 설정했으니 이제 검색 인덱스를 만들어보자:
- Search API 관리 페이지에서 '인덱스 추가' 버튼을 클릭해.
- 인덱스 이름(예: '콘텐츠 검색')을 입력해.
- 데이터 소스로 'Content'를 선택해.
- 서버로 방금 만든 '내 검색 서버'를 선택해.
- '저장' 버튼을 클릭해.
축하해! 🎉 이제 기본적인 Search API 설정이 완료됐어. 다음 단계에서는 인덱스를 더 세부적으로 구성하고 필드를 추가하는 방법을 알아볼 거야.
3. 검색 인덱스 생성 및 관리하기 📊
검색 인덱스는 Search API의 핵심이야. 인덱스는 어떤 데이터를 검색할 수 있게 할지, 어떤 필드를 포함할지 정의하는 곳이지. 이제 인덱스를 더 세부적으로 구성해보자!
3.1 필드 추가하기
인덱스를 생성한 후에는 어떤 필드를 검색 가능하게 할지 선택해야 해:
- 생성한 인덱스의 '필드' 탭으로 이동해.
- '필드 추가' 버튼을 클릭해.
- 검색하고 싶은 필드들을 선택해 (예: 제목, 본문, 태그 등).
- 각 필드의 타입과 부스트 값(검색 결과에서의 중요도)을 설정해.
- '저장' 버튼을 클릭해.
💡 프로 팁: 제목 필드에는 높은 부스트 값(예: 5.0)을 주면 제목에 검색어가 포함된 결과가 더 상위에 표시돼. 이렇게 하면 사용자가 찾고자 하는 내용을 더 빨리 찾을 수 있어!
3.2 프로세서 설정하기
프로세서는 검색 데이터를 인덱싱하거나 검색할 때 적용되는 처리 단계야. 다음과 같은 유용한 프로세서들이 있어:
- HTML 필터: HTML 태그를 제거하고 순수 텍스트만 인덱싱
- 토큰화: 텍스트를 개별 단어로 분리
- 불용어 제거: '그리고', '또는' 같은 일반적인 단어 제거
- 스테밍: 단어의 어근 형태로 변환 (예: '달리기', '달렸다' → '달리')
- 트랜슬리터레이션: 특수 문자나 다른 언어의 문자를 변환
프로세서를 설정하려면:
- 인덱스의 '프로세서' 탭으로 이동해.
- 필요한 프로세서를 활성화하고 순서를 조정해.
- '저장' 버튼을 클릭해.
3.3 인덱스 업데이트 설정
인덱스가 얼마나 자주 업데이트될지 설정할 수 있어:
- 인덱스의 '설정' 탭으로 이동해.
- '인덱싱 옵션'에서 업데이트 주기를 설정해.
- 콘텐츠가 생성, 수정, 삭제될 때 자동으로 인덱스를 업데이트할지 선택해.
- '저장' 버튼을 클릭해.
3.4 인덱스 채우기
모든 설정이 완료되면 인덱스를 데이터로 채워야 해:
- 인덱스 페이지에서 '인덱스 지금 채우기' 버튼을 클릭해.
- 인덱싱 프로세스가 완료될 때까지 기다려.
대량의 콘텐츠가 있는 경우 Drush를 사용하면 더 효율적으로 인덱싱할 수 있어:
drush search-api:index 콘텐츠_검색
이제 기본적인 검색 인덱스 설정이 완료됐어! 다음으로 더 고급 검색 필터를 구현하는 방법을 알아보자. 🚀
4. 고급 검색 필터 구현하기 🔍
단순한 키워드 검색을 넘어서 사용자들에게 더 정확한 검색 결과를 제공하려면 고급 필터가 필요해. 이번에는 다양한 필터 옵션을 구현하는 방법을 알아볼게!
4.1 필터 타입 이해하기
Search API에서는 다양한 필터 타입을 제공해:
- 전체 텍스트 필터: 키워드 검색에 사용
- 필드 필터: 특정 필드의 값으로 필터링
- 범위 필터: 숫자나 날짜 범위로 필터링
- 지리적 필터: 위치 기반 필터링
- 복합 필터: AND/OR 조건으로 여러 필터 조합
4.2 Views를 사용한 필터 구현
가장 쉬운 방법은 Views 모듈을 사용해서 검색 필터를 구현하는 거야:
- 관리자 메뉴에서
구조 > Views로 이동해. - 'View 추가' 버튼을 클릭해.
- View 이름을 입력하고, 'Show' 드롭다운에서 방금 만든 Search API 인덱스를 선택해.
- '계속 & 편집' 버튼을 클릭해.
- '필터 기준' 섹션에서 '필터 추가' 버튼을 클릭해.
- 원하는 필터를 선택하고 설정해.
- '노출된 폼' 섹션에서 '노출' 체크박스를 선택해 사용자에게 필터를 표시해.
🌟 예시: 재능넷에서의 고급 검색 필터
재능넷 같은 재능 공유 플랫폼에서는 다음과 같은 필터가 유용할 수 있어:
- 카테고리 필터: 디자인, 개발, 마케팅 등 재능 카테고리로 필터링
- 가격 범위 필터: 최소/최대 가격으로 재능 검색
- 평점 필터: 4.5점 이상 등 특정 평점 이상의 재능만 표시
- 지역 필터: 특정 지역에서 제공되는 오프라인 재능 검색
- 소요 시간 필터: 작업 완료 예상 시간으로 필터링
이런 필터들을 조합하면 사용자들이 자신에게 딱 맞는 재능을 빠르게 찾을 수 있어!
4.3 프로그래매틱 필터 구현
더 복잡한 필터링이 필요하다면 코드를 사용해 직접 구현할 수도 있어. 다음은 간단한 예시야:
use Drupal\search_api\Query\Query;
use Drupal\search_api\Query\Condition;
// 인덱스 가져오기
$index = \Drupal::entityTypeManager()->getStorage('search_api_index')->load('content_index');
// 쿼리 생성
$query = $index->query();
// 키워드 검색 추가
$query->keys('드루팔');
// 필드 필터 추가
$query->addCondition('field_category', 'web_development');
// 범위 필터 추가
$query->addCondition('field_price', [10, 100], 'BETWEEN');
// 복합 필터 추가 (OR 조건)
$or_group = $query->createConditionGroup('OR');
$or_group->addCondition('field_tags', 'drupal');
$or_group->addCondition('field_tags', 'php');
$query->addConditionGroup($or_group);
// 정렬 추가
$query->sort('field_created', 'DESC');
// 페이징 설정
$query->range(0, 10);
// 쿼리 실행
$results = $query->execute();
이렇게 코드로 구현하면 UI로는 불가능한 복잡한 필터링도 가능해져. 특히 동적으로 필터를 변경해야 하는 경우에 유용하지!
4.4 AJAX 필터 구현하기
사용자 경험을 향상시키려면 페이지 새로고침 없이 필터가 적용되는 AJAX 필터를 구현하는 것이 좋아:
- Views 설정에서 'AJAX 사용' 옵션을 활성화해.
- 노출된 필터 설정에서 '자동 제출' 옵션을 선택해.
이제 사용자가 필터를 변경할 때마다 페이지 새로고침 없이 결과가 업데이트될 거야! 🚀
5. 검색 결과 커스터마이징 ✨
검색 기능을 구현했다면, 이제 검색 결과를 어떻게 표시할지 커스터마이징해보자. 잘 디자인된 검색 결과는 사용자 경험을 크게 향상시킬 수 있어!
5.1 Views를 사용한 결과 디스플레이 설정
Views를 사용하면 검색 결과 표시 방식을 쉽게 커스터마이징할 수 있어:
- Views 편집 페이지에서 '포맷' 섹션을 확인해.
- '포맷' 드롭다운에서 원하는 표시 형식을 선택해 (테이블, 목록, 그리드 등).
- '필드' 섹션에서 '필드 추가' 버튼을 클릭해 표시할 필드를 선택해.
- 각 필드의 설정을 클릭해 레이블, 포맷, 링크 등을 커스터마이징해.
💡 디자인 팁: 검색 결과에는 항상 관련성을 보여주는 시각적 요소를 포함하는 것이 좋아. 예를 들어, 검색어가 포함된 부분을 하이라이트하거나, 관련성 점수를 별점으로 표시할 수 있어.
5.2 검색 결과 하이라이팅
검색 결과에서 검색어를 하이라이트하면 사용자가 왜 이 결과가 표시되었는지 빠르게 이해할 수 있어:
- 인덱스의 '프로세서' 탭으로 이동해.
- 'Highlight' 프로세서를 활성화해.
- 하이라이트할 필드와 하이라이트 접두사/접미사(예:
<strong>,</strong>)를 설정해. - '저장' 버튼을 클릭해.
또는 Views에서 직접 하이라이트를 구현할 수도 있어:
function mymodule_views_pre_render(\Drupal\views\ViewExecutable $view) {
if ($view->id() == 'my_search_view') {
$search_term = \Drupal::request()->query->get('search_api_fulltext');
if ($search_term) {
foreach ($view->result as $row) {
if (isset($row->_entity)) {
$body = $row->_entity->get('body')->value;
$highlighted = str_replace(
$search_term,
'<span class="highlight">' . $search_term . '</span>',
$body
);
$row->_entity->get('body')->value = $highlighted;
}
}
}
}
}
5.3 결과 그룹화하기
검색 결과를 카테고리나 타입별로 그룹화하면 사용자가 정보를 더 쉽게 찾을 수 있어:
- Views 편집 페이지에서 '그룹화 필드 추가' 버튼을 클릭해.
- 그룹화할 필드(예: 콘텐츠 타입, 카테고리)를 선택해.
- 그룹 헤더 형식을 설정해.
5.4 결과 정렬 옵션 제공하기
사용자가 검색 결과를 자신의 선호도에 따라 정렬할 수 있게 하면 좋아:
- Views 편집 페이지에서 '정렬 기준' 섹션으로 이동해.
- '정렬 기준 추가' 버튼을 클릭해.
- 정렬할 필드(예: 날짜, 관련성, 제목)를 선택해.
- '노출' 체크박스를 선택해 사용자에게 정렬 옵션을 표시해.
5.5 무한 스크롤 또는 페이징 구현
검색 결과가 많을 때는 적절한 페이징이 중요해:
- Views 편집 페이지에서 '페이저' 섹션으로 이동해.
- '페이저 사용' 옵션을 선택해.
- 페이지당 항목 수와 페이저 유형(전체 페이저, 미니 페이저, 더 보기 버튼 등)을 설정해.
무한 스크롤을 구현하려면 추가 JavaScript가 필요해:
(function ($, Drupal) {
Drupal.behaviors.infiniteScroll = {
attach: function (context, settings) {
var $view = $('.view-id-my_search_view', context);
var $content = $('.view-content', $view);
var pager = $('.pager__item--next a', $view);
$(window).once('infinite-scroll').scroll(function () {
if ($(window).scrollTop() + $(window).height() > $content.offset().top + $content.height() - 100) {
if (pager.length) {
pager.click();
}
}
});
}
};
})(jQuery, Drupal);
잘 디자인된 검색 결과는 사용자 경험의 핵심이야! 다음으로는 더 강력한 필터링을 위한 Facet API 사용법을 알아볼게. 🎨
6. Facet API로 검색 필터링 강화하기 🧩
Facet API는 검색 결과를 다양한 기준으로 필터링할 수 있는 강력한 도구야. 쇼핑몰에서 제품을 카테고리, 브랜드, 가격대 등으로 필터링하는 것과 비슷해. 이제 Facet API를 사용해서 검색 경험을 한 단계 업그레이드해보자!
6.1 Facet API 모듈 설치하기
먼저 필요한 모듈을 설치해야 해:
composer require drupal/facets
drush en facets -y
6.2 Facet 소스 설정하기
Facet를 사용하려면 먼저 Facet 소스를 설정해야 해:
- 관리자 메뉴에서
구성 > 검색 및 메타데이터 > Facets로 이동해. - 'Facet 소스 추가' 버튼을 클릭해.
- Search API 인덱스를 사용하는 Views 디스플레이를 선택해.
- '저장' 버튼을 클릭해.
6.3 Facet 생성하기
이제 실제 Facet를 생성해보자:
- Facets 관리 페이지에서 'Facet 추가' 버튼을 클릭해.
- Facet 이름을 입력하고 필드(예: 콘텐츠 타입, 태그, 카테고리 등)를 선택해.
- Facet 소스로 방금 만든 소스를 선택해.
- '저장' 버튼을 클릭해.
🌟 Facet 유형 예시
다양한 유형의 Facet를 만들 수 있어:
- 체크박스 Facet: 여러 옵션을 동시에 선택 가능
- 라디오 버튼 Facet: 한 번에 하나의 옵션만 선택 가능
- 드롭다운 Facet: 공간을 절약하면서 많은 옵션 제공
- 범위 슬라이더 Facet: 숫자나 날짜 범위 선택
- 계층적 Facet: 카테고리/서브카테고리 구조 표현
6.4 Facet 디스플레이 설정하기
Facet의 표시 방식을 커스터마이징할 수 있어:
- Facet 편집 페이지에서 '디스플레이' 탭으로 이동해.
- 위젯 유형(링크, 체크박스, 드롭다운 등)을 선택해.
- 정렬 방식(알파벳순, 카운트순 등)을 설정해.
- 표시할 항목 수를 제한할 수 있어.
- '저장' 버튼을 클릭해.
6.5 Facet 배치하기
생성한 Facet를 페이지에 배치해보자:
- 관리자 메뉴에서
구조 > 블록 레이아웃으로 이동해. - '블록 배치' 버튼을 클릭해.
- Facet 블록을 찾아 원하는 영역(예: 사이드바)에 배치해.
- 블록 설정에서 Facet가 표시될 페이지를 제한할 수 있어.
- '블록 배치 저장' 버튼을 클릭해.
6.6 Facet 동작 방식 설정하기
Facet의 동작 방식을 세부적으로 설정할 수 있어:
- Facet 편집 페이지에서 'Facet 설정' 탭으로 이동해.
- URL 처리 방식(쿼리 파라미터, 경로 등)을 선택해.
- 빈 Facet 동작(표시 또는 숨김)을 설정해.
- 다중 선택 동작(AND/OR)을 설정해.
- '저장' 버튼을 클릭해.
💡 프로 팁: Facet 결과가 0인 항목은 기본적으로 숨겨지지만, 표시하도록 설정할 수도 있어. 이렇게 하면 사용자가 현재 선택한 필터로는 결과가 없는 옵션을 확인할 수 있어 더 나은 탐색 경험을 제공할 수 있지!
Facet API를 활용하면 사용자들이 원하는 정보를 더 쉽게 찾을 수 있어! 특히 대량의 콘텐츠가 있는 사이트에서는 필수적인 기능이지. 다음으로는 검색 성능을 최적화하는 방법을 알아볼게. 🚀
7. 검색 성능 최적화 팁 ⚡
아무리 기능이 훌륭해도 검색이 느리면 사용자들은 불만을 느끼게 돼. 이번에는 Search API의 성능을 최적화하는 방법을 알아볼게!
7.1 적절한 백엔드 선택하기
사이트 규모에 맞는 검색 백엔드를 선택하는 것이 중요해:
- Database Search: 소규모 사이트(콘텐츠 1,000개 미만)에 적합
- Solr: 중대규모 사이트에 적합, 고급 검색 기능 제공
- Elasticsearch: 대규모 사이트와 복잡한 검색 요구사항에 적합
백엔드 비교
Database Search:
- 장점: 설치 간편, 추가 서버 불필요
- 단점: 대량 데이터 처리 시 성능 저하, 고급 검색 기능 제한적
Solr:
- 장점: 뛰어난 성능, 풍부한 검색 기능, 확장성
- 단점: 별도 서버 설정 필요, 관리 복잡성
Elasticsearch:
- 장점: 분산 아키텍처, 실시간 분석, 강력한 쿼리 언어
- 단점: 리소스 요구사항 높음, 설정 복잡
7.2 인덱스 최적화하기
검색 인덱스를 최적화하면 성능을 크게 향상시킬 수 있어:
- 필요한 필드만 인덱싱: 검색에 사용되지 않는 필드는 인덱싱하지 마.
- 적절한 토큰화 설정: 언어에 맞는 토큰화 설정을 사용해.
- 인덱스 크기 제한: 오래된 콘텐츠는 별도 인덱스로 분리하는 것을 고려해.
- 정기적인 인덱스 유지보수: cron을 사용해 정기적으로 인덱스를 최적화해.
Drush를 사용한 인덱스 최적화 명령어:
drush search-api:optimize-index content_index
7.3 캐싱 활용하기
캐싱을 활용하면 반복되는 검색 쿼리의 성능을 크게 향상시킬 수 있어:
- Views 결과 캐싱: Views 설정에서 쿼리 및 결과 캐싱을 활성화해.
- Facet 캐싱: Facet 설정에서 캐싱 옵션을 활성화해.
- 페이지 캐싱: 자주 방문되는 검색 결과 페이지는 페이지 캐싱을 고려해.
- Redis/Memcached: 대규모 사이트는 외부 캐시 시스템 사용을 고려해.
7.4 비동기 인덱싱 구현하기
대량의 콘텐츠가 있는 사이트에서는 비동기 인덱싱이 유용해:
// settings.php 파일에 추가
$settings['search_api_use_tracking_batch'] = TRUE;
또는 Queue API를 사용해 인덱싱 작업을 큐에 넣을 수도 있어:
// 모듈에서 구현
function mymodule_entity_update(Drupal\Core\Entity\EntityInterface $entity) {
if ($entity->getEntityTypeId() == 'node') {
$queue = \Drupal::queue('search_api_indexing');
$queue->createItem([
'entity_type' => 'node',
'entity_id' => $entity->id(),
'operation' => 'update',
]);
}
}
7.5 서버 리소스 최적화
서버 리소스를 최적화하면 전반적인 검색 성능이 향상돼:
- 메모리 할당: Solr/Elasticsearch에 충분한 메모리 할당
- JVM 튜닝: 검색 엔진의 JVM 설정 최적화
- 디스크 I/O: SSD 사용 고려
- 네트워크 지연시간: 검색 서버와 드루팔 서버 간 지연시간 최소화
⚠️ 주의: 대규모 인덱싱 작업은 서버에 부하를 줄 수 있어. 트래픽이 적은 시간대에 배치 작업으로 실행하는 것이 좋아!
성능 최적화는 지속적인 과정이야. 정기적으로 검색 성능을 모니터링하고 필요에 따라 설정을 조정하는 것이 중요해. 다음으로는 실제 복잡한 검색 시나리오를 해결하는 방법을 알아볼게! 🔧
8. 실전 사례: 복잡한 검색 시나리오 해결하기 🧪
이론은 충분히 배웠으니, 이제 실제 프로젝트에서 마주할 수 있는 복잡한 검색 시나리오를 해결하는 방법을 알아보자! 여기서는 몇 가지 실전 사례와 해결 방법을 소개할게.
8.1 다국어 검색 구현하기
글로벌 사이트를 운영한다면 다국어 검색은 필수적이야:
- 언어별 인덱스 생성 또는 언어 필드 추가
- 언어별 적절한 토큰화 및 스테밍 설정
- 현재 사용자 언어에 맞는 결과 필터링
다국어 검색을 위한 코드 예시:
// 현재 언어로 검색 결과 필터링
$query = $index->query();
$query->addCondition('langcode', \Drupal::languageManager()->getCurrentLanguage()->getId());
$query->keys($search_term);
// 또는 Solr을 사용하는 경우 언어별 필드 사용
$query = $index->query();
$language = \Drupal::languageManager()->getCurrentLanguage()->getId();
$query->setFulltextFields(["title_{$language}", "body_{$language}"]);
$query->keys($search_term);
8.2 지리적 검색 구현하기
위치 기반 서비스에서는 지리적 검색이 중요해:
- 위도/경도 필드 인덱싱
- 거리 기반 검색 및 정렬 구현
- 지도 인터페이스와 통합
지리적 검색 예시:
// 특정 위치에서 10km 이내의 결과 검색
$query = $index->query();
$query->addCondition('location', [
'lat' => 37.5665,
'lon' => 126.9780,
'radius' => 10,
], 'LOCATION');
$query->sort('location', [
'lat' => 37.5665,
'lon' => 126.9780,
], 'ASC'); // 가까운 순서대로 정렬
🌟 재능넷 활용 사례: 지역 기반 재능 검색
재능넷에서는 사용자의 현재 위치를 기반으로 가까운 오프라인 재능을 검색할 수 있어. 예를 들어, 사용자가 '강남구'에 있다면 근처에서 제공되는 '웹 개발' 재능을 쉽게 찾을 수 있지. 이는 Search API의 지리적 검색 기능을 활용해 구현할 수 있어!
8.3 자동완성 검색 구현하기
사용자 경험을 향상시키는 자동완성 검색을 구현해보자:
- 자동완성용 별도 인덱스 생성 (더 가벼운 구조)
- n-gram 토큰화 설정
- AJAX 요청 처리를 위한 API 엔드포인트 생성
자동완성 API 구현 예시:
// 자동완성 API 컨트롤러
namespace Drupal\mymodule\Controller;
use Drupal\Core\Controller\ControllerBase;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpFoundation\Request;
class AutocompleteController extends ControllerBase {
public function autocomplete(Request $request) {
$query = $request->query->get('q');
$index = \Drupal::entityTypeManager()->getStorage('search_api_index')->load('autocomplete_index');
$search_query = $index->query();
$search_query->keys($query);
$search_query->range(0, 10);
$results = $search_query->execute();
$suggestions = [];
foreach ($results->getResultItems() as $item) {
$entity = $item->getOriginalObject()->getValue();
$suggestions[] = [
'value' => $entity->label(),
'url' => $entity->toUrl()->toString(),
];
}
return new JsonResponse($suggestions);
}
}
프론트엔드 자동완성 구현:
(function ($, Drupal) {
Drupal.behaviors.searchAutocomplete = {
attach: function (context, settings) {
$('.search-autocomplete', context).once('autocomplete').each(function () {
var $input = $(this);
$input.autocomplete({
source: '/api/autocomplete',
minLength: 2,
select: function (event, ui) {
window.location.href = ui.item.url;
return false;
}
});
});
}
};
})(jQuery, Drupal);
8.4 개인화된 검색 결과 구현하기
사용자의 관심사나 행동 패턴에 따라 검색 결과를 개인화할 수 있어:
- 사용자 프로필 정보 및 검색 이력 수집
- 관심 카테고리나 태그에 가중치 부여
- 최근 본 콘텐츠와 유사한 항목 우선 표시
개인화된 검색 구현 예시:
// 사용자 관심사에 따른 부스트 적용
function mymodule_search_api_query_alter(\Drupal\search_api\Query\QueryInterface $query) {
$user = \Drupal::currentUser();
if ($user->isAuthenticated()) {
$user_entity = \Drupal\user\Entity\User::load($user->id());
// 사용자 관심 태그 가져오기
$interest_tags = $user_entity->get('field_interests')->getValue();
if (!empty($interest_tags)) {
// 관심 태그에 부스트 적용
foreach ($interest_tags as $tag) {
$query->addCondition('field_tags', $tag['target_id'], '=', 2.0); // 부스트 값 2.0
}
}
}
}
8.5 추천 검색어 및 "이것을 찾으셨나요?" 기능
검색 결과가 없거나 적을 때 추천 검색어를 제공하는 기능을 구현해보자:
- 유사 검색어 데이터베이스 구축
- 철자 오류 감지 및 수정
- 인기 검색어 추천
추천 검색어 구현 예시:
function mymodule_search_results_alter(&$build, $query) {
$results_count = $build['#search_results']['#total'];
if ($results_count == 0) {
$search_term = $query->getKeys();
// 유사 검색어 찾기
$similar_terms = find_similar_terms($search_term);
if (!empty($similar_terms)) {
$suggestions = [];
foreach ($similar_terms as $term) {
$suggestions[] = [
'#type' => 'link',
'#title' => $term,
'#url' => Url::fromRoute('search.view_search_api_page', [
'search_api_page' => 'default_search',
'keys' => $term,
]),
];
}
$build['suggestions'] = [
'#theme' => 'item_list',
'#title' => t('이것을 찾으셨나요?'),
'#items' => $suggestions,
'#weight' => -10,
];
}
}
}
이런 고급 검색 기능들은 사용자 경험을 크게 향상시킬 수 있어! 다음으로는 Search API와 Views를 통합하는 방법을 더 자세히 알아볼게. 🚀
9. Search API와 Views 통합하기 🔄
드루팔에서 Views 모듈은 데이터를 표시하는 강력한 도구야. Search API와 Views를 통합하면 더욱 유연하고 강력한 검색 인터페이스를 만들 수 있어. 이번에는 두 모듈을 효과적으로 통합하는 방법을 알아볼게!
9.1 Search API Views 디스플레이 생성하기
Search API 인덱스를 기반으로 Views를 생성해보자:
- 관리자 메뉴에서
구조 > Views로 이동해. - 'View 추가' 버튼을 클릭해.
- View 이름을 입력하고, 'Show' 드롭다운에서 Search API 인덱스를 선택해.
- 페이지 디스플레이 설정을 구성하고 '계속 & 편집' 버튼을 클릭해.
9.2 고급 필터 및 노출된 폼 설정
Views에서 노출된 필터를 설정하면 사용자가 직접 검색 조건을 조정할 수 있어:
- Views 편집 페이지에서 '필터 기준' 섹션으로 이동해.
- 필터를 추가하고 '노출' 체크박스를 선택해.
- '노출된 폼' 설정에서 필터 레이블, 연산자, 기본값 등을 설정해.
- 필터 그룹화 및 배치를 설정해.
예를 들어, 다음과 같은 필터를 노출할 수 있어:
- 전체 텍스트 검색 필드
- 콘텐츠 타입 선택 드롭다운
- 작성일 범위 선택
- 태그 또는 카테고리 선택
9.3 컨텍스트 필터 활용하기
컨텍스트 필터를 사용하면 URL 파라미터나 다른 컨텍스트 값을 기반으로 검색 결과를 필터링할 수 있어:
- Views 편집 페이지에서 '고급' 섹션을 확장해.
- '컨텍스트 필터 추가' 버튼을 클릭해.
- 필터링할 필드를 선택해.
- '값이 없을 때' 동작을 설정해.
컨텍스트 필터 사용 예시:
- 현재 사용자가 작성한 콘텐츠만 표시
- 특정 카테고리의 콘텐츠만 표시
- 현재 날짜 이후의 이벤트만 표시
9.4 관계 추가하기
관계를 추가하면 연관된 엔티티의 필드를 검색 결과에 포함시킬 수 있어:
- Views 편집 페이지에서 '고급' 섹션을 확장해.
- '관계 추가' 버튼을 클릭해.
- 추가할 관계(예: 작성자, 참조 필드)를 선택해.
- 관계 설정을 구성하고 '적용' 버튼을 클릭해.
관계 사용 예시:
- 콘텐츠 작성자의 프로필 정보 표시
- 참조된 텍소노미 용어의 설명 표시
- 제품 카테고리의 이미지 표시
💡 프로 팁: Views에서 AJAX를 활성화하면 페이지 새로고침 없이 필터가 적용돼. 이는 사용자 경험을 크게 향상시키고, 특히 복잡한 검색 폼에서 유용해!
9.5 Views REST Export 활용하기
Search API와 Views REST Export를 조합하면 강력한 검색 API를 만들 수 있어:
- Views에 REST Export 디스플레이를 추가해.
- 경로와 응답 형식(JSON, XML 등)을 설정해.
- 필요한 필드와 필터를 구성해.
이렇게 만든 API는 다음과 같은 용도로 활용할 수 있어:
- 모바일 앱에서 검색 기능 구현
- JavaScript 프레임워크(React, Vue 등)와 통합
- 외부 시스템에 검색 기능 제공
// JavaScript에서 Search API Views REST Export 호출 예시
fetch('/api/search?keys=드루팔&type=article')
.then(response => response.json())
.then(data => {
// 검색 결과 처리
data.forEach(item => {
console.log(item.title, item.url);
// 결과 표시 로직
});
});
Views와 Search API의 조합은 정말 강력해! 이 두 모듈을 잘 활용하면 거의 모든 검색 요구사항을 구현할 수 있어. 다음으로는 이 글의 내용을 정리하고 추가 자료를 소개할게. 🚀
10. 마무리 및 추가 자료 📚
드루팔 Search API에 대한 긴 여정이 거의 끝나가고 있어! 지금까지 우리는 Search API의 기본 개념부터 고급 기능까지 다양한 내용을 살펴봤어. 이제 이 지식을 활용해서 멋진 검색 기능을 구현할 수 있을 거야!
10.1 배운 내용 정리
이 글에서 다룬 주요 내용을 간략히 정리해볼게:
- Search API 기본 개념: 검색 서버, 인덱스, 필드, 프로세서 등
- 설치 및 기본 설정: 모듈 설치, 서버 및 인덱스 설정
- 인덱스 관리: 필드 추가, 프로세서 설정, 인덱스 업데이트
- 고급 검색 필터: 다양한 필터 타입, Views 및 코드를 통한 구현
- 검색 결과 커스터마이징: 결과 표시 방식, 하이라이팅, 그룹화
- Facet API: 패싯 검색 구현, 다양한 위젯 활용
- 성능 최적화: 백엔드 선택, 인덱스 최적화, 캐싱
- 실전 사례: 다국어 검색, 지리적 검색, 자동완성, 개인화
- Views 통합: 검색 인터페이스 구현, 필터 노출, REST API
🌟 핵심 포인트
Search API는 드루팔에서 강력한 검색 기능을 구현하기 위한 필수 모듈이야. 기본 검색부터 고급 검색 기능까지 거의 모든 검색 요구사항을 충족시킬 수 있어. 특히 Views와 Facet API를 함께 사용하면 사용자 친화적인 검색 인터페이스를 쉽게 만들 수 있지!
검색은 웹사이트 사용자 경험의 핵심 요소야. 잘 구현된 검색 기능은 사용자가 원하는 정보를 빠르게 찾을 수 있게 도와주고, 이는 사용자 만족도와 사이트 체류 시간을 높이는 데 큰 도움이 돼.
성능과 사용자 경험 사이의 균형을 맞추는 것이 중요해. 고급 기능을 많이 추가할수록 성능에 영향을 줄 수 있으니, 항상 실제 사용자의 니즈와 사이트 성능을 고려해서 기능을 구현해야 해!
10.2 추가 학습 자료
Search API에 대해 더 깊이 알고 싶다면 다음 자료들을 참고해봐:
- 공식 문서: Drupal.org의 Search API 모듈 페이지
- API 문서: Search API 클래스 및 메서드 참조
- 튜토리얼: Drupalize.me, Drupal Easy의 Search API 강좌
- 커뮤니티: Drupal Slack의 #search 채널, Drupal Answers
- 블로그: Acquia, Lullabot, Chapter Three의 Search API 관련 글
10.3 관련 모듈 탐색
Search API와 함께 사용하면 좋은 관련 모듈들이야:
- Search API Solr: Solr 검색 엔진 통합
- Elasticsearch Connector: Elasticsearch 검색 엔진 통합
- Search API Autocomplete: 자동완성 기능 제공
- Search API Pages: 검색 페이지 쉽게 생성
- Search API Saved Searches: 저장된 검색 기능
- Search API Attachments: 첨부 파일 내용 검색
- Search API Location: 위치 기반 검색 기능 강화
10.4 마치며
드루팔 Search API는 정말 강력하고 유연한 도구야. 이 글에서 다룬 내용은 시작에 불과하고, 실제로 구현할 수 있는 기능은 훨씬 더 많아. 재능넷과 같은 플랫폼에서는 사용자들이 원하는 재능을 쉽게 찾을 수 있도록 검색 기능을 최적화하는 것이 매우 중요하지. 검색 기능이 잘 구현된 사이트는 사용자 만족도가 높아지고, 결과적으로 플랫폼의 성공으로 이어질 수 있어! 🌟
이 글이 드루팔 Search API를 이해하고 활용하는 데 도움이 되었길 바라. 혹시 추가 질문이나 의견이 있다면 언제든지 댓글로 남겨줘. 함께 더 나은 검색 경험을 만들어 나가자! 😊
🚀 지금 바로 시작해보세요!
드루팔 Search API를 활용해 여러분의 웹사이트에 강력한 검색 기능을 추가해보세요. 사용자들이 원하는 정보를 더 쉽게 찾을 수 있도록 도와주세요!
재능넷에서는 다양한 웹 개발 전문가들이 드루팔 관련 서비스를 제공하고 있습니다. 전문적인 도움이 필요하시다면 재능넷을 방문해보세요!
관련 키워드
댓글 작성
이 글에 대한 여러분의 생각을 들려주세요
로그인이 필요합니다
댓글을 작성하려면 먼저 로그인해주세요.
댓글 0
지식인의 숲 - 지적 재산권 보호 고지
지적 재산권 보호 고지
- 저작권 및 소유권: 본 컨텐츠는 재능넷의 독점 AI 기술로 생성되었으며, 대한민국 저작권법 및 국제 저작권 협약에 의해 보호됩니다.
- AI 생성 컨텐츠의 법적 지위: 본 AI 생성 컨텐츠는 재능넷의 지적 창작물로 인정되며, 관련 법규에 따라 저작권 보호를 받습니다.
- 사용 제한: 재능넷의 명시적 서면 동의 없이 본 컨텐츠를 복제, 수정, 배포, 또는 상업적으로 활용하는 행위는 엄격히 금지됩니다.
- 데이터 수집 금지: 본 컨텐츠에 대한 무단 스크래핑, 크롤링, 및 자동화된 데이터 수집은 법적 제재의 대상이 됩니다.
- AI 학습 제한: 재능넷의 AI 생성 컨텐츠를 타 AI 모델 학습에 무단 사용하는 행위는 금지되며, 이는 지적 재산권 침해로 간주됩니다.
아직 댓글이 없습니다.