WEBサイトが動いていない！そんなときはどこを見るべきなの？【PHP/Laravel】｜ブログ

はじめに PHP に限らず、実際のプログラムコードというものはどれだけテストを行おうと、実際に運用し始めると想定外の不具合（バグ）が起こってしまうものです。 不具合を完全に無くすことは、おそらく不可能に近いと思いますが、不具合が起こってもなるべく迅速に原因を特定し、対応を行うためにはどうすればいいのかを、今回は解説したいと思います。 なおこの記事では、プログラミング言語は PHP、使用するフレームワークは Laravel で作成されたWEBサイトを想定しますが、他の言語・フレームワークでも応用が効くかと思います。 WEBサイトでエラーが起きたときまず見るべきところ ステータスコードを確認する WEBサイトが正常に表示されない！ エラーが起きたときはまずどこを見るべきでしょうか。 まず、WEBページがどのようなステータスコードを返しているかを確認しましょう。 一般的に PHP を利用したWEBサイトは、ページを表示する際に「ページを表示してください」という要求（HTTPリクエスト）をブラウザが送信します。 そのリクエストを WEB サイトが置かれているサーバーが受け取り、結果をリクエストの応答（HTTPレスポンス）として返却します。 ステータスコードというものは、このリクエストに対してどのようなレスポンスが帰ってきたかを3桁の数字で表したものです。 主なステータスコード | ステータスコード | 詳細 | | --- | --- | | 200番台 | リクエストが正常に完了し、 応答が返却された場合に返されます | | 400番台 | クライアント（ブラウザ）側のエラーによって、 処理が正常に行えなかった場合に返却されます。 | | 500番台 | サーバー側のエラーによって、 処理が正常に行えなかった場合に返却されます。 | 他にもステータスコードの種類はありますが、ここでは取り上げません。 今回はエラーが起きたときのステータスコードなので、返される値は400番台もしくは500番台が返却されることになります。 ステータスコードを確認するには？ エラーが起きた際のステータスコードを確認する方法はいくつか方法がありますが、一般的には表示されたエラーページに記載されていることが多いと思います。 例えば Laravel であれば標準でそれぞれのステータスコードに対応したページが表示されます。 下記は存在しないページにアクセスした場合に、Laravelが表示するエラーページです。 404 と表示されているのがステータスコードであり、404 はアクセスしようとしたページが存在しない場合に返却するステータスコードと決まっています。 またブラウザの開発ツールなどを利用して確認することも可能です。 OSやブラウザによって異なりますが、例えば Google Chrome の場合、キーボードの「F12」を押下することで開発ツールが表示されるので、その中の「ネットワーク」タブでサイトへのアクセスの結果が確認できます。 クライアントエラーが発生した場合 400番台である、クライアントエラーレスポンスの場合はクライアント側の操作、WEBサイトであればブラウザを操作しているユーザーに起因するエラーとなります。 例えば、URLの打ち間違いといった理由で存在しないページにアクセスした場合は、上記にもある通り 404 エラーが返却されます。 他にも、Basic認証による制限がかかっているページに認証せずにアクセスした場合に返却される 401 エラーがあります。 クライアントエラーレスポンス一覧 クライアントに起因するエラーの場合、プログラム側の問題ではありませんので、開発者側でやれることはありません。 利用しているユーザーに、URLが間違っていないか、きちんとログインしているかなどを確認してもらう必要があります。 サーバーエラーが発生した場合 (500 Internal Server Error) 500番台である、サーバーエラーレスポンスの場合は、サーバー側の問題で発生したエラーとなります。 アプリケーションのプログラムコードに限らず、利用しているWEBサーバー（apacheやnginxなど）が原因の可能性もあります。 このエラーが発生した場合、開発者側は何かしら対応を行う必要がります。 サーバーエラーレスポンス この中でも「500 Internal Server Error」は、意図的にこのレスポンスコードを返すような処理をしていない場合は、プログラム側の処理に不具合が生じて発生する場合が殆どです。 では、どのような対応を行うべきなのかを調べるために、開発者は何を見るべきでしょうか。 利用しているフレームワークのログを調べる Laravel などのフレームワークを利用している場合、標準でエラーのログが出力されることが多いです。 このエラーログを調べることで、エラーの原因を特定し不具合の対応を行うことが容易となります。 Laravel であれば標準のログ出力場所は「storage/logs/laravel.log」となります。 エラーが発生した場合、このファイルに自動で書き込まれます。 書き込まれる内容は、エラーの原因やエラーが発生したコードが記述されたファイルや行数、その他どのような処理がされていったか、などが記載されます。 上記のエラーログであれば、「Undefuned variable $test」とあるので、未定義の $test という変数にアクセスしたことがエラーの原因となります。 「/var/www/html/laravel/routes/web.php:6」は「/var/www/html/laravel/routes」フォルダにある「web.php」ファイルの 6 行目で発生したエラーということが分かります。 そして \[stacktrace\] が、エラーが発生するまでに行った処理の履歴となります。 WEBサーバーのログを調べる エラーが発生しても、Laravel がエラーを出力していないことがあります。 そもそも Laravel による処理が実行される前にエラーとなっている場合や、発生したエラーが原因で強制的に処理が終了された場合などが該当します。 例えば PHPが利用できる最大メモリを超えるメモリを利用すると、「Allowed memory size of xxx bytes exhausted」というエラーが発生します。 このエラーの場合、発生した時点で処理が強制的に中断されるため、laravel のエラーログを出力するという処理も行われず、500 エラーが返却されるだけとなります。 ただし、その場合でも利用しているWEBサーバーのログに出力されている場合があります。 主に利用されているWEBサーバーである、apache および nginx であれば、設定にもよりますが以下のフォルダに出力されている場合が多いです。 レンタルサーバーであれば、そのレンタルサーバーごとに出力場所が決められているかと思いますので、レンタルサーバーのヘルプなどを参照しましょう。 | WEBサーバー | ログの出力パス | | --- | --- | | apache | /var/log/httpd /var/log/apache2 | | nginx | /var/log/nginx | 500 Internal Server Error 以外の500番エラー 今までのことは「500 Internal Server Error」で通用することが多い方法です。 逆に言うと、「500 Internal Server Error」以外の 500 番台のエラーは他の部分を調べなくてはいけません。 実際にWEBサイトを運用していく中で遭遇することの多いエラーを見てみましょう。 502 Bad Gateway, 503 Service Unavailable この2つのサーバーエラーレスポンスは、発生する原因が数多くあります。 502 エラーの場合は、ブラウザとサーバーでデータの送受信ができないことを表しています。 サーバー側に起因するコードなのでこの場合は、サーバー側のネットワーク設定に原因がある、サーバーのドメインやDNSに問題がある、アクセスが集中してサーバーが処理できなかったなどがあります。 503 エラーの場合は、サーバーが一時的に処理を行えないことを表します。 502 エラーとも似ていますが、例えばサーバーメンテナンスで一時的にアクセスできない、といった場合もこのステータスコードが返されます。 どちらもサーバーが処理できずにエラーを返している点で似ていますが、502 エラーはネットワーク側に起因していることが、503 エラーはサーバー側に起因していることが多いです。 503 エラーの場合、プログラム側が原因で異常な負荷がかかっている可能性もあるため、該当箇所のコードで処理が重くなっていないかなどを確認しましょう。 504 Gateway Timeout 「504 Gateway Timeout」は、文字通り処理のタイムアウトによるエラーです。 タイムアウトになる原因は様々ですが、PHP の設定によるタイムアウト、WEBサーバーの設定によるタイムアウトなどがありますので、それぞれで対応を見ていきましょう。 PHPのタイムアウト対策 PHP のタイムアウトに関する設定は以下があります。 php.ini にある該当の記述を探して修正を行いましょう。 maxexecutiontime Apache のタイムアウト対策 Apacheのタイムアウトに関する設定は以下があります。 設定ファイルにある該当の記述を探して修正を行いましょう。 Timeout ProxyTimeout (proxy 接続を使っている場合) KeepAliveTimeout nginx のタイムアウト対策 nginxのタイムアウトに関する設定は以下があります。 設定ファイルにある該当の記述を探して修正を行いましょう。 sendtimeout keepalivetimeout fastcgiconnecttimeout fastcgisendtimeout fastcgireadtimeout その他のタイムアウト WEBサーバーやPHPの設定を変更しタイムアウトを長くしたのに、504エラーが出る…… そんな場合は、更に別の場所でタイムアウトとなっているかもしれません。 504 エラーを返しているのがどこから返ってきているのかを確認してみましょう。 開発ツールを使って、レスポンスを確認してみます。 注目するべきは「Server」の項目です。 上記の例であれば、「nginx」のなっているのでこのレスポンスは nginx サーバーから返却されていることになります。 ここがWEBサーバー以外の場合、例えば AWS の ALB であれば、「aws/alb」といった値で返ってくるかと思います。 その場合、AWS の ALB がレスポンスを返しています。 AWS の ALB はタイムアウト設定があるので、処理に一定以上の時間がかかるとタイムアウトとなってしまいます。 まとめ エラーの原因を特定するというのは、場合によっては大変なことも多いのですが、ここで説明したように一つ一つどこに原因があるのかを調べていくことで、原因の特定がしやすくなるかと思います。