JSON в массив PHP

Пример

Ввод:

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

Результат (краткий синтаксис, одинарные кавычки):

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

Сопоставление типов

Когда использовать ассоциативный, а когда индексированный массив

В PHP есть единственный тип массива с обоими поведениями. JSON же чётко различает объект и массив, поэтому сопоставление такое:

• {} → ассоциативный массив (['key' => value]).
• [] → индексированный массив ([value, value]).

Генератор всегда сохраняет это различие; смешивать их в PHP допустимо, но это запутывает.

Особенности PHP, о которых стоит помнить

• Числовые строковые ключи. PHP приводит "42" к целочисленному ключу 42 в массиве. Если в вашем JSON числовые строки используются как ключи и вам нужно сохранить их строками, обход через array_combine их не сохранит.
• Большие целые числа. JSON может содержать целые числа больше PHP_INT_MAX на 32-битных сборках. Генератор предупреждает, когда это возможно.
• UTF-8. Строки PHP, это последовательности байтов; генератор выводит UTF-8 буквально. Убедитесь, что файл .php сохранён в UTF-8 без BOM.

Сценарии использования

• Файлы конфигурации. И Laravel, и Symfony используют конфигурацию в виде массивов PHP. Перенос конфигурации из JSON в стиле вендора работает хорошо.
• Тестовые фикстуры. Фикстуры PHPUnit в виде массивов чище, чем файлы JSON, загружаемые во время выполнения.
• Сидеры. Сидеры базы данных в Laravel часто начинаются как дамп JSON и превращаются в массивы PHP.

Распространённые ошибки

• Обратное преобразование массивов PHP в JSON. json_encode трактует ассоциативный массив как объект, а индексированный, как массив. Если их смешать (['key' => 'val', 0 => 'x']), на выходе получится объект. Держите массивы JSON-образной формы в форме JSON.
• Двойные кавычки с апострофами. Строки PHP в одинарных кавычках требуют экранирования \'; строки в двойных кавычках требуют экранирования \\", и переменные могут случайно интерполироваться, если не быть внимательным. Для данных используйте одинарные кавычки.
• Забытые завершающие запятые. PHP допускает их с версии 7.3, и они делают диффы чище. Генератор добавляет их по умолчанию.