【PHP8.x】JSON_INVALID_UTF8_SUBSTITUTE定数の使い方

JSON_INVALID_UTF8_SUBSTITUTE定数は、PHPのJSON拡張機能で使用されるオプションの一つを表す定数です。この定数は、JSON形式のデータをエンコードまたはデコードする際に、入力データに含まれる無効なUTF-8バイトシーケンスを、安全な代替文字に置き換えるための振る舞いを指示します。

UTF-8は、様々な言語の文字をコンピュータで表現するための国際的な文字エンコーディング方式です。しかし、データが破損していたり、不正な処理を受けていたりすると、このUTF-8のルールに沿わない「無効なUTF-8バイトシーケンス」がデータ中に混入することがあります。

通常、json_encode()やjson_decode()といったJSON処理関数は、このような無効なUTF-8シーケンスを検出した場合、エラーとして処理を中断したり、nullを返したりすることがあります。これは、プログラムが予期せぬエラーで停止する原因となりえます。

JSON_INVALID_UTF8_SUBSTITUTE定数をオプションとして指定すると、JSON処理関数は無効なUTF-8シーケンスを見つけた際に、エラーで処理を中断する代わりに、それをUnicodeの「U+FFFD（�）」という代替文字に自動的に置き換えます。この動作により、一部のデータに問題があったとしても、JSONデータの変換処理全体を継続できるようになります。

特に、外部システムから取得した信頼性の低いデータや、文字エンコーディングが不完全なデータを取り扱う際に、この定数を使用することで予期せぬエラーを防ぎ、アプリケーションの堅牢性を高めることが可能です。無効な文字が含まれていても処理が停止することなく、安全にデータ変換を進めることができるため、安定したシステム開発に貢献します。

Copy
1<?php
2$data = ['key' => 'value'];
3$json = json_encode($data, JSON_INVALID_UTF8_SUBSTITUTE);
4?>

引数なし

引数はありません

戻り値なし

戻り値はありません