데이터베이스 : 시작하기

시작하기
Raw SQL 쿼리 실행하기
- 쿼리 이벤트 리스닝
데이터베이스 트랙잭션
다중 데이터베이스 커넥션 사용하기

시작하기

라라벨은 직접 raw SQL을 사용할 때에도, 쿼리 빌더를 사용하거나 그리고 Eloquent ORM을 사용할 때에도 커넥션을 만들고 쿼리를 실행하는 이 매우 쉽도록 해줍니다. 현재 라라벨은 4가지 데이터베이스 시스템을 지원하고 있습니다.

MySQL
Postgres
SQLite
SQL Server

설정하기

라라벨은 데이터베이스 연결과 쿼리 사용을 매우 쉽게 만들어줍니다. 애플리케이션을 위한 데이터베이스 설정 파일은 config/database.php에 위치하고 있습니다. 이 파일에서 모든 데이터베이스 커넥션에 대한 설정을 정의하고 기본적으로 사용할 커넥션을 지정할 수 있습니다. 이 파일에서는 모든 지원하는 데이터베이스 예제가 들어 있습니다.

기본적으로 라라벨의 샘플 환경 설정은 여러분의 로컬 머신에서 라라벨 개발 환경을 구축할 수 있는 편리한 방법을 제공하는 라라벨 홈스테드에 맞춰져 있습니다. 물론 로컬 데이터베이스에 맞게 변경하시면 됩니다.

SQLite 설정하기

touch database/database.sqlite 와 같은 명령어를 사용하여 SQLite 데이터베이스를 새롭게 생성한 뒤에, 데이터베이스의 절대 경로를 사용하여 새롭게 생성된 데이터베이스를 지정하는 환경 설정을 손쉽게 추가할 수 있습니다.

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

SQL 서버 설정하기

라라벨은 별다른 추가 작업 없이도 SQL 서버를 지원하고 있습니다; 하지만 데이터베이스를 사용하기 위해서 커넥션에 대한 설정을 추가할 필요가 있을 것입니다:

'sqlsrv' => [
    'driver' => 'sqlsrv',
    'host' => env('DB_HOST', 'localhost'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'charset' => 'utf8',
    'prefix' => '',
],

읽기 / 쓰기 커넥션

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

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

'mysql' => [
    'read' => [
        'host' => '192.168.1.1',
    ],
    'write' => [
        'host' => '196.168.1.2'
    ],
    'driver'    => 'mysql',
    'database'  => 'database',
    'username'  => 'root',
    'password'  => '',
    'charset'   => 'utf8',
    'collation' => 'utf8_unicode_ci',
    'prefix'    => '',
],

설정 배열에 read 와 write 두개의 키가 추가 된것을 참고하십시오. 이 키들은 host라는 싱글 키를 포함하는 배열 값을 갖는다: read와 write 연결에대한 나머지 데이터베이스 옵션들은 기본 mysql 배열에서 합쳐(merge)집니다.

따라서 메인 배열값들 중에서 재정의하고자하는 것들만 read와 write 배열에서 입력하면 됩니다. 위의 경우에서는 192.168.1.1 호스트는 "read" 커넥션에서 사용되고, 192.168.1.2 호스트는 "write" 커넥션에서 사용되어 집니다. 메인 mysql설정 배열에 포함된 데이터베이스 연결정보, 프리픽스, 캐릭터 셋 등 다른 모든 옵션들은 양쪽연결에서 모두 공유합니다 .

Raw 쿼리 실행

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

Select 쿼리 실행하기

기본적인 쿼리를 실행하기 위해서 DB 파사드의 select 메소드를 사용할 수 있습니다.

<?php

namespace App\Http\Controllers;

use DB;
use App\Http\Controllers\Controller;

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

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

select 메소드의 첫번째 인자는 raw SQL 쿼리이고, 두번째는 쿼리에 바이딩될 매개변수 입니다. 일반적으로 매개 변수들은 where 절을 위한 값들입니다. 매개변수 바인딩은 SQL 인젝션을 방지하기 위해 제공됩니다.

select 메소드는 항상 결과를 배열로 반환합니다. 배열안의 값들은 PHP 의 StdClass 객체 형태로 다음과 같이 결과 값에 엑세스 할 수 있습니다.

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

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

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

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

Insert 문 실행하기

insert 쿼리문을 실행하기 위해서는 DB 파사드의 insert 메소드를 사용하면 됩니다. select 메소드와 마찬가지로, 이 메소드는 첫번째 인자로 raw SQL 쿼리를, 두번째로 바인딩할 인자들을 전달 받습니다.

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

Update 쿼리 실행하기

update 메소드는 데이터베이스에 존재하는 레코드 업데이트 하는데 사용되어집니다. 메소드가 반환하는 값은 영향을 받은 레코드들의 갯수입니다.

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

Delete 쿼리 실행하기

delete 메소드는 데이터베이스에서 레코드를 삭제하는데 사용되어 집니다. update 와 마찬가지로, 삭제된 레코드들의 갯수가 반환될 것입니다.

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

일반적인 statement 쿼리 실행하기

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

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

쿼리 이벤트 리스닝

애플리케이션에서 실행되는 각각의 쿼리를 확인하고자 한다면 listen 메소드를 사용하면 됩니다. 이 메소드는 쿼리를 로그로 남기거나, 디버깅 할 때 유용합니다. 서비스 프로바이더에서 쿼리 리스너를 등록할 수 있습니다.

<?php

namespace App\Providers;

use DB;
use Illuminate\Support\ServiceProvider;

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

    /**
     * Register the service provider.
     *
     * @return void
     */
    public function register()
    {
        //
    }
}

