Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

Les constantes suivantes indiquent le type d'erreur retournée par json_last_error() ou stockée en tant que code d'une JsonException.

JSON_ERROR_NONE (int): Aucune erreur n'est survenue.
JSON_ERROR_DEPTH (int): La profondeur maximale de la pile a été atteinte.
JSON_ERROR_STATE_MISMATCH (int): Survient avec un underflow ou avec une inadéquation des modes.
JSON_ERROR_CTRL_CHAR (int): Erreur lors du contrôle des caractères, probablement encodés incorrectement.
JSON_ERROR_SYNTAX (int): Erreur de syntaxe.
JSON_ERROR_UTF8 (int): Caractères UTF-8 mal formés, probablement encodés incorrectement.
JSON_ERROR_RECURSION (int): L'objet ou le tableau passé à la fonction json_encode() inclut les références récursives et ne peuvent être encodées. Si l'option JSON_PARTIAL_OUTPUT_ON_ERROR a été fournie, null sera encodé à la place de la référence récursive.
JSON_ERROR_INF_OR_NAN (int): La valeur passée à la fonction json_encode() inclut soit NAN, soit INF. Si l'option JSON_PARTIAL_OUTPUT_ON_ERROR a été fournie, 0 sera encodé à la place de ces nombres spéciaux.
JSON_ERROR_UNSUPPORTED_TYPE (int): Une valeur d'un type non supporté a été fournie à la fonction json_encode(), par exemple une resource. Si l'option JSON_PARTIAL_OUTPUT_ON_ERROR a été fournie, null sera encodé à la place de la valeur non supportée.
JSON_ERROR_INVALID_PROPERTY_NAME (int): Une clé commençant par le caractère \u0000 était présente dans la chaîne de caractères passée à json_decode() lors d'un décodage d'un objet JSON en un objet PHP.
JSON_ERROR_UTF16 (int): Substitut UTF-16 simple non apparié dans l'échappement unicode contenu dans la chaîne de caractères JSON passée à json_decode().
JSON_ERROR_NON_BACKED_ENUM (int): La valeur passée à json_encode() inclut une énumération non prise en charge qui ne peut pas être sérialisée. Disponible à partir de PHP 8.1.0.

Les constantes suivantes peuvent être combinées pour former les options de json_decode().

JSON_BIGINT_AS_STRING (int): Décode les gros entiers sous forme d'une chaîne de caractères.
JSON_OBJECT_AS_ARRAY (int): Décode un objet JSON en tableau PHP. Cette option peut être ajoutée automatiquement en appelant json_decode() avec le deuxième paramètre égal à true.

Les constantes suivantes peuvent être combinées pour former les options de json_encode().

JSON_HEX_TAG (int): Tous les caractères < et > sont convertis en séquences \u003C et \u003E.
JSON_HEX_AMP (int): Tous les caractères & sont convertis en \u0026.
JSON_HEX_APOS (int): Tous les guillemets ' sont convertis en \u0027.
JSON_HEX_QUOT (int): Tous les guillemets doubles " sont convertis en \u0022.
JSON_FORCE_OBJECT (int): Produit un objet plutôt qu'un tableau, lorsqu'un tableau non-associatif est utilisé. C'est particulièrement utile lorsque le destinataire du résultat attend un objet, et que le tableau est vide.
JSON_NUMERIC_CHECK (int): Encode les chaînes numériques en tant que nombres.
JSON_PRETTY_PRINT (int): Utilise des espaces dans les données retournées pour les formater.
JSON_UNESCAPED_SLASHES (int): Ne pas échapper les caractères /.
JSON_UNESCAPED_UNICODE (int): Encode les caractères multioctets Unicode littéralement (le comportement par défaut est de les échapper par \uXXXX).
JSON_PARTIAL_OUTPUT_ON_ERROR (int): Substitue certaines valeurs non encodables au lieu d'échouer.
JSON_PRESERVE_ZERO_FRACTION (int): S'assure que les valeurs de type nombre décimal sont toujours encodées comme valeur flottante.
JSON_UNESCAPED_LINE_TERMINATORS (int): Les terminateurs de ligne sont conservés sans être échappés quand JSON_UNESCAPED_UNICODE est fourni. Il utilise le même comportement qu'avant PHP 7.1 sans cette constante. Disponible à partir de PHP 7.1.0.

Les constantes suivantes peuvent être combinées pour former les options de json_decode() et json_encode().

JSON_INVALID_UTF8_IGNORE (int): Ignore les caractères UTF-8 invalides. Disponible à partir de PHP 7.2.0.
JSON_INVALID_UTF8_SUBSTITUTE (int): Convertit les caractères UTF-8 invalides en \0xfffd (Caractère Unicode 'REPLACEMENT CHARACTER'). Disponible à partir de PHP 7.2.0.
JSON_THROW_ON_ERROR (int): Émet une JsonException si une erreur se produit au lieu de régler l'état d'erreur globale qui est récupéré grâce à json_last_error() et json_last_error_msg(). JSON_PARTIAL_OUTPUT_ON_ERROR prend la priorité par rapport à JSON_THROW_ON_ERROR. Disponible à partir de PHP 7.3.0.