Doctrine 2 DBALを使ってみる（SQL直投げ編）

1.DBALを使えるようにする

今回はComposerに依存管理をお願いしてDoctrineを準備してもらいます。
なので、まずはComposerを準備します。

Composer準備

curl -s http://getcomposer.org/installer | php

そしてcomposer.jsonというファイルを準備。

composer.json

{
    "require": {
        "doctrine/dbal": ">=2.3.0"
    }
}

後はComposerに任せるだけ。

php composer.phar install

コマンドの実行後にカレントディレクトリにはvendorというディレクトリが出来ています。
Composerがよしなにしてくれるので、Composerに追加してあるものであれば以下のファイルをインクルードするだけで済みます（便利！）

<?php
include_once "vendor/autoload.php";

次にDoctrineの初期化処理をしていきます。

Doctirne準備

<?php

use Doctrine\DBAL\Configuration;
use Doctrine\DBAL\DriverManager;

// 接続するDBの設定
$conn = [
    "driver"=>"pdo_mysql",
    "host"=>"localhost",
    "user"=>"root",
    "password"=>"password",
    "dbname"=>"db_name",
    "charset"=>"utf8",
];

// デフォルトのフェッチ形式を連想配列にする
$config = new Configuration([ PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC ]);

$doctrine = DriverManager::getConnection( $conn, $config );

これでDBALが利用できるようになりました。

2.SQLを投げてみる

一番シンプルなの

基本的には以下のようにするだけです。

$result = $doctrine->fetchAll( 'SELECT * FROM sample_table' );
var_dump( $result );

バインドを使ってみる

バインドとは何か？
とりあえずは下のソースを見てみましょう！

$result = $doctrine->fetchAll( 'SELECT * FROM sample_table WHERE id = :id', ['id'=>1] );
var_dump( $result );

SQL文中になにやら怪しげなのが！？
id = :id
:が付いているのがありますね。
実は:をつけたものは第二引数で指定している配列上のパラメータに置き換えをしてくれます（便利！！）
これが、バインドという機能です

INSERTしてみる

INSERT/UPDATE/DELETEをする際には、fetchAllではなくexecuteUpdateを使います。
また、返値は行数が帰ってきます。

<?php
$result = $doctrine->executeUpdate(
    'INSERT INTO sample_table ( id, description ) VALUES ( :id, :description',
    [ 'id'=>2, 'description'=>'INSERTしてみる！' ]
);
var_dump( $result );

書き方のバリエーション

<?php

    // ベースとなるSQLをprepareでセット
    $stmt = $doctrine->prepare( 'SELECT * FROM sample_table WHERE id = :id' );

    // ex. 複数のIDで抽出したいとか（WHERE INとかにするべきなんだろうけどとりあえず
    // WHERE IN にする方法があるという気もするけど・・・・
    $stmt->bindValue( ':id', 1 );
    $stmt->execute();
    var_dump( $stmt->fetchAll() );

    $stmt->bindValue( ':id', 2 );
    $stmt->execute();
    var_dump( $stmt->fetchAll() );

    // 単一行の抽出ならfetchAssoc()
    var_dump( $stmt->fetchAssoc() );

---

次回、もしかしたらQueryBuilder編が・・・・！