최종 수정일 - 영어 : 2년 전 / 한글 : 1년 전
영문 같이보기 영어 원문보기

데이터베이스 : 시작하기

시작하기

거의 모든 최신 웹 애플리케이션은 데이터베이스와 상호 작용합니다. 라라벨은 원시 SQL, 유창한 쿼리 빌더 및 Eloquent ORM을 사용하여 지원되는 다양한 데이터베이스에서 데이터베이스와 매우 간단하게 상호 작용할 수 있습니다. 현재 라라벨은 5개의 데이터베이스를 주요하게 지원하고 있습니다.

설정하기

라라벨의 데이터베이스 서비스 설정은 애플리케이션의 config/database.php 설정 파일에 존재합니다. 이 파일에서 모든 데이터베이스 연결을 정의하고 기본적으로 사용해야 하는 연결을 지정할 수 있습니다. 이 파일에 있는 대부분의 설정 옵션은 애플리케이션의 환경 변수 값에 의해 결정됩니다. 라라벨에서 지원하는 대부분의 데이터베이스 시스템에 대한 예제가 이 파일에 제공됩니다.

기본적으로 라라벨의 샘플 환경 설정은 로컬 머신에서 Laravel 애플리케이션을 개발하기 위한 Docker 설정인 Laravel Sail과 함께 사용할 준비가 되어 있습니다. 그러나 로컬 데이터베이스에 대해 필요에 따라 데이터베이스 설정을 자유롭게 수정할 수 있습니다.

SQLite 설정하기

SQLite 데이터베이스는 파일시스템에 한개의 파일로 만들 수 있습니다. 터미널에서 touch 명령을 사용하여 새 SQLite 데이터베이스를 만들 수 있습니다(touch database/database.sqlite). 데이터베이스가 생성된 후 DB_DATABASE 환경 변수에 데이터베이스에 대한 절대 경로를 배치하여 이 데이터베이스를 가리키도록 환경 변수를 쉽게 설정할 수 있습니다.

DB_CONNECTION=sqlite
DB_DATABASE=/absolute/path/to/database.sqlite

SQLite 연결에 외래 키 제약 조건을 사용하려면 DB_FOREIGN_KEYS 환경 변수를 true로 설정해야합니다.

DB_FOREIGN_KEYS=true

마이크로소프트 SQL 서버 설정

Microsoft SQL Server 데이터베이스를 사용하려면 sqlsrv 및 pdo_sqlsrv PHP 확장과 Microsoft SQL ODBC 드라이버와 같이 필요한 의존성이 설치되어 있는지 확인해야 합니다.

URL을 사용하여 설정

일반적으로 데이터베이스 연결은 host, database, username, password 등과 같은 여러가지 설정 값을 사용하여 설정됩니다. 이러한 설정 값 각각은 해당 환경 변수를 갖습니다. 즉, 프로덕션 서버에서 데이터베이스 연결 정보를 설정 할 때 여러 환경 변수를 관리해야합니다.

AWS나 Heroku 같은 일부 관리형 데이터베이스 공급자는 단일 문자열에서 데이터베이스의 모든 연결 정보를 포함하는 단일 데이터베이스 "URL"을 제공합니다. 데이터베이스 URL의 예는 다음과 같습니다.

mysql://root:[email protected]/forge?charset=UTF-8

이러한 URL은 일반적으로 표준 스키마 규칙을 따릅니다.

driver://username:password@host:port/database?options

편의상 라라벨은 여러 설정 옵션으로 데이터베이스를 설정하는 대신 이러한 URL을 지원합니다. url (또는 대응하는DATABASE_URL 환경 변수) 설정 옵션이 존재하면, 데이터베이스 연결과 인증 정보를 추출하는데 사용됩니다.

읽기 & 쓰기 커넥션

SELECT문에서 사용하는 데이터베이스와 INSERT, UPDATE 그리고 DELETE문을 사용하는 데이터 베이스에 다른 연결을 사용할고 싶은 경우도 있습니다. 라라벨은 이를 쉽게 할 수 있습니다. Raw 쿼리를 사용하든, 쿼리 빌더 또는 Eloquent ORM 을 사용하든 적절한 연결들을 사용할 수 있습니다.

다음은 어떻게 read / write 커넥션을 설정하는지에 대한 예제 입니다.

'mysql' => [
    'read' => [
        'host' => [
            '192.168.1.1',
            '196.168.1.2',
        ],
    ],
    'write' => [
        'host' => [
            '196.168.1.3',
        ],
    ],
    'sticky' => true,
    'driver' => 'mysql',
    'database' => 'database',
    'username' => 'root',
    'password' => '',
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
],

