PHP7.1 json_encode() Float Issueの解決方法【2025年最新版】

エラーの概要・症状

PHP7.1において、 json_encode()関数を使用する際に、浮動小数点数の精度に関する問題が発生することがあります。具体的には、数値が期待通りにJSON形式に変換されず、誤った値や精度の低い値が出力されることがあります。このエラーは、特に金額や価格情報を扱う際に顕著になり、開発者にとっては非常に厄介な問題です。エラーメッセージは表示されないものの、結果として得られるJSONデータが不正確なため、アプリケーションの動作に悪影響を及ぼします。ユーザーは正確なデータを期待しているため、この問題が発生すると、顧客からの信頼を損なう可能性があります。

このエラーが発生する原因

このエラーが発生する主な原因は以下の通りです：

1. 浮動小数点数の精度: PHPでは、浮動小数点数を扱う際に、内部的にバイナリ形式で表現されます。このため、特定の数値（特に小数点以下の桁数が多いもの）は、完全に正確に表現できない場合があります。これがjson_encode()に渡された際に誤った値として出力される原因となります。

2. 設定の不足: php.iniファイルにおいて、serialize_precisionやprecisionの設定が適切でない場合、浮動小数点数がJSONに変換される際に、精度が失われることがあります。デフォルトの設定では、浮動小数点数が十分に精度を保てないため、エラーが発生することがあります。

3. PHPのバージョン依存性: このエラーは主にPHP7.1において問題となります。バージョンによっては、浮動小数点数の処理や設定が異なるため、他のバージョンでは発生しない場合があります。

4. データの構造: JSONに変換する際に、配列やオブジェクトの構造が複雑である場合も、浮動小数点数の精度に影響を与えることがあります。特に、ネストされたデータ構造では、予期しない結果が得られることがあります。

解決方法1（最も効果的）

手順1-1（具体的なステップ）

最も効果的な解決方法は、serialize_precisionの設定を変更することです。この設定を-1に設定することで、浮動小数点数の精度を改善できます。以下のコマンドを使用して設定を行います。