JSON do tablicy PHP

Przykład

Wejście:

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

Wynik (skrócona składnia, pojedyncze cudzysłowy):

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

Mapowanie typów

Kiedy używać tablic asocjacyjnych, a kiedy indeksowanych

PHP ma jeden typ tablicy o obu zachowaniach. JSON wyraźnie rozróżnia obiekt i tablicę, więc mapowanie jest następujące:

• {} → tablica asocjacyjna (['key' => value]).
• [] → tablica indeksowana ([value, value]).

Generator zawsze zachowuje to rozróżnienie; mieszanie obu w PHP jest dozwolone, ale mylące.

Pułapki charakterystyczne dla PHP

• Klucze będące ciągami liczbowymi. PHP rzutuje "42" na całkowity klucz 42 w tablicy. Jeśli Twój JSON używa ciągów liczbowych jako kluczy i potrzebujesz ich jako ciągów, konwersja w obie strony przez array_combine ich nie zachowa.
• Duże liczby całkowite. JSON może zawierać liczby całkowite większe niż PHP_INT_MAX w kompilacjach 32-bitowych. Generator ostrzega, gdy może się to zdarzyć.
• UTF-8. Ciągi znaków w PHP to sekwencje bajtów; generator wypisuje UTF-8 dosłownie. Upewnij się, że plik .php jest zapisany jako UTF-8 bez BOM.

Przykłady zastosowań

• Pliki konfiguracyjne. Zarówno Laravel, jak i Symfony korzystają z konfiguracji w postaci tablic PHP. Przeniesienie konfiguracji z JSON w stylu dostawcy sprawdza się dobrze.
• Fikstury testowe. Fikstury PHPUnit są czytelniejsze jako tablice niż jako pliki JSON ładowane w czasie wykonywania.
• Seedery. Seedery baz danych w Laravel często zaczynają się jako zrzut JSON i stają się tablicami PHP.

Częste błędy

• Konwersja tablic PHP z powrotem do JSON. json_encode traktuje tablicę asocjacyjną jako obiekt, a indeksowaną jako tablicę. Jeśli je pomieszasz (['key' => 'val', 0 => 'x']), na wyjściu otrzymasz obiekt. Trzymaj tablice o kształcie JSON w kształcie JSON.
• Podwójne cudzysłowy z apostrofami. Ciągi PHP w pojedynczych cudzysłowach wymagają ekranowania \'; ciągi w podwójnych cudzysłowach wymagają ekranowania \\", a zmienne mogą zostać przypadkowo zinterpolowane, jeśli nie zachowasz ostrożności. W przypadku danych używaj pojedynczych cudzysłowów.
• Zapominanie o końcowych przecinkach. PHP dopuszcza je od PHP 7.3 i sprawiają, że różnice (diff) są czytelniejsze. Generator dodaje je domyślnie.