데이터베이스 트랜잭션

일련의 쿼리들을 하나의 데이터베이스 트랜잭션으로 실행할때에는 DB 파사드의 transaction메소드를 사용하면 됩니다: 트랜잭션 메소드에 전달된 Closure 안에서 exception 이 발생하게 되면 트랜잭션은 자동으로 롤백됩니다. Closure가 성공적으로 실행되면 트랜잭션은 자동으로 커밋됩니다. transaction 메소드를 사용하게 되면 수동으로 롤백과 커밋에 대해서 걱정할 필요가 없습니다.

DB::transaction(function () {
    DB::table('users')->update(['votes' => 1]);

    DB::table('posts')->delete();
});

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

트랜잭션을 직접 시작하고 롤백과 커밋을 제어하고 싶은 경우는 DB 파사드의 beginTransaction 메소드를 사용하면 됩니다.

DB::beginTransaction();

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

DB::rollBack();

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

DB::commit();

참고: DB 파사드의 트랜잭션 메서드와 마찬가지로 쿼리 빌더 와 Eloquent ORM에서도, 트랜잭션을 제어 할 수도 있습니다.

다중 데이터베이스 커넥션 사용하기

다중 커넥션을 사용하는 경우, DB 파사드의 connection 메소드를 통해 각각의 커넥션에 액세스 할 수 있습니다. connection 메소드에 전달되는 name은 config/database.php 설정 파일에 나열되어 있는 이름이어야 합니다.

$users = DB::connection('foo')->select(...);

또한 커넥션 인스턴스에서 getPdo 메소드를 사용하여 PDO 인스턴스로 액세스 할 수 있습니다:

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

Database: Getting Started

Introduction
Running Raw SQL Queries
- Listening For Query Events
Database Transactions
Using Multiple Database Connections

Introduction

Laravel makes connecting with databases and running queries extremely simple across a variety of database back-ends using either raw SQL, the fluent query builder, and the Eloquent ORM. Currently, Laravel supports four database systems:

MySQL
Postgres
SQLite
SQL Server

Configuration

Laravel makes connecting with databases and running queries extremely simple. The database configuration for your application is located at config/database.php. In this file you may define all of your database connections, as well as specify which connection should be used by default. Examples for all of the supported database systems are provided in this file.

By default, Laravel's sample environment configuration is ready to use with Laravel Homestead, which is a convenient virtual machine for doing Laravel development on your local machine. Of course, you are free to modify this configuration as needed for your local database.

SQLite Configuration

After creating a new SQLite database using a command such as touch database/database.sqlite, you can easily configure your environment variables to point to this newly created database by using the database's absolute path:

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

SQL Server Configuration

