単体のORMライブラリとしてEloquentを使う

1 はじめに
2 Eloquentとは
3 導入
- 3.1 Composerインストール
- 3.2 Eloquentインストール
4 DB接続
5 さいごに
6 おすすめ書籍

はじめに

こんにちは。先日から、今となっては珍しい(多分)、フレームワーク無しのPure PHPで構築されているプロジェクトに関わっています。
フレームワークを使うことが絶対正しいというわけではないのですが、エンジニアが数人関わる状況で個々がコードを書き散らす状況も生まれていて、せめてDBアクセス部分だけでも統一化するため、ORMの導入を検討した結果、現状で使用例が多そうなEloquentを採用しました。
今回の記事は導入からベーシックな使い方までの備忘録的なものです。

Eloquentとは

ORMのひとつで、PHPフレームワークのLaravelで採用されています。RailsのORMであるActiveRecordライクに使えるとのこと。
一方でDBファサードというクエリビルダも含んでおり、こちらは生でSQLを組み立てていくのに近い形で使えます。
前者は単純なCRUDをする時に、後者は複雑なテーブル結合をしつつ COUNT() の結果だけが欲しい、というような集計系の実装で…という感じで使い分けるといいのかな、と感じています。
Laravel5のアーキテクチャから学ぶより良いクラス設計

ORMって何ぞ？という方はこちらをどうぞ。
オブジェクト関係マッピング
 Ormとの付き合い方

導入

稼働中のプロジェクトに組み込むので、なるべく他のコードは汚したくありません。プロジェクト内の任意の場所に新しくディレクトリを作成し、その中でComposerを使いインストールします。
私はCentOS6および7で確認していますが、PHPさえインストールされていれば、OS環境による差異は無いと思います。
導入手順はこちらのページをお読みいただければ、ほぼ完結します。

Composerインストール

PHPのパッケージ管理ツールComposerは、2018年10月現在、PHP5.3.2以上で動作します。現在サポートが続いてるCentOS6のBaseリポジトリでyum installできるバージョンが5.3.3ですから、それに合わせているのでしょうか。
ただし5.3系でComposerを入れようとすると、PHPのアップデートを促す警告がしつこいくらい出ます。PHP5.6すら2018年いっぱいでサポートが切れますので、当然ですね…。

 $ mkdir ./src && cd ./src $ curl -sS https://getcomposer.org/installer | php All settings correct for using Composer Downloading... Composer (version 1.7.2) successfully installed to: /home/nomura/src/composer.phar Use it: php composer.phar

$ mkdir ./src && cd ./src

$ curl -sS https://getcomposer.org/installer | php

All settings correct for using Composer

Downloading...

Composer (version 1.7.2) successfully installed to: /home/nomura/src/composer.phar

Use it: php composer.phar

Eloquentインストール

composerでインストールする illuminate/database がパッケージ名で、このパッケージで実装されているORMがEloquentです。
illuminate/database はORMとクエリビルダを内包していて、それぞれの記述方法でDBにアクセスできます(後述)。

 $ ./composer.phar require illuminate/database Using version ^5.7 for illuminate/database ./composer.json has been created Loading composer repositories with package information Updating dependencies (including require-dev) Package operations: 10 installs, 0 updates, 0 removals As there is no 'unzip' command installed zip files are being unpacked using the PHP zip extension. This may cause invalid reports of corrupted archives. Installing 'unzip' may remediate them. - Installing symfony/polyfill-mbstring (v1.9.0): Loading from cache ... ... illuminate/database suggests installing illuminate/pagination (Required to paginate the result set (5.7.*).) Writing lock file Generating autoload files

$ ./composer.phar require illuminate/database

Using version ^5.7 for illuminate/database

./composer.json has been created

Loading composer repositories with package information

Updating dependencies (including require-dev)

Package operations: 10 installs, 0 updates, 0 removals

As there is no 'unzip' command installed zip files are being unpacked using the PHP zip extension.

This may cause invalid reports of corrupted archives. Installing 'unzip' may remediate them.

- Installing symfony/polyfill-mbstring (v1.9.0): Loading from cache

...

illuminate/database suggests installing illuminate/pagination (Required to paginate the result set (5.7.*).)

