CakePHP4から外部のデータベースにアクセスする方法解説

2024/08/02 2024/08/10

CakePHP4から外部のデータベースにアクセスする方法解説

　
CakePHP4では標準（デフォルト）でデータベースにアクセスする方法が用意されていますが、標準で接続するデータベース以外の、他のシステムのデータベースに接続する方法について解説します。
　

　
　
他のシステムのデータベースに接続する方法は下記の 2つあります。
　
・CakePHP4 の標準設定をコピペして使用する方法
・MySQL の接続コマンドを利用する方法
　
いずれも簡単な記述で接続できます。
また、接続を確立した後の SQL文の実行はどちらも同じ手続きになります。
　
それぞれ説明をしていきます。
　
　

CakePHP4 の標準設定をコピペして使用する方法

データベースへの接続情報を記述・app.php

　
/config/app.php の 285行目付近の「Datasources」にデータベースの接続が記述されています。
この接続情報の中の 340行目付近の「test」の配列をコピペし、下記の 14行目の配列のキーを「sample」のように変更します。
　
複数の単語からなる文字列にする場合は、ローワーキャメルケース（「sampleTestTest」のような 1文字目は小文字のキャメルケース）を使用するようです。
　
また、接続するデータベースの設定に合わせて、「timezone」や「encoding」を変更します。
　

'test' => [
  'className' => Connection::class,
  'driver' => Mysql::class,
  'persistent' => false,
  'timezone' => 'UTC',
  //'encoding' => 'utf8mb4',
  'flags' => [],
  'cacheMetadata' => true,
  'quoteIdentifiers' => false,
  'log' => false,
  //'init' => ['SET GLOBAL innodb_stats_on_metadata = 0'],
],

'sample' => [
  'className' => Connection::class,
  'driver' => Mysql::class,
  'persistent' => false,
  'timezone' => 'UTC',
  //'encoding' => 'utf8mb4',
  'flags' => [],
  'cacheMetadata' => true,
  'quoteIdentifiers' => false,
  'log' => false,
  //'init' => ['SET GLOBAL innodb_stats_on_metadata = 0'],
],