설정 배열에 read, write 그리고 sticky 세개의 키가 추가 된것을 참고하십시오. read 와 write 키는 host라는 하나의 키를 포함하는 배열 값입니다. read 와 write 의 나머지 데이터베이스 옵션 값은 기본 mysql 설정 배열에서 합쳐(merge)집니다.

기본 mysql 배열의 값을 재정의하려면 read 및 write 배열에만 항목을 배치하면 됩니다. 따라서 이 경우 192.168.1.1이 "읽기" 연결을 위한 호스트로 사용되고 192.168.1.3이 "쓰기" 연결에 사용됩니다. 기본 mysql 배열의 데이터베이스 자격 증명, 접두사, 문자 집합 및 기타 모든 옵션은 두 연결에서 공유됩니다. host 설정 배열에 값이 여러개가 있는 경우 각 요청에 대해 데이터베이스 호스트가 무작위로 선택됩니다.

sticky 옵션

sticky 옵션은 현재 request-요청사이클 에서 데이터베이스에 기록된 레코드를 바로 읽을 수 있도록 하는 있어도 되고 없어도 되는 값입니다. sticky 옵션이 활성화 되어 있고 현재 request-요청사이클에서 데이터베이스에 "쓰기" 작업을 수행한 경우 이 뒤에 "읽기"작업은 "쓰기"에서 사용한 커넥션으르 사용합니다. 이렇게 되면, request-요청사이클 동안에 작성된 모든 데이터를 동일한 request-요청 중에서는 바로 데이터베이스에서 읽을 수 있습니다. 여러분의 애플리케이션에서 이러한 동작이 필요한지에 대해서 결정하는 건 여러분의 선택에 따라 달라질 수 있습니다.

SQL 쿼리 실행

일단 데이터베이스 연결을 설정하면 DB 파사드를 사용해서 쿼리를 실행 할 수 있습니다. DB 파사드는 각각 쿼리 타입에 해당하는 메소드 : select, update, delete 그리고 statement 메소드를 제공합니다.

Select 쿼리 실행하기

기본 SELECT 쿼리를 실행하려면 DB 파사드에서 select 메소드를 사용할 수 있습니다.

<?php

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use Illuminate\Support\Facades\DB;

class UserController extends Controller
{
    /**
     * Show a list of all of the application's users.
     *
     * @return \Illuminate\Http\Response
     */
    public function index()
    {
        $users = DB::select('select * from users where active = ?', [1]);

        return view('user.index', ['users' => $users]);
    }
}

select 메소드에 전달된 첫 번째 인수는 SQL 쿼리이고 두 번째 인수는 쿼리에 바인딩해야 하는 매개변수 바인딩입니다. 일반적으로 이들은 where 절 제약 조건의 값입니다. 매개변수 바인딩은 SQL 주입에 대한 보호를 제공합니다.

select 메소드는 항상 결과의 array를 반환합니다. 배열 내의 각 결과는 데이터베이스의 레코드를 나타내는 PHP stdClass 객체가 됩니다.

use Illuminate\Support\Facades\DB;

$users = DB::select('select * from users');

foreach ($users as $user) {
    echo $user->name;
}

스칼라 값 선택

때로 데이터베이스 쿼리 결과가 단일 스칼라 값일 수 있습니다. 쿼리의 스칼라 결과를 객체로부터 조회하는 대신 scalar 메서드를 이용해 바로 조회할 수 있습니다.

$burgers = DB::scalar(
    "select count(case when food = 'burger' then 1 end) as burgers from menu"
);

이름이 부여된 바인딩 사용하기

? 를 사용하는 파라미터 바인딩 대신에, 이름을 지정한 바인딩을 사용한 쿼리를 실행시킬 수 있습니다.

$results = DB::select('select * from users where id = :id', ['id' => 1]);

Insert 문 실행하기

insert 문을 실행하려면 DB 파사드에서 insert 메소드를 사용할 수 있습니다. select와 마찬가지로 이 메서드는 SQL 쿼리를 첫 번째 인수로 받아들이고 바인딩을 두 번째 인수로 받아들입니다.

use Illuminate\Support\Facades\DB;

DB::insert('insert into users (id, name) values (?, ?)', [1, 'Marc']);

Update 쿼리 실행하기

update 메소드는 데이터베이스의 기존 레코드를 업데이트하는 데 사용해야 합니다. 명령문의 영향을 받는 행 수는 다음 메서드에서 반환됩니다.

use Illuminate\Support\Facades\DB;

$affected = DB::update(
    'update users set votes = 100 where name = ?',
    ['Anita']
);

Delete 쿼리 실행하기

