PHPのError,Warningを非表示にする

このブログ「MISLEAD」も含めてですが、僕はプライベートでサイトを立ち上げる時はWordPressを利用することが多いです。

サイトごとに画面設計をしているので、細かい部分まで実現しようとすると取得できるテーマのままでは対応できません。

そのため、独自テーマを作るべく、元PHPエンジニアの経験を生かしてガリガリプログラムを書いています。

そんなある日、とあるサイトで外部のAPIと連携するサイトにて、どうやらAPIがうまく動かない時にPHPのWarningが表示されていることに気がつきました。

Warnigの原因を取り除くことはもちろんですが、公開後の運用を開始しているサイトで表示されているのはみっともないので、利用者を不安にさせないためにもなんとかしないといけません。

この事象を解決するべく、PHPでエラーを表示してくれる関数とエラー情報について調べたので、本日はこちらを紹介したいと思います。

事象の確認

対応する前の状態を確認しましょう。

まず、前置きですがエラーには、主にError、Warning、Noticeといったものがあります。ここではひっくるめてエラーと呼んでますのでご注意ください。

では、エラー時の表示に参ります。

以下の画面キャプチャのとおり、エラーの文字列が表示されます。

（なお、このWarningはセッション開始より前に、別の処理を実行していることが原因です）

今でも、メンテが行き届いていない古いサイトなどでたまに見かけたりすると思いますがちょっとまずいですよね。

何も知らないユーザからしてみれば、「自分のパソコンがおかしくなったのかも」なんて誤解を与えかねません。

もちろん、WarningにしろErrorにしろ開発中に表示されるのは問題ありません。

ところが、外部から提供されているAPI側に問題があったりするとこちらでは防ぎようがありません。

そもそもはエラーハンドリングをしっかり考慮していないことが原因なのですが、全てをもれなくとなるとそれだけ時間もかかってしまいます。

自サイトのサービスということもあり今回は

エラーを一切表示させない

という方向で行くことにしました。

対応方法

とても簡単です。

header.phpやfunctions.phpなど全ページ共通のインクルードファイルのどこかに

error_reporting(0);

と書くだけです。

すると、以下の画面のとおりエラーが表示されなくなりました。

ただ、これはWarningだけでなくerrorも全て表示されなくなります。

もし、一部は表示させておきたいなど細かい指定をしたい場合は以下を参考にしてください。

定数も値もどちらの指定でも同じ結果が得られるので問題ありません。

ただし、全部表示・全部非表示は定数がないので、そちらを利用したい場合は値を指定するようにしましょう。

最後に

そもそもは僕のエラーハンドリングが甘いことが原因なので、次に生かすために定めたルールがあります。

サイトの公開直前にPHPのWarning非表示対応をすること

サイト構築中は、原因特定のヒントとして表示されてていいわけなので、このルールを適用することで運用開始後に「レベル低っ！」と思われることは避けられるかと思います。

Author：yukio iizuka

フリーランスとしてUX視点で業務支援しています。 HCD-Net認定 人間中心設計専門家 LEGO®︎ SERIOUS PLAY®︎ メソッドと教材活用トレーニング修了認定ファシリテーター Hi-Standard好きです。
http://yukioiizuka.com