'test' => [

'className' => Connection::class,

'driver' => Mysql::class,

'persistent' => false,

'timezone' => 'UTC',

//'encoding' => 'utf8mb4',

'flags' => [],

'cacheMetadata' => true,

'quoteIdentifiers' => false,

'log' => false,

//'init' => ['SET GLOBAL innodb_stats_on_metadata = 0'],

'sample' => [

'className' => Connection::class,

'driver' => Mysql::class,

'persistent' => false,

'timezone' => 'UTC',

//'encoding' => 'utf8mb4',

'flags' => [],

'cacheMetadata' => true,

'quoteIdentifiers' => false,

'log' => false,

//'init' => ['SET GLOBAL innodb_stats_on_metadata = 0'],

データベースへの接続情報を記述・app_local.php

　
続けて、/config/app_local.php の 40行目付近から始まる「Datasources」の中にある「test」をコピペして、下記の 11行目の配列のキーを「sample」のように変更します。
　
加えて、接続するデータベースの接続情報を記載します。
（DBの接続情報を「app_local.php」を使わず、「app.php」に直接記述している場合や、「.env」を利用している場合はそれぞれ読み替えて設定をしてください。）
　

'test' => [
  'host' => 'localhost',
  //'port' => 'non_standard_port_number',
  'username' => 'my_app',
  'password' => 'secret',
  'database' => 'test_myapp',
  //'schema' => 'myapp',
  'url' => env('DATABASE_TEST_URL', 'sqlite://127.0.0.1/tmp/tests.sqlite'),
],

'sample' => [
  'host' => 'localhost',
  'port' => '33060',
  'username' => 'sample_user',
  'password' => '123456',
  'database' => 'sample_db',
  //'schema' => 'myapp',
  'url' => env('DATABASE_SAMPLE_URL', null),
],

'test' => [

'host' => 'localhost',

//'port' => 'non_standard_port_number',

'username' => 'my_app',

'password' => 'secret',

'database' => 'test_myapp',

//'schema' => 'myapp',

'url' => env('DATABASE_TEST_URL', 'sqlite://127.0.0.1/tmp/tests.sqlite'),

'sample' => [

'host' => 'localhost',

'port' => '33060',

'username' => 'sample_user',

'password' => '123456',

'database' => 'sample_db',

//'schema' => 'myapp',

'url' => env('DATABASE_SAMPLE_URL', null),

データベースへの接続と SQLの実行

　
データベースの接続を実行する記述方法はシンプルで、下記の記述で接続ができます。
　
「ConnectionManager::get()」のパラメータに、前項で指定した「sample」を記述することで接続ができます。
　

// データベースへの接続
$sampleConnection = ConnectionManager::get('sample');

// SQL の SELECT文の実行
$sampleResults = $sampleConnection
  ->execute('SELECT * FROM sample_table')
  ->fetchAll('assoc');

// データベースへの接続

$sampleConnection = ConnectionManager::get('sample');

// SQL の SELECT文の実行

$sampleResults = $sampleConnection

->execute('SELECT * FROM sample_table')

->fetchAll('assoc');

　
上記の内容は、SQLを実行するコントローラー内に記述します。
　
　

MySQL の接続コマンドを利用する方法

データベースへの接続情報を記述

　
データベースの接続情報を設定します。
　

define("SAMPLE", [
  "host"      => "localhost",
  "port"      => "33060",
  "users"     => "sample_user",
  "password"  => "123456",
  "database"  => "sample_db",
]);

define("SAMPLE", [

"host" => "localhost",

"port" => "33060",

"users" => "sample_user",

"password" => "123456",

"database" => "sample_db",

]);

　
上記の定数は、コントローラ内に記述してもいいですし、下記の記事にあるように、定数ファイルを作成し、そこに記述する方法もあるかと思います。
「CakePHP4で定数の設定と呼び出し方法の解説（defineとConfigure）」
「CakePHP4の定数定義ファイルを環境変数によって本番と開発を振り分ける方法解説」
　
　
また、今回はサンプルとして、データベース接続情報を定数として設定していますが、下記の「データベースの接続」のところに直書きしても問題ありません。
　
　

データベースへの接続と SQLの実行

　
続けて、データベースに接続し、SQLを実行する処理が下記となります。
　

// データベースへの接続
$dsn = 'mysql://' . SAMPLE["users"] . ':' . SAMPLE["password"] . '@' . SAMPLE["host"] . ":" . SAMPLE["port"] . '/' . SAMPLE["database"];
ConnectionManager::setConfig('sample', ['url' => $dsn]);
$sampleConnection = ConnectionManager::get('sample');

// SQL の SELECT文の実行
$sampleResults = $sampleConnection
  ->execute('SELECT * FROM sample_table')
  ->fetchAll('assoc');

// データベースへの接続

$dsn = 'mysql://' . SAMPLE["users"] . ':' . SAMPLE["password"] . '@' . SAMPLE["host"] . ":" . SAMPLE["port"] . '/' . SAMPLE["database"];

ConnectionManager::setConfig('sample', ['url' => $dsn]);

$sampleConnection = ConnectionManager::get('sample');

// SQL の SELECT文の実行

$sampleResults = $sampleConnection

->execute('SELECT * FROM sample_table')

->fetchAll('assoc');

　
上記の内容は、SQLを実行するコントローラー内に記述します。
「SQL の SELECT文の実行」の部分の記述は、先に説明した「CakePHP4 の標準設定をコピペして使用する方法」の処理と同一です。
　
　

CakePHP4から外部のデータベースにアクセスする方法の違い

　
この記事では、CakePHP4から外部のデータベースにアクセスする方法が 2つあることを解説しました。
　
・CakePHP4 の標準設定をコピペして使用する方法
・MySQL の接続コマンドを利用する方法
　
上記の 2つのどちらがいいか、は好みの問題だと思います。
　
CakePHP4　Cookbook　データベースの基本
https://book.cakephp.org/4/ja/orm/database-basics.html
　
ただ、上記のオフィシャルサイトには「データベース接続を作る一番簡単な方法」として「MySQL の接続コマンドを利用する方法」の方が紹介されています。
　
接続方法としてはどちらもかなり簡単なので、どちらでもいいかと思いますが、開発環境と本番環境でデータベースの接続先を変更するような場合は、「MySQL の接続コマンドを利用する方法」を利用し、データベースの接続先を環境ごとの定数ファイルで管理する方法がより簡単なのかな、と思います。
　
先にも紹介しましたが、環境ごとに定数ファイルを作成する方法については下記の記事を参考にしてください。
「CakePHP4で定数の設定と呼び出し方法の解説（defineとConfigure）」
「CakePHP4の定数定義ファイルを環境変数によって本番と開発を振り分ける方法解説」
　
　

データベースの接続情報オブジェクトを利用して SQL文を実行する

select文実行の標準形

　
データベースの接続情報を持つオブジェクトを利用し、SQLの実行は下記のように記述を行います。
　

// SQL の SELECT文の実行
$sampleResults = $sampleConnection
  ->execute("SELECT * FROM sample_table")
  ->fetchAll("assoc");

// SQL の SELECT文の実行

$sampleResults = $sampleConnection

->execute("SELECT * FROM sample_table")

->fetchAll("assoc");

select文実行・where句はプリペアドステートメントを使用する

　
where句で条件を追加する際は、セキュリティを考慮してプリペアドステートメントを使用します。
　

// SQL の SELECT文の実行
$sampleResults = $sampleConnection
  ->execute('SELECT * FROM sample_table where height = :height and weight = :weight',
  ["height" => 170, "weight" => 60])
  ->fetchAll("assoc");

// SQL の SELECT文の実行

$sampleResults = $sampleConnection

->execute('SELECT * FROM sample_table where height = :height and weight = :weight',

["height" => 170, "weight" => 60])

->fetchAll("assoc");

select文実行・CakePHPのクリエビルダーを使用する

　
SQL文を書かずに、クリエービルダーを使用することもできます。
　

$sampleResults = $sampleConnection
    ->newQuery()
    ->select("*")
    ->from("sample_table")
    ->where(["height" => 170, "weight" => 60])
    ->order(["name" => "ASC"])
    ->execute()
    ->fetchAll("assoc");

$sampleResults = $sampleConnection

->newQuery()

->select("*")

->from("sample_table")

->where(["height" => 170, "weight" => 60])

->order(["name" => "ASC"])

->execute()

->fetchAll("assoc");

Insert文実行の標準形

　
Insertの処理も非常に簡単です。
Insertの SQLを実行してもいいのですが、下記のように記述することで Insertを実行することができます。
　

$insertData = [
  "id"      => 1,
  "name"    => "名前１",
  "height"  => "171",
  "weight"  => "61",
];
$sampleConnection->insert("sample_table", $insertData);

$insertData = [

"id" => 1,

"name" => "名前１",

"height" => "171",

"weight" => "61",

];

$sampleConnection->insert("sample_table", $insertData);

　
ちなみに、上記の Insertを実行しても自動的に「created」「modified」のカラムを編集する処理はありませんので、必要に応じて「created」「modified」の値を編集しておく必要があります。
　
　

Update文実行の標準形

　
Updateの処理も非常に簡単です。
　

$updateData = [
  "height"  => "176",
  "weight"  => "66",
];
$sampleConnection->update("sample_table", $updateData, ["id" => 1]);

$updateData = [

"height" => "176",

"weight" => "66",

];

$sampleConnection->update("sample_table", $updateData, ["id" => 1]);

　
上記を SQLに書き直すと下記になります。

update sample_table set height = 176, weight = 66 where id = 1;

1	update sample_table set height = 176, weight = 66 where id = 1;

Delete文実行の標準形

　
Deleteの処理も非常に簡単です。
　

$sampleConnection->delete("sample_table", ["id" => 1]);

1	$sampleConnection->delete("sample_table", ["id" => 1]);

SQL文実行に際しては「try – catch」を利用する

　
SQL文の実行処理は簡単ですが、この記述だけで処理をすると、エラーが発生したときに処理が止まってしまいます。
そのため、プログラムとして実装する場合は「try – catch」を利用してエラーへの対処をしておく必要があるかと思います。
　

try {
  // SQL の SELECT文の実行
  $sampleResults = $sampleConnection
    ->execute("SELECT * FROM sample_table")
    ->fetchAll("assoc");
} catch (\Exception $e) {
  // エラーが発生したときはログを出力
  $this->log($e->getMessage(), "error", ['scope' => ['sqlError']]);
}

try {

// SQL の SELECT文の実行

$sampleResults = $sampleConnection

->execute("SELECT * FROM sample_table")

->fetchAll("assoc");

} catch (\Exception $e) {

// エラーが発生したときはログを出力

$this->log($e->getMessage(), "error", ['scope' => ['sqlError']]);

}

　
上記のサンプルは Selectの実行ですが、同様に Insert、Update、Deleteを実行するときも「try – catch」を利用してエラーの対処をするものかと思います。
　
　
また、ログ出力に関しては下記に記事を書いていますので参考にしてください。
CakePHP4でロギングスコープやログレベルを使用してログを出し分ける方法を解説
　
　

- CakePHP 3.x 4.x CakePHP4

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: CakePHP3で /Layout/defult.ctpにある titleタグ、h1タグを編集する方法

CakePHP3でtitleタグ、h1タグのテキストをデフォルトから変更する方法を解説。テンプレートファイルに「$this->assign()」でテキストを指定して「/Layout/defult.ctp」で受け取る。

: CakePHP 2.3でファイルをアップロード・その2　ファイル名を乱数で設定

CakePHPのアップロードするファイル名を乱数で変更しセキュリティを高める方法を解説。

: URL短縮サービス「TTTオンライン（https://ttt.onl）」公開

URL短縮サービス「TTTオンライン（https://ttt.onl）」を公開。メールやSNSでは使いにくい長いURLを短いURLに変換するサービス。QRコードも。Google URL Shortenerが2019年3月にサービス終了。

: CakePHP4のユーザ管理・ログイン認証プラグインCakeDC/Usersのインストール解説

CakePHP4のユーザ管理プラグイン Usersは、ユーザ登録、メール認証、ログイン認証、ユーザ管理、権限管理、reCAPTCHAなど会員制のサイトを簡単に実現可能。その導入方法、カスタマイズ方法を解説。

: CakePHPで Auto Incrementを外すと Duplicate entry ‘0’ for keyのエラーが出るかも

CakePHPでAuto Incrementの設定を変更したときに「Duplicate entry ‘0’ for key」のエラーが出た。原因はModel内で IDを編集する処理の追加を忘れていたからだった。

: CakePHP 2.3 コマンドラインからPHPのシェル実行の方法解説

CakePHP 2.3でコマンドラインから CakePHPで記述した処理を実行する方法を解説します。

: Windows環境の XAMPPを利用して CakePHPの開発する際の注意点

WindowsベースにXAMPPで環境を構築しCakePHP4を利用したWebシステムを構築する際は、大文字と小文字の違いを意識する必要がある。LinuxベースのWebサーバに移動させたときに不具合で動作しないこともある。