delete 메소드는 데이터베이스에서 레코드를 삭제하는 데 사용해야 합니다. update와 마찬가지로 영향을 받는 행 수는 다음 메서드에 의해 반환됩니다.

use Illuminate\Support\Facades\DB;

$deleted = DB::delete('delete from users');

일반적인 구문의 쿼리 실행하기

몇몇 데이터베이스 구문은 값을 반환하지 않습니다. 이러한 유형의 작업들을 위해서는 DB 파사드의 statement 메소드를 사용할 수 있습니다.

DB::statement('drop table users');

준비되지 않은 구문 실행

값을 바인딩하지 않고 SQL 문을 실행하려는 경우가 있습니다. 이것을 수행하기 위해 DB 파사드의 unprepared 메소드를 사용할 수 있습니다.

DB::unprepared('update users set votes = 100 where name = "Dries"');

{참고} 준비되지 않은 구문은 매개변수를 바인딩하지 않으므로 SQL 주입에 취약할 수 있습니다. 준비되지 않은 명령문 내에서 사용자 제어 값을 허용해서는 안 됩니다.

묵시적 커밋

트랜잭션 내에서 DB 파사드의 statement 및 unprepared 메소드를 사용할 때 묵시적 커밋 을 유발하는 명령문을 피하도록 주의해야 합니다. 이러한 명령문은 데이터베이스 엔진이 전체 트랜잭션을 간접적으로 커밋하도록 하여 라라벨이 데이터베이스의 트랜잭션 수준을 인식하지 못하게 합니다. 이러한 명령문의 예를들자면 데이터베이스 테이블을 생성하는 것입니다.

DB::unprepared('create table a (col varchar(1) null)');

묵시적 커밋을 유발하는 모든 명령문 목록 은 MySQL 매뉴얼을 참조하십시오.

다중 데이터베이스 연결 사용

애플리케이션이 config/database.php 설정 파일에 다중 연결을 정의하는 경우 DB 파사드에서 제공하는 connection 메소드를 통해 각 연결에 액세스할 수 있습니다. connection 메소드에 전달된 연결 이름은 config/database.php 설정 파일에 나열된 연결 중 하나와 일치하거나 런타임 시 config 헬퍼를 사용하여 설정해야 합니다.

use Illuminate\Support\Facades\DB;

$users = DB::connection('sqlite')->select(/* ... */);

연결 인스턴스에서 getPdo 메서드를 사용하여 연결의 기본 PDO 인스턴스에 액세스할 수 있습니다.

$pdo = DB::connection()->getPdo();

쿼리 이벤트 리스닝

애플리케이션이 실행하는 각 SQL 쿼리에 대해 호출되는 클로저를 지정하려면 DB 파사드의 listen 메소드를 사용할 수 있습니다. 이 방법은 쿼리 로깅이나 디버깅에 유용할 수 있습니다. service provider의 boot 메소드에 쿼리 리스너 클로저를 등록할 수 있습니다.

<?php

namespace App\Providers;

use Illuminate\Support\Facades\DB;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    /**
     * Register any application services.
     *
     * @return void
     */
    public function register()
    {
        //
    }

    /**
     * Bootstrap any application services.
     *
     * @return void
     */
    public function boot()
    {
        DB::listen(function ($query) {
            // $query->sql;
            // $query->bindings;
            // $query->time;
        });
    }
}

누적 쿼리 시간 모니터링

모던 웹 애플리케이션의 흔한 성능 병목은 데이터베이스 쿼리하는데 사용하는 시간입니다. 다행히도 라라벨은 단일 요청 중에 데이터베이스 쿼리 시간이 너무 오래 걸리면 클로저나 콜백을 실행할 수 있습니다. 누적 쿼리 시간 모니터링을 사용하려면 쿼리 시간 임계값(밀리초)와 클로저를 whenQueryingForLongerThan 메서드에 작성합니다. 서비스 프로바이더의 boot 메서드에서 이 메서드를 실행하세요.

<?php

namespace App\Providers;

use Illuminate\Database\Connection;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\ServiceProvider;
use Illuminate\Database\Events\QueryExecuted;

class AppServiceProvider extends ServiceProvider
{
    /**
     * Register any application services.
     *
     * @return void
     */
    public function register()
    {
        //
    }

    /**
     * Bootstrap any application services.
     *
     * @return void
     */
    public function boot()
    {
        DB::whenQueryingForLongerThan(500, function (Connection $connection, QueryExecuted $event) {
            // Notify development team...
        });
    }
}

데이터베이스 트랜잭션

