[PHPのはじめ方] Part22: PDOによるデータベース接続

はじめに：なぜPDO？ 🤔
PDO接続の基本ステップ 🚀
- 必要な情報：DSN、ユーザー名、パスワード
- 接続コード例
エラー処理：安全な接続のために🛡️
- エラーモードの設定：より詳細なエラー情報を得る
接続のクローズ（切断）🚪
まとめ 📝

はじめに：なぜPDO？ 🤔

Webアプリケーションを作る上で、データベースとの連携は欠かせません。ユーザー情報や商品データなどを保存し、必要に応じて取り出すことで、動的なWebサイトを実現できます。

PHPにはデータベースを操作する方法がいくつかありますが、現在主流となっているのがPDO (PHP Data Objects) です。PDOをおすすめする理由は以下の通りです。

データベースの種類に依存しない: MySQL、PostgreSQL、SQLiteなど、様々なデータベースに対応しています。もし将来的にデータベースを変更することになっても、コードの大部分をそのまま利用できます。
セキュリティが高い: プリペアドステートメントという機能を使うことで、SQLインジェクションなどの攻撃を防ぎやすくなります。（これは後のステップで詳しく学びます！）
統一されたインターフェース: どのデータベースを使う場合でも、基本的な操作方法（関数の使い方など）が同じなので、学習コストを抑えられます。

このステップでは、PDOを使ってPHPからMySQLデータベースに接続する基本的な方法を学びましょう！

PDO接続の基本ステップ 🚀

PDOを使ってデータベースに接続するには、`new PDO()` を使ってPDOクラスのインスタンスを作成します。その際に、接続に必要な情報を引数として渡します。

必要な情報：DSN、ユーザー名、パスワード

接続には主に以下の3つの情報が必要です。

DSN (Data Source Name): どのデータベースに接続するかを指定する文字列です。データベースの種類、ホスト名（サーバーのアドレス）、データベース名、文字コードなどを指定します。
データベースユーザー名: データベースにアクセスするためのユーザー名です。
パスワード: 上記ユーザーに対応するパスワードです。

DSNの書き方 (MySQLの場合)

MySQLに接続する場合のDSNは、一般的に以下のような形式で記述します。

mysql:host=[ホスト名];dbname=[データベース名];charset=[文字コード]

mysql: : 使用するデータベースドライバを指定します（MySQLの場合はこれ）。
host=[ホスト名] : データベースサーバーのホスト名またはIPアドレスを指定します。ローカル環境の場合は `localhost` や `127.0.0.1` が一般的です。
dbname=[データベース名] : 接続したいデータベースの名前を指定します。
charset=[文字コード] : データベースとの通信に使用する文字コードを指定します。通常は `utf8` または `utf8mb4` を指定します。(`utf8mb4` の方が絵文字などより多くの文字を扱えます。)

各項目は `;` (セミコロン) で区切ります。`:` (コロン) と間違えないように注意しましょう！

接続コード例

実際にPDOを使ってMySQLデータベースに接続するコードを見てみましょう。

<?php
// データベース接続情報
$dbHost = 'localhost';      // データベースサーバーのホスト名
$dbName = 'test_database';  // 使用するデータベース名
$dbUser = 'db_username';    // データベースユーザー名
$dbPass = 'db_password';    // データベースパスワード
$charset = 'utf8mb4';       // 文字コード

// DSN (Data Source Name) の作成
$dsn = "mysql:host={$dbHost};dbname={$dbName};charset={$charset}";

// データベースへの接続を試みる
try {
    // PDOインスタンスの作成
    $pdo = new PDO($dsn, $dbUser, $dbPass);

    // 接続成功時のメッセージ (オプション)
    echo 'データベースへの接続に成功しました！🎉';

    // ここにデータベース操作のコードを記述していく

} catch (PDOException $e) {
    // 接続失敗時のエラー処理
    // die() は処理を中断し、メッセージを表示する関数
    die('データベース接続エラー: ' . htmlspecialchars($e->getMessage(), ENT_QUOTES, 'UTF-8') . '');
}

// データベース接続を使用する処理が続く...
?>