Writing lock file

Generating autoload files

DB接続

illuminate/database

公式のREADME.mdを参考にするだけで、ほぼ迷うことはないと思います(和訳もありました)。
このページを参考に、PHPからDB接続するコードを作成します(下記コードはローカルのMySQLに接続する方法です)。

vi ./database.php

 <?php use Illuminate\Database\Capsule\Manager as Capsule; $capsule = new Capsule; $capsule->addConnection([ 'driver' => 'mysql', 'host' => 'localhost', 'database' => 'database', 'username' => 'root', 'password' => 'password', 'charset' => 'utf8', 'collation' => 'utf8_unicode_ci', 'prefix' => '', ]); $capsule->setAsGlobal(); $capsule->bootEloquent();

<?php

use Illuminate\Database\Capsule\Manager as Capsule;

$capsule = new Capsule;

$capsule->addConnection([

'driver' => 'mysql',

'host' => 'localhost',

'database' => 'database',

'username' => 'root',

'password' => 'password',

'charset' => 'utf8',

'collation' => 'utf8_unicode_ci',

'prefix' => '',

]);

$capsule->setAsGlobal();

$capsule->bootEloquent();

以上がDB接続のために最低限必要なコードとなり、上記コードを記述したPHPファイルを読み込めばOKです。

モデルクラス作成

illuminate\Database\Eloquent\Model を継承したクラスを作成します。

vi ./User.php

 <?php require_once dirname(__FILE__).'/database.php'; use Illuminate\Database\Eloquent\Model; class User extends Model {}

<?php

require_once dirname(__FILE__).'/database.php';

use Illuminate\Database\Eloquent\Model;

class User extends Model {}

実際に使う

 <?php define('SRC_DIR', dirname(__FILE__)); require_once(SRC_DIR . '/vendor/autoload.php'); require_once(SRC_DIR . '/database.php'); require_once(SRC_DIR . '/User.php'); $users = User::all(); // *1 $users_array = $capsule::table('users')->where('name', '=', 'taro')->get(); // *2 $users = User::hydrate($users_array); // *3

<?php

define('SRC_DIR', dirname(__FILE__));

require_once(SRC_DIR . '/vendor/autoload.php');

require_once(SRC_DIR . '/database.php');

require_once(SRC_DIR . '/User.php');

$users = User::all(); // *1

$users_array = $capsule::table('users')->where('name', '=', 'taro')->get(); // *2

$users = User::hydrate($users_array); // *3

*1〜*3は、いずれもUserテーブルからレコードを取得しています。メソッド名の意味が全く違うので想像しやすいと思いますが、それぞれ違う検索をしています。

*1はEloquent入門的なコードでよく出てきますが、全件取得メソッドです。総レコード数が10件などの小さなテーブルならいいのですが、レコードが1000件あるテーブルなら1000件取得してしまうので、実際は*2や*3のようなコードをよく使うと思います。
*2は前述のDBファサードによる検索で、ORMではなくクエリビルダを使って検索を実行しています。一見してどんなクエリが作られるのか想像しやすいのがメリットだと思いますが、返ってくるデータは配列です。
せっかくEloquentを導入しているのにモデルクラスのメソッドを使えないのは勿体無いので、なるべくモデルクラスとして取得したいところです。
ただし*2は複数のテーブルをJOINするなどの複雑なクエリを構築しやすく、集計系の機能にはこちらが向いているかと思っています。
*3のように hydrate() を使うと、*2で取得した配列をCollectionに変換して返してくれます。Collectionは配列のように扱えて、foreachなどでレコードを1行ずつモデルクラスとして取得できます。

さいごに

EloquentをORMライブラリとして使うにあたり、導入はとても簡単で、かつ既存コードへの影響を抑えられるのが有り難いです。また、ActiveRecordライクなORMということで、他言語のORMを使う際も理解が早くなりそうという期待もあります。

日	月	火	水	木	金	土
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30	31

単体のORMライブラリとしてEloquentを使う

はじめに

Eloquentとは

導入

Composerインストール

Eloquentインストール

DB接続

illuminate/database

モデルクラス作成

実際に使う

さいごに

おすすめ書籍

フォロー

アプリ情報