Laravel supports SQL Server out of the box; however, you will need to add the connection configuration for the database:

'sqlsrv' => [
    'driver' => 'sqlsrv',
    'host' => env('DB_HOST', 'localhost'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'charset' => 'utf8',
    'prefix' => '',
],

Read / Write Connections

Sometimes you may wish to use one database connection for SELECT statements, and another for INSERT, UPDATE, and DELETE statements. Laravel makes this a breeze, and the proper connections will always be used whether you are using raw queries, the query builder, or the Eloquent ORM.

To see how read / write connections should be configured, let's look at this example:

'mysql' => [
    'read' => [
        'host' => '192.168.1.1',
    ],
    'write' => [
        'host' => '196.168.1.2'
    ],
    'driver'    => 'mysql',
    'database'  => 'database',
    'username'  => 'root',
    'password'  => '',
    'charset'   => 'utf8',
    'collation' => 'utf8_unicode_ci',
    'prefix'    => '',
],

Note that two keys have been added to the configuration array: read and write. Both of these keys have array values containing a single key: host. The rest of the database options for the read and write connections will be merged from the main mysql array.

So, we only need to place items in the read and write arrays if we wish to override the values in the main array. So, in this case, 192.168.1.1 will be used as the "read" connection, while 192.168.1.2 will be used as the "write" connection. The database credentials, prefix, character set, and all other options in the main mysql array will be shared across both connections.

Running Raw SQL Queries

Once you have configured your database connection, you may run queries using the DB facade. The DB facade provides methods for each type of query: select, update, insert, delete, and statement.

Running A Select Query

To run a basic query, we can use the select method on the DB facade:

<?php

namespace App\Http\Controllers;

use DB;
use App\Http\Controllers\Controller;

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

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

The first argument passed to the select method is the raw SQL query, while the second argument is any parameter bindings that need to be bound to the query. Typically, these are the values of the where clause constraints. Parameter binding provides protection against SQL injection.

The select method will always return an array of results. Each result within the array will be a PHP StdClass object, allowing you to access the values of the results:

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

Using Named Bindings

Instead of using ? to represent your parameter bindings, you may execute a query using named bindings:

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

Running An Insert Statement

To execute an insert statement, you may use the insert method on the DB facade. Like select, this method takes the raw SQL query as its first argument, and bindings as the second argument:

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

Running An Update Statement

The update method should be used to update existing records in the database. The number of rows affected by the statement will be returned by the method:

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

Running A Delete Statement

The delete method should be used to delete records from the database. Like update, the number of rows deleted will be returned:

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

Running A General Statement

Some database statements should not return any value. For these types of operations, you may use the statement method on the DB facade:

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

Listening For Query Events

If you would like to receive each SQL query executed by your application, you may use the listen method. This method is useful for logging queries or debugging. You may register your query listener in a service provider:

<?php

namespace App\Providers;

use DB;
use Illuminate\Support\ServiceProvider;

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

    /**
     * Register the service provider.
     *
     * @return void
     */
    public function register()
    {
        //
    }
}

Database Transactions

To run a set of operations within a database transaction, you may use the transaction method on the DB facade. If an exception is thrown within the transaction Closure, the transaction will automatically be rolled back. If the Closure executes successfully, the transaction will automatically be committed. You don't need to worry about manually rolling back or committing while using the transaction method:

DB::transaction(function () {
    DB::table('users')->update(['votes' => 1]);

    DB::table('posts')->delete();
});

Manually Using Transactions

If you would like to begin a transaction manually and have complete control over rollbacks and commits, you may use the beginTransaction method on the DB facade:

DB::beginTransaction();

You can rollback the transaction via the rollBack method:

DB::rollBack();

Lastly, you can commit a transaction via the commit method:

DB::commit();

Note: Using the DB facade's transaction methods also controls transactions for the query builder and Eloquent ORM.

Using Multiple Database Connections

When using multiple connections, you may access each connection via the connection method on the DB facade. The name passed to the connection method should correspond to one of the connections listed in your config/database.php configuration file:

$users = DB::connection('foo')->select(...);

You may also access the raw, underlying PDO instance using the getPdo method on a connection instance:

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

Validation-유효성검사 쿼리빌더

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

기여에 참여하기