このコードでは、まず接続情報を変数に格納し、それを使ってDSN文字列を組み立てています。そして、`new PDO()` で実際に接続を試みます。

エラー処理：安全な接続のために🛡️

データベースへの接続は、様々な理由で失敗する可能性があります（ホスト名が違う、パスワードが違う、データベースが存在しないなど）。接続に失敗した場合、プログラムが意図せず停止したり、エラー情報がそのまま画面に表示されてしまったりするのは避けたいですよね。

そこで重要になるのがエラー処理です。上記のコード例でも使われていますが、`try…catch` ブロックを使うのが一般的です。

tryブロック: データベース接続など、エラーが発生する可能性のある処理をこの中に記述します。
catchブロック: `try` ブロック内で `PDOException` という種類のエラー（例外）が発生した場合に、この中の処理が実行されます。エラーメッセージを表示したり、ログに記録したりする処理を記述します。

`catch (PDOException $e)` の `$e` には、発生したエラーに関する情報（エラーメッセージなど）が格納されています。`$e->getMessage()` で具体的なエラーメッセージを取得できます。

エラーモードの設定：より詳細なエラー情報を得る

PDOには、エラーが発生したときの挙動を設定する「エラーモード」があります。接続が成功した後、`setAttribute()` メソッドを使って設定するのが一般的です。

<?php
// (接続情報などは省略)

try {
    $pdo = new PDO($dsn, $dbUser, $dbPass);

    // エラーモードを「例外をスローする」モードに設定
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    echo 'データベースへの接続とエラーモード設定に成功しました！✨';

} catch (PDOException $e) {
    die('データベース関連エラー: ' . htmlspecialchars($e->getMessage(), ENT_QUOTES, 'UTF-8') . '');
}
?>

$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); を設定することで、接続時だけでなく、その後のデータベース操作（SQLの実行など）でエラーが発生した場合も `PDOException` が発生するようになります。これにより、`try…catch` で一貫したエラー処理が可能になります。

エラーモードにはいくつか種類がありますが、開発中は `PDO::ERRMODE_EXCEPTION` を設定しておくのがおすすめです。エラーの原因を特定しやすくなります。

エラーモード	説明	備考
`PDO::ERRMODE_SILENT`	エラーコードのみを設定します (デフォルト ※PHP 8.0未満)。エラー発生に気づきにくい可能性があります。	非推奨
`PDO::ERRMODE_WARNING`	エラーコードを設定し、さらにPHPの警告 (E_WARNING) を発生させます。	デバッグ時に役立つこともありますが、例外処理の方が推奨されます。
`PDO::ERRMODE_EXCEPTION`	エラーコードを設定し、PDOException をスローします (デフォルト ※PHP 8.0以降)。`try…catch` でのエラー処理と相性が良いです。	推奨 ✨

PHP 8.0からは `PDO::ERRMODE_EXCEPTION` がデフォルトになりましたが、明示的に設定しておくことを推奨します。

接続のクローズ（切断）🚪

データベースへの接続は、スクリプトの実行が終了すると通常は自動的に閉じられます。しかし、明示的に接続を閉じたい場合は、PDOオブジェクト（例： `$pdo`）に `null` を代入します。

<?php
// (接続処理など...)

// データベース操作が完了したら接続を閉じる
$pdo = null;

echo 'データベース接続を閉じました。';
?>

長時間の処理やリソースを効率的に使いたい場合に、明示的なクローズを検討しましょう。

まとめ 📝

今回は、PHPからMySQLデータベースに接続するための第一歩として、PDOの基本的な使い方を学びました。

PDOはデータベースの種類に依存しない接続方法を提供します。
接続にはDSN、ユーザー名、パスワードが必要です。
`new PDO()` で接続インスタンスを作成します。
`try…catch` でエラー処理を行うことが重要です。
`$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);` でエラーモードを設定すると、エラーハンドリングがしやすくなります。
接続は通常自動で閉じられますが、`$pdo = null;` で明示的に閉じることもできます。

これでデータベースに接続する準備が整いました！次のステップでは、実際にデータベースからデータを取得したり、データを追加・更新・削除したりする方法（SELECT, INSERT, UPDATE, DELETE）を学んでいきましょう。お楽しみに！ 😊