PHP、PDOの例外処理について

Question

PDO利用時の例外処理について
調べてもどれがベストなのか、正解が出てこなかったので質問させてください。

PDOのエラー発生時に例外を投げるように設定しています。

try {
    $pdo = new PDO($dsn, $user, $pass, $options);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    // なんかの処理

} catch (PDOException $ex) {
    // 例外処理
}

とした場合、順序として

1. エラー発生時、自動的にPDOがPDOExceptionを投げる
2. 投げられたPDOExceptionをcatchで受け取る

ということは理解しました。

しかし、本やネットによっては

try {
    $pdo = new PDO($dsn, $user, $pass, $options);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    // なんかの処理

} catch (Exception $ex) {
    // 例外処理
}

としているところもありました。(Exceptionを受け取っている)

継承の関係でExceptionでも受け取れる
ということも、なんとなく…、ですが一応理解しました。

じゃあ、catch時、Exceptionで受け取った場合とPDOExceptionで受け取った場合の違いって、一体何なんでしょうか？
どちらで書くべきですか？

---

それとすみません、関連した質問として
VBAのGotoステートメントのように例外を分けたいのですが

try {
    // なんかの処理
    if ($err1) throw new Exception("", 10);
    if ($err2) throw new Exception("", 20);
    if ($err3) throw new Exception("エラーが発生しました。", 99);

} catch (Exception $ex) {
    // 例外処理
    if ($ex->getCode() === 99){
        echo $ex->getMessage();
    } else{
        header("HTTP/1.0 404 Not Found");
        exit();
    }
}

といった感じで
投げたCodeで処理を分けるのって、一般的に見てアリですか？
(イマイチExceptionの使い方が分からなかったので…)

Answer 1

複数型のExceptionそれぞれ別々にCatchしたい場合以下のようにしてください。

try {
    $pdo = new PDO($dsn, $user, $pass, $options);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    // なんかの処理
} catch (PDOException $ex) {
    // PDOExceptionをCatchしたときの例外処理
    //   DB接続ができなかったのでDBのCloseなどは不要
} catch (Exception $ex) {
    // ExceptionをCatchしたときの例外処理
    //   「なんかの処理」でファイルオープンに失敗していた。
    //       PDOExceptionじゃ無かったのでDBへの接続はできている。
    //       DBのClose処理が必要
}

以下のように書くとすべてのExceptionをcatchします。

try {
    $pdo = new PDO($dsn, $user, $pass, $options);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    // なんかの処理
} catch (Exception $ex) {
    // すべてのException(PDOExceptionも含む)をCatchしたときの例外処理
}

---

それとすみません、関連した質問として
VBAのGotoステートメントのように例外を分けたいのですが
・・・略・・・
投げたCodeで処理を分けるのって、一般的に見てアリですか？

局所的なものなら問題ないんじゃないですかね？
以下のように自分でExceptionを作成することもできます。（実行確認してませんのであくまで参考です。）

class SystemException extends Exception {
  public function __construct(){
    parent::__construct('500 Internal Server Error');
}

class NotFoundException extends Exception {
  public function __construct(){
    parent::__construct('404 Not Found');
}

try {
    if ($err1) throw new NotFondException("");
    if ($err2) throw new NotFondException("");
    if ($err3) throw new SysFondException("");
} catch (NotFoundException $nfex) {
        header("HTTP/1.0 " . $nfex->getMessage());
        exit();
} catch (SystemException $sysex) {
        header("HTTP/1.0 " . $sysex->getMessage());
        // エラーログ出力など
        exit();
}

Answer 2

私も「Exceptionで受け取った場合とPDOExceptionで受け取った場合の違い」について気になります。

同じく勉強中でして、直接的な回答ができなく申し訳ないです。

PHPマニュアルの「例外」には下記の記述があります。

スローされるオブジェクトは、ExceptionクラスあるいはExceptionのサブクラスのインスタンスでなければなりません。それ以外のオブジェクトをスローしようとするとPHPの Fatal Error が発生します。

Exceptionに関しては下記の記述があります。

Exception は、PHP 5 ではすべての例外の基底クラスです。 PHP 7 では、すべてのユーザー例外の基底クラスとなります。

PDOExceptionはExceptionを継承した子クラス（サブクラス）です。
そのため、ExceptionクラスとPDOExceptionクラスはスローするオブジェクトとして指定できます。

ここまで質問に記載されておりますので、ご存じかと思います。

この2つの違いですが、例外には種類があります。

引用：PHP7で堅牢なコードを書く - 例外処理、表明プログラミング、契約による設計

主にLogicException系とRuntimeException系があります。
それぞれの違いは下記の通りです。

LogicException … 自身のコード，あるいはそれを利用している第三者のコードにバグがあることを示す例外．
RuntimeException … 正しく取り扱っていても起こりうる例外．

引用：お前は PHP 7 における Fatal Error / Catchable Fatal Error / Error / ErrorException / Exception の違いを言えるか？

おそらく、何の例外か使い分けるためなのかと思います。
ただ、勉強中の素人でして、実例を出して使い分けることでこのようなときにこのようなメリットがあると示すことができません。
ですので、あくまでも推察になります。

どちらで書くべきですか？

上記に関してですが、PDOクラスは「指定されたデータベースへの接続に失敗した場合、 PDOException を投げます。」とPHPマニュアルに記載されております。

データベース接続に関しての例外は、PDOExceptionを使う方が良いのではないかと考えております。

あくまで、私の推察であり実例を示した根拠がありません。
上記に関して、エンジニアの方々、識者の方々の意見が出てくれば、そちらを優先してください。
また、私の回答に誤りなどあれば、ご指摘ください((_ _ (´ω｀ )ﾍﾟｺ

Answer 3

Exceptionで受け取った場合

Exceptionで受け取るんですからPDO以外の例外処理も受け取れるでしょう

set_error_handler('myErrorHandler');
function myErrorHandler($errno, $errstr, $errfile, $errline)
{
  switch($errno) {
  case E_NOTICE:
    throw new exception("common notice:".$errstr."<br>");
    break;
  case E_USER_NOTICE:
    throw new exception("my notice:".$errstr."<br>");
    break;
  default:
    return false;
  }
  return true;
}

的な定義をしておいて

try{
  if(!isset($a)) trigger_error("no a!",E_USER_NOTICE);
}catch(exception $e){
  print $e->getMessage();
}

try{
  print $a;
}catch(exception $e){
  print $e->getMessage();
}

など場合分けができます