PHPTime

Массив в строку и строку в массив: implode, explode, json, serialize

В PHP массив можно превратить в список через разделитель, закодировать в JSON или сохранить через serialize. Выбор зависит от того, что нужно восстановить из строки: отдельные значения, структуру данных или типы PHP. Для просмотра массива при отладке пригодятся print_r и var_dump.

Как преобразовать массив в строку в PHP через implode

implode($separator, $array) соединяет значения массива в порядке обхода. Разделитель появляется только между элементами. Ключи в результат не попадают, пустой массив даёт пустую строку. Для склейки без промежутков передайте '' первым аргументом.

PHP
<?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
<?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
<?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
<?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
<?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
<?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
<?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
<?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
<?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.

Справка по теме

Ещё в разделе «Справочник PHP»

Массивы в PHP: создание, перебор и основные функции

Как создавать массивы в PHP, работать с ключами и индексами, перебирать элементы, фильтровать и объединять данные. Примеры и отличия PHP 8.3–8.5.

9 мин

Настройка php.ini: memory_limit, upload_max_filesize, таймауты

Как настроить php.ini в PHP 8.3–8.5: выбрать memory_limit, согласовать лимиты загрузки и таймауты PHP-FPM и Nginx, проверить настройки и разобрать ошибки.

8 мин

Обработка форм в PHP: $_GET, $_POST, валидация и защита

Как обработать HTML-форму в PHP 8.3–8.5: выбрать GET или POST, прочитать php://input, проверить поля, экранировать HTML и защитить запрос от CSRF.

10 мин

Операторы PHP: сравнение, ??, ?->, тернарный оператор и match

Операторы и условия PHP 8.3–8.5 на коротких примерах. Как работают сравнение, не равно, ??, ?->, тернарный оператор, if else, switch case и match.

9 мин