데이터베이스 트랜잭션 내에서 일련의 작업을 실행하기 위해 DB 파사드에서 제공하는 transaction 메소드를 사용할 수 있습니다. 트랜잭션 클로저 내에서 예외가 발생하면 트랜잭션이 자동으로 롤백되고 예외가 다시 발생합니다. 클로저가 성공적으로 실행되면 트랜잭션이 자동으로 커밋됩니다. transaction 메소드를 사용하는 동안 수동으로 롤백하거나 커밋하는 것에 대해 걱정할 필요가 없습니다.

use Illuminate\Support\Facades\DB;

DB::transaction(function () {
    DB::update('update users set votes = 1');

    DB::delete('delete from posts');
});

데드락 처리하기

transaction 메소드는 교착 상태가 발생할 때 트랜잭션을 재시도해야 하는 횟수를 정의하는 선택적 두 번째 인수를 허용합니다. 이러한 시도가 모두 소진되면 예외가 발생합니다.

use Illuminate\Support\Facades\DB;

DB::transaction(function () {
    DB::update('update users set votes = 1');

    DB::delete('delete from posts');
}, 5);

수동으로 트랜잭션 사용하기

트랜잭션을 수동으로 시작하고 롤백과 커밋을 완전히 제어하려면 DB 파사드에서 제공하는 beginTransaction 메소드를 사용할 수 있습니다.

use Illuminate\Support\Facades\DB;

DB::beginTransaction();

rollBack 메소드는 트랜잭션을 롤백 할 수 있습니다.

DB::rollBack();

마지막으로 commit 메소드는 트랜잭션을 커밋 할 수 있습니다.

DB::commit();

{tip} DB 파사드의 트랜잭션 메소드는 query builder 및 Eloquent ORM 모두에 대한 트랜잭션을 제어합니다.

데이터베이스 CLI에 연결

데이터베이스의 CLI에 연결하려면 db Artisan 명령을 사용할 수 있습니다.

php artisan db

필요한 경우 기본 연결이 아닌 데이터베이스 연결에 연결할 데이터베이스 연결 이름을 지정할 수 있습니다.

php artisan db mysql

데이터베이스 검사하기

db:show와 db:table 아티즌 커맨드를 이용해서 데이터베이스 및 이와 연관된 테이블에 대한 가치있는 인사이트를 얻을 수 있습니다. 크기, 타입, 커넥션 수, 테이브요약을 포함하는 데이터베이스의 개요를 보려면 db:show 명령을 사용하세요.

php artisan db:show

검사하고자 하는 데이터베이스 커넥션을 --database 옵션으로 지정할 수 있습니다.

php artisan db:show --database=pgsql

테이블 행 수와 뷰 상세를 보고 싶으면 --counts와 --views 옵션을 사용하세요. 데이터베이스가 크면 행 수와 뷰 상세를 조회하는데 오래걸릴 수 있습니다.

php artisan db:show --counts --views

테이블 개요

개별 테이블에 대한 개요를 보고 싶으면 db:table 아티즌 명령을 사용하시면 됩니다. 이 명령은 컬럼, 타입, 속성, 키, 인덱스를 포함하는 개요를 제공합니다.

php artisan db:table users

데이터베이스 모니터링 하기

db:monitor 아티즌 명령을 이용해서 특정 수 이상의 커넥션을 넘어서면 Illuminate\Database\Events\DatabaseBusy 이벤트를 발행하도록 라라벨에 지시를 내릴 수 있습니다.

이 기능을 사용하려면 db:monitor 명령을 매분 실행되도록 설정해야합니다. 이 명령은 모니터링할 데이터베이스 커넥션의 이름들과 이벤트를 발행하기 전까지 허용되는 커넥션 최대값을 받습니다.

php artisan db:monitor --databases=mysql,pgsql --max=100

이 명령을 스케쥴링 하는 것만으로는 커넥션 수에 따라 당신에게 알림을 보낼 수 없습니다. 데이터베이스 커넥션 수가 임계치를 넘으면 DatabaseBusy 이벤트가 발행됩니다. 여러분 또는 개발팀에 알림을 전송하기 위해서는 EventServiceProvider 내에서 이 이벤트를 듣고 처리해야 합니다.

use App\Notifications\DatabaseApproachingMaxConnections;
use Illuminate\Database\Events\DatabaseBusy;
use Illuminate\Support\Facades\Event;
use Illuminate\Support\Facades\Notification;

/**
 * Register any other events for your application.
 *
 * @return void
 */
public function boot()
{
    Event::listen(function (DatabaseBusy $event) {
        Notification::route('mail', '[email protected]')
                ->notify(new DatabaseApproachingMaxConnections(
                    $event->connectionName,
                    $event->connections
                ));
    });
}
패스워드 재설정하기 쿼리 빌더

이 문서의 번역에 기여해주신 분들

findstar smartbos kkame 기여에 참여하기