データベースへの接続¶
データベースへの接続方法は2つあります:
自動接続¶
“自動接続” 機能は、ページが読み込まれるたびにデータベースクラスをロードし、 インスタンス化するというものです。 “自動接続”を有効にするには、次のファイルの中にある ライブラリ配列の中に、 databaseという語句を指定してください:
application/config/autoload.php
手動接続¶
ページの中で数ページだけがデータベース接続を必要とする場合は、手動でデ ータベースに接続することができます。 手動でデータベースに接続するには 、必要とするメソッド内で随時下記のコードを追加するか、 そのクラスでグ ローバルに使用したい場合はコンストラクタに下記のコードを追加します。
$this->load->database();
上のメソッドの第1引数に 何も指定しない場合は、設定ファイルで指定されている グループ [ 訳注:デフォルトのグループ ] に接続します。 多くの人にとっては、この方法が使いやすいと思います。
使用可能なパラメータ¶
- 配列またはDSN文字列によるデータベース 接続値
- TRUE/FALSE（boolean）。 接続IDを返すかどうか（以下の複数のデータベースへの接続をご覧ください）。
- TRUE/FALSE（boolean）。Query Builder クラスを利用するかどうか。初期値は TRUE がセットされます。
データベースへの手動接続¶
メソッドの第1引数は、 オプションで 設定ファイルに定義した特定のデータ ベース接続グループを指定するのに使用します。 また、設定ファイルで指定 されていない接続用のデータを渡すこともできます。 例としては:
設定ファイルで定義したグループを選択するには次のようにします:
$this->load->database('group_name');
ここでの group_name が設定ファイルで定義した接続グループの名前に なります。
手動で任意のデータベースに接続するには、次のように配列でデータを渡しま す:
$config['hostname'] = 'localhost';
$config['username'] = 'myusername';
$config['password'] = 'mypassword';
$config['database'] = 'mydatabase';
$config['dbdriver'] = 'mysqli';
$config['dbprefix'] = '';
$config['pconnect'] = FALSE;
$config['db_debug'] = TRUE;
$config['cache_on'] = FALSE;
$config['cachedir'] = '';
$config['char_set'] = 'utf8';
$config['dbcollat'] = 'utf8_general_ci';
$this->load->database($config);
接続用の各データについての情報は、 設定について をご覧ください。
注釈
PDO ドライバの場合、’hostname’と’database’ではなく $config[‘dsn’] 設定をお使いください。
あるいは、データベースの接続データをデータソースネーム（DSN）を使って渡 すこともできます。DSN は次のような形になっている必要があります:
$dsn = 'dbdriver://username:password@hostname/database';
$this->load->database($dsn);
データソースネーム（DSN）で設定ファイルのデフォルト値を上書きする場合に は、接続データをクエリで追加します。
$dsn = 'dbdriver://username:password@hostname/database?char_set=utf8&dbcollat=utf8_general_ci&cache_on=true&cachedir=/path/to/cache';
$this->load->database($dsn);
複数のデータベースへの接続¶
同時に 2つ以上のデータベースに接続する必要がある場合は次のようにするこ とで可能になります:
$DB1 = $this->load->database('group_one', TRUE);
$DB2 = $this->load->database('group_two', TRUE);
Note: “group_one” と “group_two”の部分は接続したい グループ名に変えてください (あるいは、上で説明したように接続用データを渡してください)。
メソッドの第2引数に TRUE（boolean） を指定すると、データベースオブジェクトを返すようになります。
注釈
このガイドで一貫して使われている構文を使わずに、上記のような方法で接続 すると、オブジェクト名を使ってコマンドを発行できます。つまり、以下のよ うな方法でコマンドを発行するのではなく:
注釈
同じ接続で別のデータベースのみを利用したい場合は、わざわざ個別の データベース接続設定を作成する必要はありません。別のデータベースに移りたい場合は 下記のように行えます:
再接続 / 接続状態の維持¶
何らかの重いPHPの処理（たとえば画像の処理など）を行っている間に、データ ベースサーバのアイドルタイムアウトを過ぎてしまった場合、追加のクエリを 送信する前に reconnect() メソッドを使ってサーバーの応答確認（pinging）するのを検討すべきです。 このメソッドは、適切に接続状態を維持したり、 再接続したりできます。
$this->db->reconnect();