Laravel MongoDB 시작하기

MongoDB PHP 확장 설치

Laravel MongoDB MongoDB 연결 및 명령을 관리 하려면 MongoDB PHP 확장이 필요합니다. MongoDB PHP 확장 프로그램을 설치하는 방법을 학습 PHP 라이브러리 시작하기 가이드 의 MongoDB PHP 확장 프로그램 설치 단계를 참조하세요.

Laravel 설치

설치하는 Laravel 버전이 Laravel 통합 버전과 호환되는지 확인합니다. 호환되는 버전을 학습 호환성 페이지를 참조하세요.

다음 명령을 실행하여 Laravel을 설치합니다:

composer global require laravel/installer

설치가 완료되면 명령은 다음 메시지를 출력합니다.

Using version ^<version number> for laravel/installer

Laravel 애플리케이션 만들기

다음 명령을 실행하여 my-app 이라는 새 Laravel 웹 애플리케이션을 생성합니다.

laravel new my-app

설치가 완료되면 명령은 다음 메시지를 출력합니다.

INFO  Application ready in [my-app]. You can
start your local development using:
➜ cd my-app
➜ php artisan serve
New to Laravel? Check out our bootcamp and documentation.
Build something amazing!

Laravel 애플리케이션 암호화 키 추가

이전 단계에서 생성한 애플리케이션 디렉토리로 이동합니다.

cd my-app

다음 명령을 실행하여 쿠키를 암호화하는 데 필요한 Laravel 애플리케이션 암호화 키를 추가합니다.

php artisan key:generate

종속성에 Laravel MongoDB 추가

다음 명령을 실행하여 애플리케이션에 Laravel MongoDB 종속성을 추가합니다.

composer require mongodb/laravel-mongodb:^5.8

설치가 완료되면 composer.json 파일에 require 객체에 다음 줄이 포함되어 있는지 확인합니다.

"mongodb/laravel-mongodb": "^5.8"

이 단계를 완료하면 Laravel 통합 종속성이 설치된 새 Laravel 프로젝트 가 생성됩니다.

Atlas에서 무료 MongoDB 배포서버 생성

MongoDB 시작하기 가이드 완료하여 새 Atlas 계정을 설정하다 하고 샘플 데이터를 새 무료 계층 MongoDB deployment 에 로드합니다. Cloud Deployment 탭의 지침에 따라 cloud 에서 MongoDB Atlas 배포서버 만듭니다.

자격 증명 저장

데이터베이스 사용자를 생성한 후 다음 단계에서 사용할 수 있도록 해당 사용자의 사용자 이름과 비밀번호를 안전한 위치에 저장하세요.

MongoDB Atlas 연결 문자열 찾습니다.

이전 단계에서 만든 배포서버에 대한 연결 문자열 조회 하려면 Atlas 계정에 로그인 하고 Database 섹션 아래의 Clusters 페이지로 이동합니다. 새 배포서버 의 Connect 버튼을 클릭합니다.

아직 데이터베이스 사용자를 구성하지 않은 경우 MongoDB 새 사용자를 생성하고 구성하라는 메시지를 표시합니다.

Connect to your application 아래의 Drivers 버튼을 클릭하고 Driver 선택 메뉴에서 "PHP"를 선택하고, Version 선택 메뉴에서 설치한 버전과 가장 일치하는 버전을 선택합니다.

연결 문자열 만 보려면 View full code sample 옵션의 선택을 취소합니다.

연결 문자열을 복사합니다.

다음 스크린샷과 같이 연결 string 오른쪽에 있는 복사 아이콘을 클릭하여 클립보드에 복사합니다.

비밀번호 자리 표시자를 업데이트합니다.

이 연결 문자열 원하는 텍스트 편집기의 파일 에 붙여넣고 <db_password> 자리 표시자를 데이터베이스 사용자의 비밀번호로 바꿉니다. 연결 문자열 이 이미 데이터베이스 사용자의 사용자 이름 으로 채워져 있습니다.

다음 단계에서 사용할 수 있도록 이 파일을 안전한 위치에 저장합니다.

애플리케이션 환경 변수 파일 구성

다음 shell 명령을 실행하여 .env.example 파일을 프로젝트 루트 디렉토리의 .env 파일에 복사합니다.

cp .env.example .env

파일 열고 다음 변수 및 값을 추가하거나 편집합니다..env <connection string> 자리 표시자를 연결 문자열 만들기 단계의 연결 문자열 로 바꿉니다.

DB_CONNECTION=mongodb
DB_URI="<connection string>"

예를 들어 연결 string 이 "mongodb+srv://myUser:myPass123@mongo0.example.com/"인 경우 DB_URI 변수는 다음 줄과 일치합니다.

DB_URI="mongodb+srv://myUser:myPass123@mongo0.example.com/"

데이터베이스 구성에서 연결 문자열 설정

config 디렉토리에서 database.php 파일을 열고 다음 줄에 표시된 대로 기본 데이터베이스 연결을 DB_CONNECTION 환경 변수로 설정합니다.

'default' => env('DB_CONNECTION'),

동일한 파일의 connections 배열에 강조 표시된 다음 mongodb 항목을 추가합니다.

'connections' => [
  'mongodb' => [
    'driver' => 'mongodb',
    'dsn' => env('DB_URI'),
    'database' => 'sample_mflix',
  ],
],
// ...

Laravel 통합 제공자 추가

bootstrap 디렉토리에서 providers.php 파일을 열고 배열에 다음 항목을 추가합니다.

MongoDB\Laravel\MongoDBServiceProvider::class,

모델 및 컨트롤러 만들기

다음 명령을 실행하여 MongoDB database 및 해당 리소스 컨트롤러에서 샘플 movies collection의 데이터를 나타내는 Movie 모델을 생성합니다.

