JSON naar PHP-array

Voorbeeld

Invoer:

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

Uitvoer (korte syntaxis, enkele aanhalingstekens):

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

Typetoewijzing

Wanneer associatief versus geïndexeerd gebruiken

PHP heeft één arraytype met beide gedragingen. JSON maakt duidelijk onderscheid tussen object en array, dus de toewijzing is:

• {} → associatief (['key' => value]).
• [] → geïndexeerd ([value, value]).

De generator behoudt altijd het onderscheid; de twee in PHP mengen mag, maar is verwarrend.

PHP-specifieke valkuilen

• Numerieke string-sleutels. PHP zet "42" om naar de gehele sleutel 42 in een array. Als je JSON numerieke strings als sleutels gebruikt en je ze als strings nodig hebt, bewaart de heen-en-weerconversie via array_combine ze niet.
• Grote gehele getallen. JSON kan gehele getallen bevatten die groter zijn dan PHP_INT_MAX op 32-bits builds. De generator waarschuwt wanneer dat kan gebeuren.
• UTF-8. PHP-strings zijn bytereeksen; de generator geeft UTF-8 letterlijk uit. Zorg dat je .php-bestand als UTF-8 zonder BOM is opgeslagen.

Toepassingen

• Configuratiebestanden. Zowel Laravel als Symfony gebruiken PHP-array-configuratie. Een JSON-configuratie in vendor-stijl overnemen werkt goed.
• Testfixtures. PHPUnit-fixtures zijn als arrays overzichtelijker dan als JSON-bestanden die tijdens runtime worden geladen.
• Seeders. Database-seeders in Laravel beginnen vaak als een JSON-dump en worden PHP-arrays.

Veelgemaakte fouten

• PHP-arrays terug omzetten naar JSON. json_encode behandelt een associatieve array als een object en een geïndexeerde array als een array. Als je ze mengt (['key' => 'val', 0 => 'x']), krijg je bij de uitvoer een object. Houd JSON-vormige arrays JSON-vormig.
• Dubbele aanhalingstekens met apostroffen. PHP-strings met enkele aanhalingstekens moeten \' escapen; strings met dubbele aanhalingstekens moeten \\" escapen, en variabelen worden per ongeluk geïnterpoleerd als je niet oplet. Gebruik enkele aanhalingstekens voor data.
• Afsluitende komma’s vergeten. PHP staat ze toe sinds PHP 7.3 en ze maken diffs schoner. De generator voegt ze standaard toe.