JSON a Array de PHP

Ejemplo

Entrada:

{ "app": { "name": "Hyperion", "debug": true, "hosts": ["h1.example.com", "h2.example.com"] } }

Salida (sintaxis corta, comillas simples):

[
    'app' => [
        'name' => 'Hyperion',
        'debug' => true,
        'hosts' => [
            'h1.example.com',
            'h2.example.com',
        ],
    ],
]

Mapeo de tipos

Cuándo usar asociativo vs indexado

PHP tiene un tipo de array con ambos comportamientos. JSON distingue claramente entre objeto y array, por lo que el mapeo es:

• {} -> asociativo (['key' => value]).
• [] -> indexado ([value, value]).

El generador siempre preserva la distinción; mezclar los dos en PHP es legal pero confuso.

Trucos específicos de PHP

• Claves de cadena numérica. PHP convierte "42" a la clave entera 42 en un array. Si tu JSON usa cadenas numéricas como claves y las necesitas como cadenas, el viaje de ida y vuelta de array_combine no las preservará.
• Enteros grandes. JSON puede contener enteros más grandes que PHP_INT_MAX en compilaciones de 32 bits. El generador advierte cuando eso podría suceder.
• UTF-8. Las cadenas de PHP son secuencias de bytes; el generador emite UTF-8 literalmente. Asegúrate de que tu archivo .php esté guardado como UTF-8 sin BOM.

Casos de uso

• Archivos de configuración: Laravel y Symfony utilizan configuración de array de PHP. Pegar un archivo de configuración JSON al estilo de un proveedor funciona bien.
• Fixtures de prueba: Las fixtures de PHPUnit son más limpias como arrays que como archivos JSON cargados en tiempo de ejecución.
• Seeds: los sembradores de bases de datos en Laravel a menudo comienzan como un volcado JSON y se convierten en arrays de PHP.

Errores comunes

• Viaje de ida y vuelta de arrays de PHP a JSON. json_encode trata un array asociativo como un objeto y un array indexado como un array. Si los mezclas (['key' => 'val', 0 => 'x']), obtienes un objeto al salir. Mantén los arrays con forma de JSON en forma de JSON.
• Comillas dobles con apóstrofes. Las cadenas de PHP con comillas simples necesitan \\' escapadas; las cadenas con comillas dobles necesitan \\" escapadas y las variables se interpolan accidentalmente si no tienes cuidado. Usa comillas simples para datos.
• Olvidar comas finales. PHP las permite desde PHP 7.3 y hacen que las diferencias sean más limpias. El generador las añade por defecto.