PHPのPDOでMariaDB(MySQL)への接続テスト

PHP

2018/11/08 (更新日：2019/04/28)

MariaDB^※1への接続テスト自体はHeidiSQLで十分ですが、PHPでPDOを使えるようにしておいたほうが良いよね、ってことで。

この記事で使っているソフトのバージョン情報

Windows 10 Pro (Version 1803)
nginx 1.14.0
PHP 7.2.11
MariaDB 10.3.10

参考記事

php.iniを編集し、PDOを使えるようにする

c:\php\php.iniの extension=pdo_mysql の部分が#でコメントアウトされているため、これを外すだけでPDOが使えるようになります。

PDOとは
PHP Data Objectの略で、PHPに拡張モジュールとして標準で提供されているデータベース接続／操作用のクラスです。これを使うことで、MySQLやPostgreSQLといった異なるデータベースでもほとんど同じコーディングをすることが可能になり、データベースを変更してもPHPスクリプトの変更が最小限で済むといったメリットがある上、プリペアドステートメントという機能が必須レベルに便利です。

"SELECT * FROM test WHERE test_id=?" というようにSQL文にプレースホルダ（クエスチョン記号）を記述して、入力値を置き換える仕組みがあり、置き換えた文字列はPDO側でエスケープ処理してくれるので、SQLインジェクションなどの脆弱性を回避することが可能となります。（まぁ、PDOに頼り切らず、入力値、特に$_POSTで渡された値は徹底的にサニタイズするのがプログラマーとしての義務ですけど）

要するに、mysql_ほにゃららや pgsql_ ほにゃららといった専用の関数使うより便利で安全よ！ということでOK。
というか、たしかmysql_ほにゃらら系は既に公式で非推奨関数になっていたような気もします。

PHPでPDO接続するスクリプトを書く

c:\nginx\htmlがドキュメントルートのため、その下に pdo.php というテキストファイル(※)を用意
UTF8 (BOMなし)で下記のようなPHPスクリプトを記述する

■PDOでMariaDBへ接続する例

<?php
//PDO設定
$pdo_dsn = 'mysql:host=localhost;dbname=test;charset=utf8;';
$pdo_user = 'root';
$pdo_pass = '********';
$pdo_option = array(
	PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
	PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
	PDO::ATTR_EMULATE_PREPARES => false,
	PDO::ATTR_STRINGIFY_FETCHES => false
);			
//データベース接続
try {
	$pdo = new PDO($pdo_dsn, $pdo_user, $pdo_pass, $pdo_option);
} catch (Exception $e) {
	header('Content-Type: text/plain; charset=UTF-8', true, 500);
	exit($e->getMessage());
}
?>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>PDO接続テスト</title>
</head>
<body>
<?php
//SQL発行
$stmt = $pdo->query("SELECT @@version");
while ($row = $stmt->fetch()) {
	print_r($row);
}
?>
</body>
</html>

■補足説明

$pdo_dsn = 'mysql:host=localhost;dbname=test;charset=utf8;';

この部分はPDOの接続情報で、データベースはMySQLを使ってますよー、接続先はlocalhost、データベース名はtestで、文字コードはutf8を使いますよー、という意味。

$pdo_user/$pdo_passはデータベース接続に使うユーザー名とパスワード。

$pdo_optionについては下記のとおり。

PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION PDO関連でエラーが発生した際、例外が発生するようになる。try～catchでエラー処理するならこれ一択。
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC レコード取得時($stmt->fetch())のデータは連想配列にするという意味。これがないと列名が使えない。
PDO::ATTR_EMULATE_PREPARES => false プリペアドステートメントのエミュレーションを行う(true)か行わない(false)かのオプション。ここは正直悩ましい。エミュレーションしたほうがパフォーマンスは高いけれど、細かい部分で挙動（型のキャストや複数SQLの実行等）が違ったりするので慣れないうちはエミュレーションなしのほうが良い、のかなぁ。
PDO::ATTR_STRINGIFY_FETCHES => false レコードを取得した際、数値を文字列化する(true)か、数値として扱う(false)か。でもこれ、上のエミュレーションfalseのときしか意味がなくて、エミュレーションした場合はどうやっても数値を文字列にしちゃうみたい。それはそういうものとわかっていれば何とでもなるけれど。

BOMとは
BOMとはByte Order Markの略で、保存されているデータのバイト順がビッグエンディアンなのかリトルエンディアンなのか判別するために3バイト分のマーキングをする仕組みです。（Intel/AMDなどのx86系はリトルエンディアン）

例えばUTF-16なら 0xFE 0xFF でビッグエンディアン、0xFF 0xFE でリトルエンディアンと判別されるのですが、そもそもUTF-8の場合はバイト順が決まっているので、付与するとしても 0xEF 0xBB 0xBF と決まっています。そのため、BOMを付与する意味がほとんどなく、無視されることが多い悲しいマーク。

何言ってるのかわかんねーよ、という場合はとりあえずHTMLやPHPスクリプトではBOMを付けない！と覚えておけばOK。テキストエディターの種類によってはBOMなしをUTF-8Nと表現する場合もあるのでその点は注意。