PHP

Detecta errores de sintaxis en un archivo JSON con PHP

Portada del artículo «Detecta errores de sintaxis en un archivo JSON con PHP».

Crearás un script que comprueba si un archivo contiene JSON válido y muestra el error cuando no puede interpretarlo. Te sirve para revisar un archivo antes de usar sus datos en una aplicación.

Requisitos

Necesitas PHP disponible desde la terminal y un editor de texto. Comprueba que PHP está instalado con:

php --version

1. Crea el archivo de comprobación

En una carpeta de trabajo, crea el siguiente archivo. El script recibe la ruta del JSON como argumento, es decir, como dato añadido al comando.

validar-json.php:

<?php

if ($argc !== 2) {
    fwrite(STDERR, 'Uso: php validar-json.php archivo.json' . PHP_EOL);
    exit(2);
}

$ruta = $argv[1];
$contenido = @file_get_contents($ruta);

if ($contenido === false) {
    fwrite(STDERR, 'No se pudo leer el archivo: ' . $ruta . PHP_EOL);
    exit(2);
}

json_decode($contenido);

if (json_last_error() !== JSON_ERROR_NONE) {
    fwrite(STDERR, 'JSON no válido: ' . json_last_error_msg() . PHP_EOL);
    exit(1);
}

echo 'JSON válido' . PHP_EOL;

json_decode() intenta interpretar el contenido. Después, json_last_error() indica si esa operación falló y json_last_error_msg() describe el último error. La comprobación no se basa en el valor devuelto por json_decode(), porque null también es un contenido JSON válido.

El símbolo @ evita que PHP muestre su propio aviso de lectura; el script muestra en su lugar un mensaje más claro. Este script comprueba la sintaxis, no que los datos tengan los campos o valores que espera una aplicación.

2. Prepara un archivo con un error

En la misma carpeta, crea este archivo sin la coma entre las dos propiedades:

datos.json:

{
  "nombre": "Ana"
  "edad": 28
}

Desde la terminal, situada en esa carpeta, ejecuta:

php validar-json.php datos.json

Deberías ver un mensaje que comienza por JSON no válido:, seguido de la descripción del error proporcionada por PHP. Si aparece No se pudo leer el archivo, comprueba que el nombre y la ruta sean correctos.

3. Corrige y prueba de nuevo

Añade la coma que falta después de "Ana":

datos.json:

{
  "nombre": "Ana",
  "edad": 28
}

Ejecuta otra vez:

php validar-json.php datos.json

Ahora deberías ver:

JSON válido

Tutoriales relacionados