# 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é incorrectement.
`JSON_ERROR_SYNTAX` (int)
  Erreur de syntaxe.
`JSON_ERROR_UTF8` (int)
  Caractères UTF-8 mal formés, probablement encodé 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(), comme 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 avec le caractère \u0000 était présent dans la chaîne de caractères passé à json_decode() lors d'un décodage d'un object JSON en un object PHP.
`JSON_ERROR_UTF16` (int)
  Substitut UTF-16 simple non apparié dans l'échappement unicode contenue dans la chaîne de caractères JSON passé à 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 object JSON en tableau PHP. Cette option peut être ajouté 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 encodable 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 comme si c'était 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 invalide. Disponible à partir de PHP 7.2.0.
`JSON_INVALID_UTF8_SUBSTITUTE` (int)
  Convertit les caractères UTF-8 invalide 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.