Массив в строку и строку в массив: implode, explode, json, serialize
В PHP массив можно превратить в список через разделитель, закодировать в JSON или сохранить через serialize. Выбор зависит от того, что нужно восстановить из строки: отдельные значения, структуру данных или типы PHP. Для просмотра массива при отладке пригодятся print_r и var_dump.
Как преобразовать массив в строку в PHP через implode
implode($separator, $array) соединяет значения массива в порядке обхода. Разделитель появляется только между элементами. Ключи в результат не попадают, пустой массив даёт пустую строку. Для склейки без промежутков передайте '' первым аргументом.
<?php
declare(strict_types=1);
$roles = ['owner' => 'admin', 'guest' => 'reader'];
echo implode(', ', $roles); // admin, readerЧто происходит с числами, null и вложенными массивами
Приведение значений в implode действует и при strict_types=1. Числа преобразуются в текст, true становится '1', а false и null дают пустые поля. Например, implode('|', [0, false, null, true]) вернёт '0|||1'. Вложенный массив вызывает предупреждение Array to string conversion и превращается в текст Array. Для вложенных данных используйте JSON. Если числовые значения должны отображаться с заданной точностью, отформатируйте их до склейки.
В PHP 8.x разделитель передают первым аргументом. Старый порядок implode($array, $separator) удалён в PHP 8.0. Вызов implode($array) по-прежнему работает и соединяет элементы без разделителя.
PHP explode: как разбить строку в массив
explode($separator, $string, $limit) ищет точный разделитель, в том числе состоящий из нескольких символов, и возвращает массив строк с индексами от нуля. Если разделитель отсутствует, при обычном вызове результат содержит исходную строку. Соседние разделители и разделители по краям дают пустые элементы. Пустой разделитель в PHP 8.x вызывает ValueError.
<?php
declare(strict_types=1);
$fields = explode(':', 'host::443:'); // ['host', '', '443', '']
$pair = explode('=', 'token=a=b', 2); // ['token', 'a=b']
$parts = explode('/', 'a/b/c', -1); // ['a', 'b']Положительный $limit задаёт максимальное число элементов. Последний элемент содержит остаток строки вместе с оставшимися разделителями. Нулевой лимит трактуется как 1. Отрицательный лимит отбрасывает указанное число элементов с конца. Если разделителя нет и лимит отрицательный, возвращается пустой массив.
Пробелы, пустые поля и значение «0»
explode сохраняет пробелы и возвращает числа в виде строк. Если пропуски не нужны, обрежьте пробелы и удалите только пустые строки. Вызов array_filter($parts) без callback удалит также строку '0'. После фильтрации array_values восстановит последовательные индексы.
<?php
declare(strict_types=1);
$parts = array_map('trim', explode(',', ' PHP, , 0, SQL '));
$parts = array_values(array_filter(
$parts,
static fn (string $part): bool => $part !== ''
));
// ['PHP', '0', 'SQL']PHP split: preg_split для шаблонов и str_split для байтов
Функцию split() удалили в PHP 7.0. При переносе старого кода используйте explode для буквального разделителя и preg_split для регулярного выражения. Например, шаблон ниже разбивает строку по пробельным символам, запятым и точкам с запятой. Флаг PREG_SPLIT_NO_EMPTY исключает пустые фрагменты.
<?php
declare(strict_types=1);
$words = preg_split('/[\s,;]+/u', ' PHP, SQL; JSON ', -1, PREG_SPLIT_NO_EMPTY);
if ($words === false) {
throw new RuntimeException(preg_last_error_msg());
}
// ['PHP', 'SQL', 'JSON']Модификатор u включает обработку UTF-8. При неверном шаблоне preg_split выдаёт предупреждение, а при ошибке регулярного выражения возвращает false. Если нужно разрезать строку на фрагменты фиксированной длины, str_split($text, $length) считает байты. Для символов UTF-8 подойдёт mb_str_split($text, 1, 'UTF-8') из расширения mbstring. Если важно сохранить видимые символы целиком, например эмодзи с модификатором, можно выделить графемные кластеры шаблоном /\X/u через preg_match_all.
Для CSV используйте CSV-парсер
В CSV разделитель может находиться внутри поля в кавычках. explode(',', '42,"Иванов, Иван"') разрежет имя, а str_getcsv прочитает его как одно поле. Для файла используйте fgetcsv. С PHP 8.4 полагаться на значение параметра escape по умолчанию в этих функциях устарело. Явное escape: '' отключает экранирование обратной косой чертой и сохраняет стандартную обработку удвоенных кавычек.
<?php
declare(strict_types=1);
$row = str_getcsv('42,"Иванов, Иван"', escape: '');
// ['42', 'Иванов, Иван']Преобразование массива в JSON и обратно
JSON подходит для API и обмена структурированными данными. json_encode кодирует вложенные массивы, строки, числа, логические значения и null. json_decode читает JSON. Аргумент associative: true преобразует JSON-объекты в ассоциативные массивы PHP. Без него объекты по умолчанию становятся экземплярами stdClass, а JSON-массивы в обоих случаях становятся массивами PHP.
<?php
declare(strict_types=1);
$data = ['name' => 'Анна', 'roles' => ['editor'], 'active' => true];
$json = json_encode($data, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
$decoded = json_decode($json, associative: true, flags: JSON_THROW_ON_ERROR);
var_dump($decoded === $data); // bool(true)JSON_THROW_ON_ERROR даёт JsonException при ошибке кодирования или декодирования. Без этого флага результат null от json_decode может означать и корректный JSON null, и ошибку разбора. При чтении входящего запроса перехватите исключение и проверьте ожидаемую структуру. Валидный JSON может содержать число, строку или логическое значение вместо массива.
Разреженные индексы, большие числа и UTF-8
- Массив с последовательными индексами от нуля кодируется как JSON-массив. После
unsetилиarray_filterиндексы могут стать разреженными, и тогдаjson_encodeвыдаст JSON-объект. Если API ждёт список, применитеarray_valuesперед кодированием. Для проверки формы естьarray_is_list. - При
associative: trueпустые{}и[]декодируются в один и тот же пустой массив PHP. Если это различие важно, декодируйте объекты вstdClass. - Целое число из JSON за пределами диапазона
intможет статьfloatс потерей точности. При декодированииJSON_BIGINT_AS_STRINGсохраняет такое целое строкой. Для точной передачи идентификаторов удобно изначально хранить их как строки. - Строковые значения и ключи при кодировании должны быть в UTF-8.
JSON_UNESCAPED_UNICODEоставляет кириллицу читаемой, аJSON_INVALID_UTF8_SUBSTITUTEзаменяет некорректные последовательности символом замены, если такая потеря допустима.
Начиная с PHP 8.3 есть json_validate. Используйте её, если нужно проверить синтаксис без получения декодированного значения. Если данные сразу пойдут в работу, достаточно одного json_decode с JSON_THROW_ON_ERROR.
Когда использовать serialize и unserialize
serialize сохраняет ключи, вложенность и типы PHP. Например, 1 и '1' останутся разными значениями, а индексы массива сохранятся без перенумерации. Такой формат подходит для внутреннего обмена между PHP-компонентами. Сериализованная строка может содержать нулевые байты, поэтому при сохранении в базе ей подходит бинарное поле, например BLOB.
<?php
declare(strict_types=1);
$value = [2 => '1', 5 => 1, 'ready' => false];
$payload = serialize($value);
// Читаем данные, созданные собственным приложением.
$restored = unserialize($payload, ['allowed_classes' => false]);
var_dump($restored === $value); // bool(true)Передавайте в unserialize только доверенные данные. При восстановлении объектов PHP может вызывать __unserialize() или __wakeup(). Параметр allowed_classes ограничивает восстановление классов. Для данных из запроса, cookie или стороннего сервиса используйте JSON и проверяйте ожидаемые поля и типы.
Повреждение строки при записи или перекодировке может сорвать десериализацию. При ошибке unserialize возвращает false и выдаёт предупреждение, но значение false само по себе тоже сериализуется корректно как b:0;. Если по контракту хранится массив, проверьте результат через is_array. С PHP 8.3 лишние данные после сериализованного значения вызывают предупреждение. С PHP 8.4 некорректный тип параметра allowed_classes или недопустимый элемент списка классов приводит к исключению TypeError или ValueError.
Как вывести массив в PHP: print_r и var_dump
Прямой вызов echo $array выдаёт предупреждение Array to string conversion и печатает Array. Для отладки используйте print_r или var_dump. Первая функция показывает ключи и вложенность в компактном виде и с аргументом true возвращает текст. Вторая сразу выводит результат и показывает типы, длину строк в байтах и размеры массивов.
<?php
declare(strict_types=1);
$data = ['int' => 0, 'text' => '0', 'flag' => false, 'empty' => null];
$dump = print_r($data, true); // Получаем диагностическую строку.
echo $dump;
var_dump($data); // Видны int(0), string(1) "0", bool(false) и NULL.В выводе print_r число 0 и строка '0' выглядят одинаково, а false и null отображаются как пустые значения. Для проверки типов выбирайте var_dump. Если нужен текст в синтаксисе PHP, например для небольшого массива в конфигурации, используйте var_export($data, true).
В HTML-странице оберните диагностическую строку в <pre> и экранируйте её, если массив содержит пользовательские данные. Публичный вывод диагностики стоит отключить, а перед записью в журнал удалить пароли, токены и другие секреты.
<?php
declare(strict_types=1);
$data = ['query' => '<текст>'];
echo '<pre>', htmlspecialchars(print_r($data, true), ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'), '</pre>';Чек-лист выбора функции
- Показать список значений в интерфейсе. Используйте
implode. Если результат попадёт в HTML, экранируйте его для соответствующего контекста. - Разобрать строку по известному разделителю. Используйте
explode. Продумайте крайние разделители, пустые поля, пробелы и типы значений. Для записи видаключ=значениеиспользуйте лимит2. - Разобрать строку по шаблону или прочитать CSV. Используйте
preg_splitдля шаблона,str_getcsvдля строки CSV иfgetcsvдля файла. - Передать структуру в API. Используйте JSON с
JSON_THROW_ON_ERRORи проверьте, какая форма нужна получателю: список или объект. - Восстановить типы и ключи PHP из внутреннего хранилища. Используйте
serializeи читайте черезunserializeтолько данные доверенного происхождения. - Посмотреть массив при отладке. Используйте
print_rдля обзора структуры иvar_dumpдля проверки типов.
Перед сохранением через разделитель проверьте обратное преобразование на реальных данных. implode(',', []) и implode(',', ['']) дают одну и ту же пустую строку, а explode(',', '') возвращает ['']. Если нужно различать эти случаи или разделитель может встречаться внутри значения, выберите формат, который хранит границы элементов, например JSON.
Частые вопросы
Как в PHP превратить массив в строку через запятую?
Вызовите implode(', ', $array). Функция соединяет значения и пропускает ключи. Для вложенных данных или последующего восстановления структуры используйте json_encode.
Чем заменить split в PHP 8.3–8.5?
Для точного разделителя используйте explode, для регулярного выражения — preg_split. Если нужно разбить строку на отдельные символы UTF-8, используйте mb_str_split из расширения mbstring.
Что выбрать для вывода массива: print_r или var_dump?
print_r удобен для просмотра ключей и вложенности. Вызов print_r($array, true) возвращает строку. var_dump выводит типы и помогает различить 0, строку '0', false и null.