php artisan make:model Movie -cr

명령이 완료되면 다음 메시지가 출력됩니다.

INFO  Model [app/Models/Movie.php] created successfully.
INFO  Controller [app/Http/Controllers/MovieController.php]
created successfully.

Laravel 통합을 사용하도록 모델 편집

app/Models 디렉토리에서 Movie.php 모델을 열고 다음과 같이 편집합니다.

• Illuminate\Database\Eloquent\Model 가져오기를 MongoDB\Laravel\Eloquent\Model으)로 바꿉니다.

• $connection 필드에 "mongodb" 를 지정합니다.

편집한 Movie.php 파일에는 다음 코드가 포함되어 있습니다.

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

컨트롤러 기능 추가

app/Http/Controllers 디렉토리에서 MovieController.php 파일을 엽니다. 데이터베이스 쿼리와 일치하는 결과를 검색하고 뷰에 렌더링하려면 show() 함수를 다음 코드로 바꿉니다.

public function show()
{
    return view('browse_movies', [
        'movies' => Movie::where('runtime', '<', 60)
            ->where('imdb.rating', '>', 8.5)
            ->orderBy('imdb.rating', 'desc')
            ->take(10)
            ->get()
    ]);
}

웹 경로 추가

routes 디렉토리에서 web.php 파일을 엽니다. 다음 코드에 표시된 대로 MovieController 에 대한 가져오기 및 browse_movies 경로를 추가합니다.

<?php
// ...
use App\Http\Controllers\MovieController;
Route::get('/browse_movies/', [MovieController::class, 'show']);

뷰 생성

애플리케이션 루트 디렉토리에서 다음 명령을 실행하여 영화 데이터를 표시하는 뷰를 만듭니다.

php artisan make:view browse_movies

명령을 실행하면 다음 메시지가 출력됩니다.

INFO  View [resources/views/browse_movies.blade.php] created
successfully.

resources/views 디렉토리에서 browse_movies.blade.php 뷰 파일을 엽니다. 내용을 다음 코드로 바꾸고 변경 사항을 저장합니다.

<!DOCTYPE html>
<html>
<head>
   <title>Browse Movies</title>
</head>
<body>
<h2>Movies</h2>
@forelse ($movies as $movie)
  <p>
    Title: {{ $movie->title }}<br>
    Year: {{ $movie->year }}<br>
    Runtime: {{ $movie->runtime }}<br>
    IMDB Rating: {{ $movie->imdb['rating'] }}<br>
    IMDB Votes: {{ $movie->imdb['votes'] }}<br>
    Plot: {{ $movie->plot }}<br>
  </p>
@empty
    <p>No results</p>
@endforelse
</body>
</html>

선택적으로 결과를 JSON 문서로 볼 수 있습니다.

뷰를 생성하고 browse_movies.blade.php 파일을 편집하는 대신 toJson() 메서드를 사용하여 결과를 JSON 형식으로 표시할 수 있습니다.

show() 함수를 다음 코드로 대체하여 결과를 조회 하고 JSON 문서로 반환합니다.

public function show()
{
    $results = Movie::where('runtime', '<', 60)
        ->where('imdb.rating', '>', 8.5)
        ->orderBy('imdb.rating', 'desc')
        ->take(10)
        ->get();
    return $results->toJson();
}

Laravel 애플리케이션 시작

애플리케이션 루트 디렉토리에서 다음 명령을 실행하여 PHP 내장 웹 서버를 시작합니다.

php artisan serve

서버가 시작되면 다음 메시지를 출력합니다.

INFO  Server running on [http://127.0.0.1:8000].
Press Ctrl+C to stop the server

영화 데이터 보기

웹 브라우저에서 http://: /browse_movies127.0.0.18000 URL 을 엽니다. 이 페이지에는 영화 목록과 각 영화에 대한 세부 정보가 표시됩니다.

데이터를 삽입하는 함수 구현

app/Http/Controllers 디렉토리에 있는 MovieController.php 파일에서 store() 메서드를 다음 코드로 바꿉니다.

public function store(Request $request)
{
    $data = $request->all();
    $movie = new Movie();
    $movie->fill($data);
    $movie->save();
}

컨트롤러 함수를 호출하는 API 경로 추가

다음 명령을 실행 하여 API 경로 파일 을 생성합니다.

php artisan install:api

컨트롤러를 가져오고 routes/api.php 파일에서 store() 메서드를 호출하는 API 경로를 추가합니다.

use App\Http\Controllers\MovieController;
// ...
Route::resource('movies', MovieController::class)->only([
    'store'
]);

모델 필드 업데이트

다음 코드에 표시된 대로 app/Models 디렉토리에서 Movie 모델을 업데이트하여 fill() 메서드가 채우는 필드를 지정합니다.

class Movie extends Model
{
     protected $connection = 'mongodb';
     protected $fillable = ['title', 'year', 'runtime',
         'imdb', 'plot'];
}

API에 요청 게시

movie.json 파일을 만들고 다음 데이터를 삽입합니다.

{
  "title": "The Laravel MongoDB Quick Start",
  "year": 2024,
  "runtime": 15,
  "imdb": {
    "rating": 9.5,
    "votes": 1
  },
  "plot": "This movie entry was created by running through
      the Laravel MongoDB Quick Start tutorial."
}

shell에서 다음 명령을 실행하여 JSON 페이로드를 엔드포인트에 POST 요청으로 보냅니다.

curl -H "Content-Type: application/json" \
  --data @movie.json \
  http://localhost:8000/api/movies

데이터 보기

웹 브라우저에서 http://: /browse_movies를 열어 제출한 영화 정보를127.0.0.1 확인합니다. 삽입된 동영상이 결과 상단에 나타납니다.8000