Scout를 사용한 전체 텍스트 검색

Scout 패키지 설치

애플리케이션 에서 Scout를 사용하려면 먼저 애플리케이션의 루트 디렉토리 에서 다음 명령을 실행 laravel/scout 패키지 설치합니다.

composer require laravel/scout

모델에 검색 가능 트레이트 추가

Eloquent 모델에 Laravel\Scout\Searchable 특성을 추가하여 검색 가능하게 만듭니다. 다음 예시 이 특성을 sample_mflix.movies 컬렉션 의 문서를 나타내는 Movie 모델에 추가합니다.

<?php
namespace App\Models;
use MongoDB\Laravel\Eloquent\Model;
use Laravel\Scout\Searchable;
class Movie extends Model
{
    use Searchable;
    protected $connection = 'mongodb';
}

Searchable 트레이트를 사용하여 문서의 서식을 다시 지정하거나, 관련 문서를 포함하거나, 문서 값을 변환할 수도 있습니다. 자세히 학습 Laravel Scout 문서의 검색 가능한 데이터 구성하기 섹션을 참조하세요.

애플리케이션 에서 Scout 구성

애플리케이션 이 데이터베이스 연결로 MongoDB 사용하도록 구성되어 있는지 확인합니다. MongoDB 구성하는 방법을 학습 빠른 시작 가이드 의 MongoDB 연결 구성 섹션을 참조하세요.

애플리케이션 에서 Scout를 구성하려면 애플리케이션의 config 디렉토리 에 scout.php 라는 파일 만듭니다. 파일 에 다음 코드를 붙여넣어 Scout를 구성합니다.

<?php
return [
    'driver' => env('SCOUT_DRIVER', 'mongodb'),
    'mongodb' => [
        'connection' => env('SCOUT_MONGODB_CONNECTION', 'mongodb'),
    ],
    'prefix' => env('SCOUT_PREFIX', 'scout_'),
];

앞의 코드는 다음 구성을 지정합니다.

• SCOUT_DRIVER 환경 변수의 값을 기본값 검색 운전자 로 사용하거나, 환경 변수가 설정하다 되지 않은 경우 mongodb 를 사용합니다.

• 검색 가능한 컬렉션 의 컬렉션 이름에 대한 접두사로 scout_ 를 지정합니다.

config/scout.php 파일 에서 사용자 지정 Atlas Search 인덱스 정의를 지정할 수도 있습니다. 자세히 학습 다음 단계의 사용자 지정 인덱스 정의 예시 참조하세요.

애플리케이션의 .env 파일 에서 다음 환경 변수를 설정하여 mongodb 을 기본값 검색 운전자 로 선택합니다.

SCOUT_DRIVER=mongodb

Atlas Search 인덱스 만들기

Scout를 구성하고 기본값 검색 운전자 설정하다 후 애플리케이션의 루트 디렉토리 에서 다음 명령을 실행 하여 검색 가능한 컬렉션 및 검색 인덱스 만들 수 있습니다.

php artisan scout:index 'App\Models\Movie'

MongoDB 기본값 검색 운전자 로 설정하다 때문에 앞의 명령은 MongoDB database 에 Atlas Search 인덱스 사용하여 검색 컬렉션 생성합니다. 컬렉션 이름은 이전 단계에서 설정하다 접두사에 따라 scout_movies으로 지정됩니다. Atlas Search 인덱스 이름은 scout 이며 기본값 으로 다음과 같은 구성을 갖습니다.

{
  "mappings": {
    "dynamic": true
  }
}

인덱스 정의를 사용자 지정하려면 config/scout.php 파일 의 mongodb 항목에 index-definitions 구성을 추가합니다. 다음 코드는 scout_movies 컬렉션 에 생성할 사용자 지정 인덱스 정의를 지정하는 방법을 보여줍니다.

'mongodb' => [
    'connection' => env('SCOUT_MONGODB_CONNECTION', 'mongodb'),
    'index-definitions' => [
        'scout_movies' => [
            'mappings' => [
                'dynamic' => false,
                'fields' => ['title' => ['type' => 'string']]
            ]
        ]
    ]
], ...

Atlas Search 인덱스 정의를 정의하는 방법에 대해 자세히 학습 Atlas 설명서에서 필드 매핑 정의 가이드 참조하세요.

검색 가능한 컬렉션 으로 데이터 가져오기

Scout를 사용하여 Eloquent 모델로 모델링된 소스 컬렉션 의 데이터를 검색 가능한 컬렉션 으로 복제할 수 있습니다. 다음 명령은 movies 컬렉션 의 데이터를 이전 단계에서 인덱싱된 scout_movies 컬렉션 으로 복제하고 인덱싱합니다.

php artisan scout:import 'App\Models\Movie'

문서는 Atlas Search 쿼리에 대해 자동으로 인덱싱됩니다.

class Movie extends Model
{
    ....
    public function toSearchableArray(): array
    {
        return [
            'plot' => $this->plot,
            'title' => $this->title,
        ];
    }
}