Constantes predefinidas

Constantes predefinidas#

Estas constantes son definidas por esta extensión, y solo están disponibles si esta extensión ha sido compilada con PHP, o bien cargada en tiempo de ejecución.

Las constantes siguientes indican el tipo de error devuelto por json_last_error o almacenado como code de una JsonException.

JSON_ERROR_NONE (int)
No se ha producido ningún error.

JSON_ERROR_DEPTH (int)
Se ha alcanzado la profundidad máxima de la pila.

JSON_ERROR_STATE_MISMATCH (int)
Ocurre con un underflow o con una inadaptación de los modos.

JSON_ERROR_CTRL_CHAR (int)
Error al controlar los caracteres, probablemente codificados incorrectamente.

JSON_ERROR_SYNTAX (int)
Error de sintaxis.

JSON_ERROR_UTF8 (int)
Caracteres UTF-8 mal formados, probablemente codificados incorrectamente.

JSON_ERROR_RECURSION (int)
El objeto o el array pasado a la función json_encode incluye referencias recursivas y no pueden ser codificadas. Si se ha proporcionado la opción JSON_PARTIAL_OUTPUT_ON_ERROR, null será codificado en lugar de la referencia recursiva.

JSON_ERROR_INF_OR_NAN (int)
El valor pasado a la función json_encode incluye NAN, o INF. Si se ha proporcionado la opción JSON_PARTIAL_OUTPUT_ON_ERROR, 0 será codificado en lugar de estos números especiales.

JSON_ERROR_UNSUPPORTED_TYPE (int)
Se ha proporcionado un valor de un tipo no soportado a la función json_encode, como por ejemplo una resource. Si se ha proporcionado la opción JSON_PARTIAL_OUTPUT_ON_ERROR, null será codificado en lugar del valor no soportado.

JSON_ERROR_INVALID_PROPERTY_NAME (int)
Una clave que comienza con el carácter \u0000 estaba presente en la cadena de caracteres pasada a json_decode durante la decodificación de un objeto JSON en un objeto PHP.

JSON_ERROR_UTF16 (int)
Sustituto UTF-16 simple no apareado en el escape unicode contenido en la cadena de caracteres JSON pasada a json_decode.

JSON_ERROR_NON_BACKED_ENUM (int)
El valor pasado a json_encode incluye una enumeración no soportada que no puede ser serializada. Disponible a partir de PHP 8.1.0.

Las constantes siguientes pueden ser combinadas para formar las opciones de json_decode.

JSON_BIGINT_AS_STRING (int)
Decodifica los enteros grandes como una cadena de caracteres.

JSON_OBJECT_AS_ARRAY (int)
Decodifica un objeto JSON en array PHP. Esta opción puede ser añadida automáticamente llamando a json_decode con el segundo argumento igual a true.

Las constantes siguientes pueden ser combinadas para formar las opciones de json_encode.

JSON_HEX_TAG (int)
Todos los caracteres \< y > son convertidos en secuencias \u003C y \u003E.

JSON_HEX_AMP (int)
Todos los caracteres & son convertidos en \u0026.

JSON_HEX_APOS (int)
Todos los apóstrofes ' son convertidos en \u0027.

JSON_HEX_QUOT (int)
Todas las comillas dobles " son convertidas en \u0022.

JSON_FORCE_OBJECT (int)
Produce un objeto en lugar de un array, cuando se utiliza un array no asociativo. Esto es especialmente útil cuando el destinatario del resultado espera un objeto, y el array está vacío.

JSON_NUMERIC_CHECK (int)
Codifica las cadenas numéricas como números.

JSON_PRETTY_PRINT (int)
Utiliza espacios en los datos devueltos para formatearlos.

JSON_UNESCAPED_SLASHES (int)
No escapar los caracteres /.

JSON_UNESCAPED_UNICODE (int)
Codifica los caracteres multioctetos Unicode literalmente (el comportamiento por defecto es escaparles con \uXXXX).

JSON_PARTIAL_OUTPUT_ON_ERROR (int)
Sustituye ciertos valores no codificables en lugar de fallar.

JSON_PRESERVE_ZERO_FRACTION (int)
Asegura que los valores de tipo float siempre sean codificados como valor flotante.

JSON_UNESCAPED_LINE_TERMINATORS (int)
Los terminadores de línea son conservados sin escapar cuando JSON_UNESCAPED_UNICODE es proporcionado. Utiliza el mismo comportamiento como si fuera antes de PHP 7.1 sin esta constante. Disponible a partir de PHP 7.1.0.

Las constantes siguientes pueden ser combinadas para formar las opciones de json_decode y json_encode.

JSON_INVALID_UTF8_IGNORE (int)
Ignora los caracteres UTF-8 inválidos. Disponible a partir de PHP 7.2.0.

JSON_INVALID_UTF8_SUBSTITUTE (int)
Convierte los caracteres UTF-8 inválidos en \0xfffd (Carácter Unicode 'REPLACEMENT CHARACTER'). Disponible a partir de PHP 7.2.0.

JSON_THROW_ON_ERROR (int)
Emite una JsonException si ocurre un error en lugar de establecer el estado de error global que es recuperado mediante json_last_error y json_last_error_msg. JSON_PARTIAL_OUTPUT_ON_ERROR tiene prioridad sobre JSON_THROW_ON_ERROR. Disponible a partir de PHP 7.3.0.