(PHP 8 >= 8.3.0)
json_validate — Verifica se uma string contém JSON válido
Retorna se a string informada é um JSON válido sintaticamente.
Se json_validate() retornar true, json_decode()
irá decodificar com sucesso a string informada ao usar a mesma profundidade de
depth e as opções em flags.
Se json_validate() retornar false, a causa
pode ser obtida usando json_last_error() e
json_last_error_msg().
json_validate() usa menos memória que json_decode() se o JSON decodificado não for usado, porque ela não precisa construir o array ou a estrutura de objeto que contém a decodificação.
Chamar json_validate() imediatamente antes de json_decode() irá analisar a string duas vezes desnecessariamente, já que json_decode() implicitamente realiza a validação durante a decodificação.
Portanto, json_validate() deve somente ser utilizada se o JSON decodificado não for usado imediatamente e se for necessário saber se a string contém JSON válido.
jsonA string a ser validada.
Esta função funciona somente com strings codificadas com UTF-8.
Nota:
O PHP implementa um superconjunto de JSON conforme especificado na » RFC 7159 original.
depth
A máxima profundidade de aninhamento da estrutura sendo decodificada.
O valor precisa ser maior que 0,
e menor ou igual a 2147483647.
flags
Atualmente apenas a constante
JSON_INVALID_UTF8_IGNORE
é aceita.
Retorna true se a string fornecida for um JSON válido sintaticamente, caso contrário
retorna false.
Se depth estiver fora do intervalo permitido,
uma exceção ValueError é lançada.
Se flags não for uma opção válida,
uma exceção ValueError é lançada.
Exemplo #1 Exemplos de json_validate()
<?php
var_dump(json_validate('{ "test": { "foo": "bar" } }'));
var_dump(json_validate('{ "": "": "" } }'));
?>O exemplo acima produzirá:
bool(true) bool(false)
---------------- PHP < 8.3 ----------------
function json_validate(string $string): bool {
json_decode($string);
return json_last_error() === JSON_ERROR_NONE;
}
var_dump(json_validate('{ "test": { "foo": "bar" } }')); // true
---------------- PHP >= 8.3 ----------------
var_dump(json_validate('{ "test": { "foo": "bar" } }')); // true
Note: code from https://www.php.net/releases/8.3/en.phpBuilding upon Allan R.'s initial idea, I've developed an improved version of the json_validate function for those using PHP 8.2 and earlier versions. This function emulates the functionality introduced in PHP 8.3, providing an effective way to validate JSON strings in earlier PHP versions.
```php
if (!function_exists('json_validate')) {
/**
* Validates a JSON string.
*
* @param string $json The JSON string to validate.
* @param int $depth Maximum depth. Must be greater than zero.
* @param int $flags Bitmask of JSON decode options.
* @return bool Returns true if the string is a valid JSON, otherwise false.
*/
function json_validate($json, $depth = 512, $flags = 0) {
if (!is_string($json)) {
return false;
}
try {
json_decode($json, false, $depth, $flags | JSON_THROW_ON_ERROR);
return true;
} catch (\JsonException $e) {
return false;
}
}
}
```
Key Improvements:
- String Check: Added a validation to ensure the input is a string.
- Error Handling: Utilizes try-catch to effectively catch and handle JsonException.
- Backward Compatibility: Safely integrable in older PHP versions, automatically deferring to native functionality in PHP 8.3+.