PHPで例外処理を使う方法を現役エンジニアが解説【初心者向け】

PHPで例外処理を使う方法について解説します。

フォームから想定外の入力値が送信された場合などに、例外を発生させて警告表示を行うことなどが出来ます。

 

そもそもPHPについてよく分からないという方は、PHPとは何なのか解説した記事を読むとさらに理解が深まります。

 

なお本記事は、TechAcademyのオンラインブートキャンプPHP/Laravel講座の内容をもとに紹介しています。

 

 

例外処理とは

例外処理とはプログラムを書く人が想定しているエラーに対しての対応を行うことです。例えば、引数で整数を2つ受け取ってその合計値を出力する関数があったとします。

もし、”ABC”などの文字列を引数に渡された場合は、整数と文字列では正常に合計値を算出できないので関数から使用者に「引数のデータ型が間違ってるよ」とエラーを伝える必要があります。

そして使用者はその関数がある条件でエラーを発信することを把握して、そのエラーが発生した場合に行う処理を実装する必要があるのです。

 

関数から使用者にエラーを伝える方法が「例外」で、エラーが発生した場合の処理を実装することが「処理」と考えると「例外処理」がイメージしやすくなると思います。

実際の実務では、「データベースに接続する際に接続失敗した場合」「ユーザが入力した郵便番号が存在しない場合」などを起こりうるエラーと想定して、例外処理をコーディングします。

 

例外処理の書き方

上記の説明で登場した「例外」をPHPではExceptionクラスと表現します。

ある関数でエラー(例外)が発生したことを、その関数の使用者に伝える記述は下記のようにthrow句を使い、呼び出し元にException（例外）を投げます。

throw new Exception();

関数の呼び出し側ではエラー(例外)が発生しうる関数・処理に対してtry/catch句を利用して、投げられた例外を捕まえて例外(エラー)発生後の対応を実装します。

try {
    例外が発生する可能性がある関数();
} catch (Exception $e) {
    例外が発生した場合に行う処理;
}

 

[PR] PHPを学んで未経験からWebエンジニアを目指す方法とは

実際に書いてみよう

それでは説明で登場した例の、引数の合計値を返す関数を用意してみます。

引数が数値外の場合に例外を投げる仕様にして、関数を使用する側でtry/catchを使って例外を捕まえて、例外処理を行なってみましょう！

また、今回は引数のデータ型が誤っているという内容のエラーを表したいので、不正な引数が渡されたことを意図するInvalidArgumentExceptionを利用しています。

Exceptionクラスは様々な種類が存在します。エラーの内容によって適切なExceptionクラスを利用することで、catchする際にそれぞれの例外に応じて処理を振り分けることができます。

// ２つの引数の合計値を返却する
function sum($num1, $num2) {
    // 引数が数値かを判定する
    if (is_numeric($num1) && is_numeric($num2)) {
        return $num1 + $num2;
    }

    // いずれかの引数が数値以外の場合
    throw new InvalidArgumentException('引数には数値以外を設定しないでください');
}

// 引数がどちらも正常なので 1+2 の結果である3が表示されます
echo sum(1, 2).PHP_EOL;

// 引数に数値以外を指定すると例外が発生するので、それをキャッチしてエラーメッセージを表示します
try {
    sum('ABC', 2).PHP_EOL;
} catch (InvalidArgumentException $e) {
    echo $e->getMessage().PHP_EOL;
}

 

この記事を監修してくれた方 青木 敦史（あおきあつし） 昼間は自社のWebサービスを運営している会社でフロントエンド/バックエンドを担当しているエンジニア。 Webエンジニアの経験は5年ほどです。TechAcademyではPHP/Laravelコースを担当しています。 開発実績: メイクレッスン支援アプリ / 電力自由化パッケージ / 携帯電話料金計算 / ライブチャットサービス

 

 

TechAcademyでは、初心者でもPHPやフレームワークのLaravelを使ってWebアプリケーション開発を習得できるオンラインブートキャンプPHP/Laravel講座を開催しています。

挫折しない学習方法を知れる説明動画や、現役エンジニアとのビデオ通話とチャットサポート、学習用カリキュラムを体験できる無料体験も実施しているので、ぜひ参加してみてください。