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 (entier)

Aucune erreur n'est survenue. Disponible à partir de PHP 5.3.0.

JSON_ERROR_DEPTH (entier)

La profondeur maximale de la pile a été atteinte. Disponible à partir de PHP 5.3.0.

JSON_ERROR_STATE_MISMATCH (entier)

Survient avec un underflow ou avec une inadéquation des modes. Disponible à partir de PHP 5.3.0.

JSON_ERROR_CTRL_CHAR (entier)

Erreur lors du contrôle des caractères, probablement encodé incorrectement. Disponible à partir de PHP 5.3.0.

JSON_ERROR_SYNTAX (entier)

Erreur de syntaxe. Disponible à partir de PHP 5.3.0.

JSON_ERROR_UTF8 (entier)

Caractères UTF-8 mal formés, probablement encodé incorrectement. Disponible à partir de PHP 5.3.3.

JSON_ERROR_RECURSION (entier)

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. Disponible à partir de PHP 5.5.0.

JSON_ERROR_INF_OR_NAN (entier)

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. Disponible à partir de PHP 5.5.0.

JSON_ERROR_UNSUPPORTED_TYPE (entier)

Une valeur d'un type non supporté a été fournie à la fonction json_encode(), comme par exemple une ressource. Si l'option JSON_PARTIAL_OUTPUT_ON_ERROR a été fournie, NULL sera encodé à la place de la valeur non supportée. Disponible à partir de PHP 5.5.0.

JSON_ERROR_INVALID_PROPERTY_NAME (entier)

Une clé commençant avec le charactère \u0000 était présent dans la chaîne de charactères passé à json_decode() lors d'un décodage d'un object JSON en un object PHP. Disponible à partir de PHP 7.0.0.

JSON_ERROR_UTF16 (entier)

Substitut UTF-16 simple non apparié dans l'échappement unicode contenue dans la chaîne de charactères JSON passé à json_encode(). Disponible à partir de PHP 7.0.0.

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

JSON_BIGINT_AS_STRING (entier)

Décode les gros entiers sous forme d'une chaîne de caractères. Disponible à partir de PHP 5.4.0.

JSON_OBJECT_AS_ARRAY (entier)

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. Disponible à partir de PHP 5.4.0.

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

JSON_HEX_TAG (entier)

Tous les caractères < et > sont convertis en séquences \u003C et \u003E. Disponible à partir de PHP 5.3.0.

JSON_HEX_AMP (entier)

Tous les caractères & sont convertis en \u0026. Disponible à partir de PHP 5.3.0.

JSON_HEX_APOS (entier)

Tous les guillemets ' sont convertis en \u0027. Disponible à partir de PHP 5.3.0.

JSON_HEX_QUOT (entier)

Tous les guillemets doubles " sont convertis en \u0022. Disponible à partir de PHP 5.3.0.

JSON_FORCE_OBJECT (entier)

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. Disponible à partir de PHP 5.3.0.

JSON_NUMERIC_CHECK (entier)

Encode les chaînes numériques en tant que nombres. Disponible à partir de PHP 5.3.3.

JSON_PRETTY_PRINT (entier)

Utilise des espaces dans les données retournées pour les formater. Disponible à partir de PHP 5.4.0.

JSON_UNESCAPED_SLASHES (entier)

Ne pas échapper les caractères /. Disponible à partir de PHP 5.4.0.

JSON_UNESCAPED_UNICODE (entier)

Encode les caractères multi-octets Unicode littéralement (le comportement par défaut est de les échapper par \uXXXX). Disponible à partir de PHP 5.4.0.

JSON_PARTIAL_OUTPUT_ON_ERROR (entier)

Substitue certaines valeurs non encodable au lieu d'échouer. Disponible à partir de PHP 5.5.0.

JSON_PRESERVE_ZERO_FRACTION (entier)

S'assure que les valeurs de type nombre décimal sont toujours encodées comme valeur flottante. Disponible à partir de PHP 5.6.6.

JSON_UNESCAPED_LINE_TERMINATORS (entier)

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 (entier)

Ignore les caractères UTF-8 invalide. Disponible à partir de PHP 7.2.0.

JSON_INVALID_UTF8_SUBSTITUTE (entier)

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 (entier)

Émet une JsonException si une erreur se produit au lieu de régler l'état d'erreur globale qui est récupérer 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.