Выполняет разбор CSV-строки в массив

Описание

str_getcsv(
    string $string,
    string $separator = ",",
    string $enclosure = "\"",
    string $escape = "\\"
): array

Данная функция выполняет разбор строки в формате CSV и возвращает массив с полученными из строки полями.

Замечание:
Эта функция принимает во внимание настройки локали. К примеру, если LC_CTYPE установлена в en_US.UTF-8, то строки в однобайтовой кодировке будут неправильно прочитаны этой функцией.

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

string: Обрабатываемая строка.
separator: Устанавливает разделитель поля (только один однобайтовый символ).
enclosure: Устанавливает символ ограничителя поля (только один однобайтовый символ).
escape: Устанавливает экранирующий символ (не более одного однобайтового символа). По умолчанию равен обратному слешу (\). Пустая строка ("") отключает проприетарный механизм экранирования.

Замечание: Обычно символ enclosure экранируется внутри поля путём его удваивания; однако, символ escape в качестве альтернативы. Поэтому значения по умолчанию этих параметров "" и \" имеют одинаковое значение. Помимо разрешения экранировать символ enclosure символ escape не имеет особого смысла; он даже не предназначен для самого экранирования.

Возвращаемые значения

Возвращает индексированный массив, содержащий полученные из строки поля.

Список изменений

Версия	Описание
7.4.0	Теперь пустой параметр `escape` будет интерпретироваться как требование отключения проприетарного механизма экранирования. Ранее пустая строка обозначала использование символа экранирования по умолчанию.

Примеры

Пример #1 Пример использования str_getcsv()

<?php

$string = 'PHP,Java,Python,Kotlin,Swift';
$data = str_getcsv($string);

var_dump($data);
?>

Результат выполнения данного примера:

array(5) {
  [0]=>
  string(3) "PHP"
  [1]=>
  string(4) "Java"
  [2]=>
  string(6) "Python"
  [3]=>
  string(6) "Kotlin"
  [4]=>
  string(5) "Swift"
}

Смотрите также

fgetcsv() - Читает строку из файла и производит разбор данных CSV