CodeIgniterの例外処理とエラーハンドリング完全ガイド！初心者でも怖くないエラー解決術

1. CodeIgniterのエラーハンドリングとは？

1. CodeIgniterのエラーハンドリングとは？

プログラミングをしていると、必ずどこかで「間違い」が発生します。この間違いのことをプログラミングの世界ではエラー（Error）と呼びます。また、予期せぬトラブルのことを例外（Exception）と呼ぶこともあります。パソコンを触ったことがない方でもイメージしやすいように例えると、料理のレシピ通りに作っていたのに、材料が足りなかったり、火加減を間違えて焦がしてしまったりするような状態です。

PHPのフレームワークであるCodeIgniter（コードイグナイター）には、こうした間違いが起きたときに「どこで何が起きたのか」を画面に表示したり、記録として残したりするエラーハンドリングという便利な機能が最初から組み込まれています。これがあるおかげで、私たちは真っ暗な道を進むのではなく、懐中電灯を持って不具合という迷路を探索できるようになります。

初心者がまず覚えるべきは、エラーは敵ではなく、プログラムを完成させるための「ヒント」であるということです。CodeIgniterは非常に親切なツールなので、設定次第で初心者にも分かりやすくエラーの内容を教えてくれます。

2. よくあるエラー「404 Page Not Found」の原因

2. よくあるエラー「404 Page Not Found」の原因

インターネットを見ているときに一番よく見かけるのが、この404 Page Not Found（ページが見つかりません）というエラーです。これは、あなたが「このページを表示して！」とお願いした住所（URL）に、対応するファイルや仕組みが見つからなかったときに発生します。

CodeIgniterでこれが発生する主な原因は以下の通りです。

• URLの打ち間違い： 綴りが一文字違うだけで、プログラムは別の場所だと判断してしまいます。
• コントローラー名の不一致： プログラムの司令塔である「コントローラー」の名前と、URLの名前が合っていない場合に起こります。
• ルーティングの設定ミス： 「どのURLがどのプログラムに繋がるか」という地図（Routes.php）の設定が間違っていると迷子になります。

例えば、画面を表示させるための簡単な命令（コントローラー）を見てみましょう。ファイル名が Home.php なのに、URLで index.php/test と打ってしまうと、このエラーになります。

namespace App\Controllers;

class Home extends BaseController
{
    public function index()
    {
        // 正常ならこのメッセージが表示される
        return view('welcome_message');
    }
}

3. 画面が真っ白に？「Fatal Error」の正体

3. 画面が真っ白に？「Fatal Error」の正体

プログラムを実行したときに、何も表示されず画面が真っ白になることがあります。これはFatal Error（致命的なエラー）と呼ばれ、プログラムの文法が根本的に間違っているときに起こります。例えば、文章の最後に句読点を忘れたり、カッコを閉じ忘れたりするようなミスです。

初心者がよくやってしまうミスには、以下のようなものがあります。

• セミコロン（;）の忘れ： PHPでは命令の終わりに必ずセミコロンをつけなければなりません。
• 存在しない関数を呼ぶ： まだ作っていない魔法の言葉を唱えても、コンピュータは理解できません。
• 綴りミス： echo と書くべきところを echp と書いてしまうようなケアレスミスです。

以下は、セミコロンを忘れてしまったためにエラーになる例です。たったこれだけでプログラムは動かなくなります。

$message = "こんにちは" // ここにセミコロンがないのでエラー！
echo $message;

実行すると、次のようなメッセージが画面（またはログ）に出力されます。

Parse error: syntax error, unexpected 'echo' (T_ECHO) in ...

4. データベース接続エラー「Unable to connect」

4. データベース接続エラー「Unable to connect」

CodeIgniterでWebサイトを作る際、情報を保存するためにデータベースという倉庫を使います。この倉庫の鍵が合わなかったり、倉庫自体が閉まっていたりすると、Database Exceptionが発生します。これは初心者にとって非常に高い壁に感じられるエラーです。

主な原因は設定ファイル（.env または database.php）の書き間違いです。以下の項目をチェックしてみましょう。

• Hostname： 倉庫の住所（多くは localhost です）。
• Username / Password： 倉庫に入るための名前と合言葉。
• Database Name： 使いたい倉庫の名前。

