PHPのエラー処理入門！try-catch構文で安全なパラメータ処理を実装しよう

2025年9月27日

詳細ページのように、URLからidなどのパラメータを受け取って動作するプログラムには、常にある種のリスクが伴います。もしURLにidが指定されなかったり、数字ではない不正な値が入力されたりしたら、どうなるでしょうか。最悪の場合、エラーメッセージが画面に表示され、プログラムが意図しない形で停止してしまいます。

このような予期せぬ事態に備え、エラーをあらかじめ想定し、問題が起きても gracefully（優雅に）対処する仕組みが「エラー処理」です。

この記事では、PHPにおける現代的なエラー処理の仕組みである「例外処理（try-catch）」を使って、URLパラメータを安全にチェックする方法を解説します。

1. なぜ高度なエラー処理が必要なのか？

シンプルなif-else文でもエラーを判定することはできますが、プログラムが複雑になるにつれて、エラー処理のコードが様々な場所に散らばってしまい、管理が大変になります。

そこで登場するのが「例外処理」です。例外処理を用いると、

エラー処理を一元化できる: 問題が発生した際の処理を、catchブロック一箇所にまとめることができます。
コードが読みやすくなる: 正常系の処理（tryブロック）と異常系の処理（catchブロック）が明確に分離され、プログラムの流れが理解しやすくなります。
より詳細なエラー情報を扱える: エラーの種類に応じた詳細な対処が可能になります。

2. PHPの例外処理「try-catch」構文

try-catchは、エラーが発生する可能性のある処理を安全に実行するための構文です。

tryブロック: エラーが起こる可能性のある「試してみたい処理」をこの中に記述します。
catchブロック: tryブロックの中でエラー（例外 / Exception）が発生した場合に、プログラムは即座にtryブロックの実行を中断し、このcatchブロックにジャンプしてきます。いわばエラー発生時の「受け皿」です。

基本構文:

try {
    // エラーが起こるかもしれない処理
} catch (Exception $e) {
    // エラーが発生した場合の処理
    // $e という変数にエラー情報が格納される
}

3. 意図的に例外を発生させる「throw」

try-catchは、データベース接続失敗などPHPが自動で検知するエラーだけでなく、私たちが「これはエラーとみなす」と定義した状況で意図的にエラーを発生させることもできます。そのために使うのがthrowです。

throw new Exception("エラーメッセージ");

バリデーション（入力値チェック）で問題が見つかった際にこのthrowを使うと、catchブロックに処理をジャンプさせ、エラー処理の流れを統一することができます。

4. 実装例：GETパラメータを安全に処理する

それでは、これらの仕組みを組み合わせて、URLから受け取ったidを安全に処理するプログラムの骨組みを作成してみましょう。

detail.phpのサンプルコード:

<?php
try {
    // --- ① IDのバリデーション ---
    // empty()で、そもそもidが渡されているか、空でないかをチェック
    if (empty($_GET['id'])) {
        throw new Exception('IDが指定されていません。');
    }
    // ctype_digit()で、idが半角数字の文字列であるかをチェック
    if (!ctype_digit($_GET['id'])) {
        throw new Exception('IDは半角数字で指定してください。');
    }
    
    // --- ② バリデーション通過後の処理 ---
    // 安全な値であることが確認できたので、整数型にキャストして変数に格納
    $id = (int)$_GET['id'];

    // --- ③ データベース処理（仮） ---
    // この後、この$idを使ってデータベースに接続し、
    // SELECT * FROM reviews WHERE id = ? のようなSQLを実行する処理が続く
    echo "ID: " . $id . " のレビュー情報をデータベースから取得します。（処理成功）";


} catch (Exception $e) {
    // --- ④ エラー発生時の処理 ---
    // tryブロック内でthrowされたExceptionをここで捕まえる
    // htmlspecialchars()でエラーメッセージを安全に出力する
    echo "エラー発生: " . htmlspecialchars($e->getMessage(), ENT_QUOTES, 'UTF-8');
    
    // 処理を完全に停止
    die();
}
?>

このコードの流れ:

まずtryブロック内の処理が実行されます。
idパラメータが存在しなかったり、数字でなかったりした場合、throw new Exception(...)が実行され、その時点でtryブロックは中断します。
プログラムの制御がcatchブロックに移り、「エラー発生: IDが指定されていません。」のようなメッセージが表示されて処理が終了します。
すべてのチェックを無事に通過した場合のみ、③のデータベース処理に進むことができます。

まとめ

**try-catch**構文を使うことで、正常な処理とエラー処理を明確に分離できる。
入力値チェック（バリデーション）で問題が見つかった場合、**throw new Exception()**を使って意図的にエラーを発生させ、catchブロックで一元的に処理するのがスマートな方法。
この仕組みを使うことで、予期せぬ入力に対しても安全にプログラムを停止させ、ユーザーに分かりやすいメッセージを返す、堅牢なアプリケーションを構築できる。

エラー処理は、一見地味ですが、アプリケーションの品質と信頼性を支える非常に重要な技術です。ぜひこのtry-catchの使い方をマスターしてください。

よかったらシェアしてね！