PHPウェブ開発奮闘記：エラーログ出力がデバッグの「光」だった話

ウェブサイト開発、特にPHPでMVC（Model-View-Controller）フレームワークを自作する中で、エラー解決は避けて通れない道です。今日、私はまさにそのデバッグの壁にぶつかり、そして乗り越える大きな一歩を踏み出しました。その立役者は、意外にも地味ながら非常に強力な「PHPエラーログ」でした。

ルーティング問題からデータベースエラーへ

私が開発しているのは、大量の商品データを扱うアフィリエイトサイト。WordPressでは限界を感じ、MVCフレームワークを自作しています。

今日解決したかったのは、/label/180/page/1 のようなURLにアクセスしたときに、正しくページが表示されないという問題でした。以前の作業で、ルーティングの正規表現に間違いがあり、URLが正しく認識されていないことがわかっていました。

修正を加えて再度アクセスしてみると、ブラウザ上はまだ「404 Not Found」が表示されるものの、エラーログには嬉しい変化がありました。

DEBUG Router: Match found! Pattern: '#^/label/(\d+)(?:/page/(\d+))?$#' for URI '/label/180/page/1'
DEBUG Router: Calling controller method: App\Controllers\FrontController::productsByLabel with arguments: Array
(
    [0] => 180
    [1] => 1
)

このログは、ルーターが完全に意図した通りに動作し、URLを認識して正しいコントローラー（FrontController）のメソッド（productsByLabel）を呼び出し、URLから「180」と「1」という正しい数値まで抽出して渡していることを示していました。これまでの苦労が報われた瞬間です！

しかし、喜びも束の間、その直後に新たなエラーログが。

関連製品取得エラー (labels ID: 1): SQLSTATE[42S22]: Column not found: 1054 Unknown column 'labels_id' in 'where clause'

これは、「productsByLabel メソッドが、データベースにlabels_id というカラムを探しに行ったけれど見つからなかった」というエラーです。つまり、ルーターの問題は解決し、次のステップである「データベースからデータを取得する」段階で問題が起きていることが明確になりました。

PHPエラーログがデバッグの光だった理由

この一連のプロセスで、私が最も「役に立った」と感じたのは、PHPのエラーログを詳細に出力できたことでした。特に、契約しているシン・レンタルサーバーで php.ini の設定を変更し、エラーログをファイルに出力できたことが大きなターニングポイントです。

問題の「見える化」: エラーログがなければ、表面的な「404」や「500エラー」しか見えず、内部で何が起きているのか全く分かりません。ログのおかげで、ルーターの動作状況や、具体的なSQLエラーまで手に取るように分かりました。
効率的な問題特定: 「Unknown column 'labels_id'」という明確なメッセージは、何が問題なのかをピンポイントで教えてくれます。これにより、闇雲にコードを探すのではなく、直接データベースのテーブル定義やSQLクエリを確認すれば良いと判断できました。
学習の促進: エラーログを通じて、MVCのルーティングがどのように機能しているか、データベースエラーがどのような形で表示されるかなど、教科書だけでは得られない実践的な知識が身につきました。

次のステップと今後の展望

現在、問題はデータベースのカラム名にあることが判明しているので、次はproductsテーブルのカラム名を確認し、FrontControllerや関連するモデル内のSQLクエリを修正する作業に取り掛かります。

今回の経験で、エラーログの重要性を痛感しました。地道な作業ですが、このログこそがウェブ開発におけるデバッグ作業の「光」となり、解決への道筋を示してくれるのだと強く実感しています。今後も、ログを活用しながら開発を進めていきたいと思います。

投稿者プロフィール

bicstation: AIアシスタントとの協業が、この奮闘記を可能にした
実は、今回一連の記事を執筆し、そして開発を進める上で、強力な「相棒」の存在がありました。それが、私のような開発者をサポートしてくれるAIアシスタントです。

PHPの難解なエラーログに直面した時、記事の構成がなかなか思いつかなかった時、あるいはブログのテーマに合ったアイキャッチ画像が必要だった時など、数々の場面でAIに相談し、助けを借りました。

例えば、「レンタルサーバーでのphp.ini設定の難しさ」や「.envファイルの問題」といった、私が実体験で感じた課題を伝えると、AIは瞬時にその技術的な背景や影響を整理し、ブログ記事として読者に伝わりやすい文章の骨子を提案してくれました。また、記事のテーマに合わせたアイキャッチ画像も、具体的な指示を出すだけで瞬時に生成してくれたおかげで、コンテンツ作成のスピードが格段に向上しました。

AIは完璧ではありませんが、まさに「もう一人の自分」のように、アイデアの壁打ち相手になったり、膨大な知識の中から必要な情報を引き出してくれたり、私の思考を整理する手助けをしてくれたりします。一人で抱え込みがちな開発の課題も、AIと対話することで、新たな視点や解決策が見えてくることが多々ありました。

このブログを通じて私の奮闘記を共有できているのも、AIアシスタントの存在なくしては成し得なかったでしょう。これからも、AIを賢く活用しながら、開発と情報発信を続けていきたいと思います。