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で Ajaxを使う方法の解説。3.6以降対応。Successとthenの両方を解説。

CakePHP3でajaxを利用する処理の実装方法を解説。プルダウンを変更するとデータベースの値を取得し検索結果の内容を変更するというような処理を想定。CakePHP3.6以降の CSRF対策対応済。

: CakePHP 2.3　ID以外のカラムでアソシエーション（連携）をさせる場合

ID以外のカラムでアソシエーション（連携）させるための考え方とサンプルソースを用いての説明を行っています。

: CakePHP4の数値項目は「like %10%」の部分一致検索（find select）はできない

CakePHP4でテーブルの数値項目に対してlike句を使用した部分一致検索を実行するとエラーが発生する。クリエービルダーの不具合だと思われ対処方法が分からない。

: CakePHP3でPHPExcelを使ってエクセルファイルを生成、出力する方法

CakePHP3でPHPExcelを利用してエクセルを編集、出力するサンプルソース＋解説。PHPExcelのインストール方法の解説からファイル保存とダウンロードの方法なども解説。

: CakePHP 2.3　ID以外のカラムでアソシエーション（連携）をさせる場合の詳細ページの注意点

ID以外のカラムでアソシエーション（連携）させて詳細ページを表示させる際の考え方と注意点をサンプルソースを用いて解説しています。

: CakePHP3チュートリアルで日付と時刻のDateTimeでエラーが出たときの対処方法

CakePHP3のブックマークチュートリアルには記載ミスもあり、そのまま動かない個所もある。CakePHP3では namespaceを使うようになったので、classを呼び出すときに￥を追加する必要が！

: CakePHP 2.x系　Viewでのコメントの記述方法など

CakePHPにおいて View、ctpファイルでコメントを記述する方法を解説。

: CakePHP 2.3 主キー（ID）以外のキーで更新方法 updateAll

主キー（ID）以外のカラムをキーとして更新する方法、updateAllの使い方をサンプルを用いて解説します。

: CakePHP3のCakeDC/UsersのUserHelperでログアウトやreCAPTCHAをカスタマイズ

CakeDC謹製Usersプラグインの紹介。UserHelperを利用し、ログアウトのリンクや権限があるときのみ表示されるリンク、プロフィールページへのリンク、reCAPTCHAの設置方法などを解説。

: CakePHP3でassociatedを使って関連データをまとめて保存する方法（hasOne、hasMany、belongsTo）

CakePHP3で関連データをまとめて保存する方法。hasOne、hasMany、belongsTo等の関連データはassociatedを追加することでまとめて保存することができます。

PREV: CakePHP4の数値項目は「like %10%」の部分一致検索（find select）はできない
NEXT: WindowsのXAMPPのPHPではstrptimeは使用不可。代替はdate_parse_from_formatを使う

日	月	火	水	木	金	土
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

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

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

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

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

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

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

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

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

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

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

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

select文実行の標準形

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

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

Insert文実行の標準形

Update文実行の標準形

Delete文実行の標準形

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

CakePHP4の関連記事

GoogleAdwords

GoogleAdwords

Message コメントをキャンセル

関連記事

CakePHP3で Ajaxを使う方法の解説。3.6以降対応。Successとthenの両方を解説。

CakePHP 2.3　ID以外のカラムでアソシエーション（連携）をさせる場合

CakePHP4の数値項目は「like %10%」の部分一致検索（find select）はできない

CakePHP3でPHPExcelを使ってエクセルファイルを生成、出力する方法

CakePHP 2.3　ID以外のカラムでアソシエーション（連携）をさせる場合の詳細ページの注意点

CakePHP3チュートリアルで日付と時刻のDateTimeでエラーが出たときの対処方法

CakePHP 2.x系　Viewでのコメントの記述方法など

CakePHP 2.3 主キー（ID）以外のキーで更新方法 updateAll

CakePHP3のCakeDC/UsersのUserHelperでログアウトやreCAPTCHAをカスタマイズ

CakePHP3でassociatedを使って関連データをまとめて保存する方法（hasOne、hasMany、belongsTo）

WordPress投稿にPHPを記述するショートコードの使い方add_shortcode

コピーコンテンツ対策.htaccessで直リンク禁止しリダイレクトで対応

評価点投票プラグイン10個を比較！WordPressで口コミサイトを構築

BackWPupでバックアップ・リストア（復元）の具体的手順

コンパクトキーボード・KEK-EA9AU・FKB1420の魅力