PHP explode(): разбить строку на массив

explode($separator, $string) разбивает строку в каждом месте, где встречается $separator, и возвращает части массивом. explode(',', 'apple,banana,cherry') даёт ['apple', 'banana', 'cherry'].

<?php
$csv = 'apple,banana,cherry';
$fruits = explode(',', $csv);

print_r($fruits);
echo $fruits[1], "\n";
echo count($fruits), " fruits\n";

Разделителем может быть любая строка, а не только один символ: explode(' and ', 'tea and milk and sugar') работает так же. Обратная операция, склейка массива обратно в строку, это implode().

Синтаксис и возвращаемое значение

explode(string $separator, string $string, int $limit = PHP_INT_MAX): array

Функция всегда возвращает массив. Если разделитель не встречается, массив содержит всю строку единственным элементом. Это касается и пустой строки, которая даёт массив с одной пустой строкой внутри; отсюда частая ошибка "мой цикл выполняется один раз на пустом вводе".

<?php
var_dump(explode(',', 'apple'));   // separator not found
var_dump(explode(',', ''));        // empty input
var_dump(explode(',', 'a,,b,'));   // empty pieces are kept

// If an empty string should mean "no items", check before splitting
$input = '';
$tags = $input === '' ? [] : explode(',', $input);
echo count($tags), "\n";

Ограничение числа частей

Третий аргумент, $limit, меняет число получаемых частей:

• Положительный limit возвращает не больше указанного числа частей. Последняя часть содержит остаток строки вместе с разделителями.
• Отрицательный limit возвращает все части, кроме последних abs($limit).
• Limit 0 считается равным 1.

<?php
$path = 'home/ada/projects/site/index.php';

print_r(explode('/', $path, 2));   // first piece, then the rest
print_r(explode('/', $path, -1));  // everything except the file name
print_r(explode('/', $path, 0));   // treated as 1

Положительный limit подходит, когда важен только первый разделитель, например в строке key=value, где значение тоже может содержать =: explode('=', 'query=a=b', 2) даёт ['query', 'a=b']. Следующие разделы используют его именно так.

Чтобы получить только последнюю часть, сначала сохраните массив в переменную: $parts = explode('/', $path); $file = end($parts);. Запись end(explode('/', $path)) всё равно вернёт правильное значение, но PHP напечатает Notice: Only variables should be passed by reference, потому что end() принимает аргумент по ссылке.

Разбиение строки по переносу строки

explode("\n", $text) разбивает по переносам строк. Используйте двойные кавычки: в одинарных '\n' это обратный слеш и буква n, а не перенос строки. Текст из файлов Windows или HTML-форм часто заканчивает строки на "\r\n", и тогда в конце каждой части остаётся лишний "\r". preg_split('/\R/', $text) разбивает по любому виду переноса строки.

<?php
$text = "first line\r\nsecond line\nthird line";

$pieces = explode("\n", $text);
var_dump($pieces[0]);   // still ends with \r

$lines = preg_split('/\R/', $text);
var_dump($lines);

Обрезка частей и удаление пустых

Пользовательский ввод вроде "red, green , ,blue" содержит пробелы вокруг элементов и пустой элемент посередине. Пропустите части через trim() с помощью array_map(), а потом удалите пустые строки через array_filter(). array_values() затем перенумеровывает ключи, потому что array_filter() сохраняет исходные.

<?php
$input = 'red, green , ,blue';

$colors = array_map('trim', explode(',', $input));
$colors = array_values(array_filter($colors, fn($c) => $c !== ''));

print_r($colors);

Колбэк fn($c) => $c !== '' сохраняет строку "0". Простой array_filter($colors) её бы отбросил, потому что "0" ложно.

Строку в ассоциативный массив

Настройки, cookie и похожие на запрос строки часто хранятся парами key=value. Разбейте дважды: один раз на пары, второй раз каждую пару с limit 2, распаковав две части в переменные (деструктуризация массива).

<?php
$settings = 'theme=dark;lang=ja;filter=a=b';

$result = [];
foreach (explode(';', $settings) as $pair) {
    [$key, $value] = explode('=', $pair, 2);
    $result[$key] = $value;
}

print_r($result);
echo $result['lang'], "\n";

Пара без =, например debug, даёт массив из одного элемента, и деструктуризация печатает Warning: Undefined array key 1. Чтобы этого избежать, дополните результат до двух элементов: [$key, $value] = explode('=', $pair, 2) + [1 => ''];.

Для настоящей строки запроса из URL это делает parse_str(), которая к тому же декодирует %20 и +.

Разбиение по нескольким разделителям

explode() принимает один разделитель. Чтобы разбивать по запятым, точкам с запятой или пробелам, используйте preg_split() с классом символов. PREG_SPLIT_NO_EMPTY отбрасывает пустые части, которые возникают, когда два разделителя идут подряд.

<?php
$input = 'php, javascript;python  go|rust';

$words = preg_split('/[\s,;|]+/', $input, -1, PREG_SPLIT_NO_EMPTY);
print_r($words);

Японский и другой текст в UTF-8

explode() сравнивает байты, а в UTF-8 полный символ никогда не встречается внутри байтов другого символа, поэтому разбиение японского текста по японскому разделителю вроде 、 или полноширинной запятой работает правильно.

<?php
$cities = '東京、大阪、京都';
print_r(explode('、', $cities));

// Split into single characters: mb_str_split counts characters, str_split counts bytes
print_r(mb_str_split('日本語'));

explode, str_split и preg_split

explode() не работает с регулярными выражениями, поэтому быстрее preg_split(), и именно её стоит брать, когда разделитель это фиксированная строка.

Частая ошибка: пустой разделитель

Пустой разделитель это ошибка. Начиная с PHP 8.0 explode('', 'abc') выбрасывает ValueError, а не возвращает false, и скрипт останавливается:

PHP Fatal error:  Uncaught ValueError: explode(): Argument #1 ($separator) cannot be empty in /home/index.php:3

Чтобы разбить строку на символы, используйте str_split('abc') для ASCII-текста или mb_str_split($s) для всего, где могут быть многобайтовые символы.