設定が間違っていると、CodeIgniterは「倉庫にアクセスできません！」と大きな警告を出します。以下のコードは、わざと間違った設定で接続しようとしたときのイメージです。

// データベースに接続しようとする命令
$db = \Config\Database::connect();
$query = $db->query('SELECT * FROM users');

// もし設定が間違っていると、ここでプログラムが止まります。

5. 例外処理（try-catch）でエラーを優しく包む

5. 例外処理（try-catch）でエラーを優しく包む

エラーが発生したときに、恐ろしい英語のメッセージをユーザーに見せるのは避けたいものです。そこで登場するのがtry-catch（トライ・キャッチ）という構文です。これは「とりあえずやってみて（try）、もしエラーが起きたら捕まえて（catch）、別の処理をする」という仕組みです。

これを活用すると、エラーが起きても「ただいまメンテナンス中です」といった優しいメッセージを表示させることができます。これは、もし転んでも怪我をしないように、あらかじめクッションを敷いておくようなものです。

try {
    // 割り算をしてみる（0で割るという禁止行為）
    $result = 10 / 0;
} catch (\Exception $e) {
    // エラーをキャッチして、メッセージを表示
    echo "計算に失敗しました。原因: " . $e->getMessage();
}

このように、あらかじめエラーが起きそうな場所に網を張っておくことで、サイトが完全に壊れてしまうのを防ぐことができます。

6. ログファイルを確認して原因を特定する

6. ログファイルを確認して原因を特定する

CodeIgniterには、裏側でこっそり日記をつけてくれるログ（Log）という機能があります。画面にエラーが出ない場合でも、この日記帳（ログファイル）を読めば、何が起きたのかが分かります。初心者の方は「画面に出ていないから大丈夫」と思いがちですが、実は裏でエラーが積み重なっていることもあります。

ログを確認する場所は、通常 writable/logs/ というフォルダの中です。ここには日付ごとのファイルが作られ、何時何分にどんなミスが起きたかが詳しく書かれています。

• DEBUG： 開発中のちょっとしたメモ。
• INFO： プログラムがどう動いたかの記録。
• ERROR： 解決が必要な問題の報告。

このログファイルをこまめにチェックする癖をつけることが、プログラミング上達の近道です。文字がびっしり書いてあって驚くかもしれませんが、一番下の行（最新の記録）を見るだけで、今の問題が解決することが多いですよ。

7. 開発モード（Development Mode）の活用術

7. 開発モード（Development Mode）の活用術

CodeIgniterには「開発中モード」と「本番公開モード」の切り替えスイッチがあります。プログラミングの練習をしているときは、必ず開発モード（development）に設定しましょう。なぜなら、開発モードにすると、エラーの詳細を非常に詳しく画面に表示してくれるからです。

具体的には、エラーが起きた場所のソースコードまで赤く表示して教えてくれます。これを「デバッグツールバー」と呼びます。逆に、一般の人が見る本番用のサイト（production）では、セキュリティのためにエラーの詳細は隠されます。泥棒に家の間取りを教えないのと同じですね。

設定は .env というファイルで行います。初心者はまずここが CI_ENVIRONMENT = development になっているか確認することから始めましょう。これだけで、エラー解決のスピードが10倍以上変わります。

8. エラーを解決するための「検索のコツ」

8. エラーを解決するための「検索のコツ」

エラーメッセージが出たとき、どうすればいいか分からず途方に暮れることもあるでしょう。そんなときは、表示された英語のメッセージをそのままGoogleなどの検索エンジンに貼り付けて調べてみてください。世界中のプログラマーが同じ悩みを持っていて、解決策をネット上に残してくれています。

検索するときのキーワードは以下の組み合わせがおすすめです。

• 「CodeIgniter4 エラーメッセージ」： 基本的な検索方法です。
• 「PHP エラー 解決方法」： CodeIgniter特有ではなく、PHP全体の知識が必要な場合に有効です。
• 「CodeIgniter 404 対策」： 特定のエラー番号で調べると解決が早いです。

プログラミング未経験の方は、英語のメッセージを翻訳サイトに入れてみてください。意外と「ファイルがありません」や「カッコが足りません」といった単純なことを言っているだけの場合が多いのです。エラーメッセージは、コンピュータからの「ここを直してほしいな」というラブレターだと思って、優しく向き合ってみましょう。