今回はPHPからMySQLに接続する方法を、初心者にも分かりやすく説明しようと思います。

PHPからデータベースに接続する方法はいくつかありますが、今回は「PDO」を使って説明していきます。

mysqliという関数を使う方法もありますが、PDOはMySQLに限らず複数のデータベースに対応できるため、覚えておいて損はありません。

今回は「test」というデータベースを用意したので、接続していきましょう。

PDOとは？

PDOはPHP Data Objectsの略で、データベース接続クラスのことです。

データベース操作はシステムごとに命令が異なりますが、PDOなら同じ関数で操作することが可能です。

PDOの書き方

$dbh = new PDO($dsn, $user, $pass, $opt);

PDOを使ってデータベースに接続するときはこのような形になります。

$dbh：データベースハンドル（Database Handle）の略。これ以降のDB操作はこの変数を通して行います
new PDO：PDOクラスのインスタンスを生成するという意味です
$dsn：接続先データベースの情報を文字列で渡します

今回の場合、$dsn はこのようになります。

$dsn = 'mysql:host=localhost;dbname=test;charset=utf8mb4';

※charsetはutf8ではなくutf8mb4を推奨します。utf8mb4 は絵文字や一部の漢字にも対応しているため、現在はこちらが標準です。

$userと$passには接続するユーザー名とパスワードを入れます。

初期設定ではrootになっていることが多いですが、本番環境では必ず専用ユーザーを作成し、rootをそのまま使うのは避けてください。

データベースに接続してみる

<?php
$dsn  = 'mysql:host=localhost;dbname=test;charset=utf8mb4';
$user = 'root'; // 設定したユーザー名を入れてください
$pass = 'root'; // 設定したパスワードを入れてください

$dbh = new PDO($dsn, $user, $pass);

var_dump($dbh);
?>

PHPファイルをブラウザで開くと、PDOオブジェクトが返されていれば接続成功です。

ただ、これだけだと接続に成功したのか失敗したのか分かりづらいですよね。そのため、接続に失敗したときの処理を追加する必要があります。

try〜catchとは？

接続失敗などのエラーが発生したときに備えて、try〜catch を使います。これは「例外処理」と呼ばれる構文で、エラー発生時の処理を記述することができます。

try {
    // 接続に成功したときの処理を書く
} catch() {
    // エラーが発生したときの処理を書く
}

try〜catchを使う前に、PDOにオプションを追加してSQLエラーを例外として投げるよう設定します。

$dbh = new PDO($dsn, $user, $pass, [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, // エラーを例外として投げるオプション
]);

PHP 8.0以降ではこのオプションがデフォルトになっています。PHP 7系を使っている場合は明示的に指定しておきましょう。

try〜catchを組み合わせると、全体はこのようになります。

<?php
$dsn  = 'mysql:host=localhost;dbname=test;charset=utf8mb4';
$user = 'root'; // 設定したユーザー名を入れてください
$pass = 'root'; // 設定したパスワードを入れてください

try {
    $dbh = new PDO($dsn, $user, $pass, [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    ]);
    echo '接続成功';
    $dbh = null; // 接続を明示的に切断する
} catch (PDOException $e) {
    echo '接続失敗: ' . $e->getMessage();
    exit();
}
?>

$e->getMessage()：catchで受け取ったエラーオブジェクトからエラーメッセージを取り出して表示します
exit()：エラー時にそれ以降の処理を止めます
$dbh = null：接続を明示的に切断します。PHPのガベージコレクションに任せず、自分で閉じるのがベストプラクティスです

PHPファイルを開いて「接続成功」と表示されれば完了です。

試しにユーザー名をわざと間違えてみると、「接続失敗」とエラー内容が表示されるはずです。例外処理がきちんと動いていることを確認できますね。

まとめ

データベースに接続できましたでしょうか？

次回はデータベースから要素を取り出す方法についても書いていこうと思います。お疲れ様でした！