...
Eroare PHP · Fișiere și directoare

Fatal error: Uncaught ValueError: fputcsv(): Argument #3 ($separator) must be a single character in index.php:5

Pe scurt

Separatorul dat lui fputcsv() / fgetcsv() / str_getcsv() are mai mult de un caracter (', ', ';;', 'tab'). CSV-ul acceptă un singur caracter ca separator: ',', ';' sau "\t". Pune doar caracterul, fără spații.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Funcțiile CSV din PHP (fputcsv, fgetcsv, str_getcsv, SplFileObject::setCsvControl) primesc separatorul ($separator), caracterul de încadrare ($enclosure) și caracterul de escape ($escape). Separatorul și încadrarea trebuie să fie exact un caracter. Cu ', ' (virgulă și spațiu), ';;' sau 'tab', PHP aruncă ValueError: ... must be a single character.

Cazuri tipice: vrei un fișier „mai aerisit” și pui ', ', scrii cuvântul 'tab' în loc de caracterul "\t", sau folosești '\t' între apostrofuri (care în PHP înseamnă două caractere: \ și t, nu tab).

Pentru Excel românesc, separatorul obișnuit e ;. Din PHP 8.4 dă și parametrul $escape explicit (de obicei ''), altfel primești un mesaj Deprecated.

De ce apare: cauzele frecvente

1Virgulă urmată de spațiu

Greșit
PHP
<?php
$f = fopen('php://memory', 'w');
fputcsv($f, ['101', '250'], ', ');
Corect
PHP
<?php
$f = fopen('php://memory', 'w');
fputcsv($f, ['101', '250'], ',', '"', '');

Separatorul e un singur caracter; spațiile nu fac parte din formatul CSV.

2Tab scris între apostrofuri

Greșit
PHP
<?php
$f = fopen('php://memory', 'w');
fputcsv($f, ['a', 'b'], '\t');
Corect
PHP
<?php
$f = fopen('php://memory', 'w');
fputcsv($f, ['a', 'b'], "\t", '"', '');

Între ghilimele duble, \t e caracterul tab; între apostrofuri sunt două caractere.

3Încadrare cu mai multe caractere

Greșit
PHP
<?php
$r = str_getcsv('a,b', ',', '""');
Corect
PHP
<?php
$r = str_getcsv('a,b', ',', '"', '');

Și $enclosure trebuie să fie un singur caracter.

Repară tu

Repară eroarea, direct în pagină

Exportul de comenzi folosește separatorul '; ' (punct și virgulă cu spațiu), iar fputcsv aruncă ValueError: fputcsv(): Argument #3 ($separator) must be a single character. Folosește separatorul ; (și dă explicit '"' și '' pentru încadrare și escape), ca programul să afișeze 101;250 și 102;90.

Codul care dă eroarea
PHP
<?php
$comenzi = [[101, 250], [102, 90]];
$f = fopen('php://memory', 'w+');
foreach ($comenzi as $rand) {
    fputcsv($f, $rand, '; ');
}
rewind($f);
echo stream_get_contents($f);
După reparație, programul afișează
101;250
102;90
Indiciu

Separatorul e doar ';', iar apelul devine fputcsv($f, $rand, ';', '"', '').

Alte forme ale mesajului

  • Fatal error: Uncaught ValueError: fgetcsv(): Argument #2 ($separator) must be a single character in index.php:6
  • Fatal error: Uncaught ValueError: str_getcsv(): Argument #2 ($separator) must be a single character in index.php:3
  • Fatal error: Uncaught ValueError: fputcsv(): Argument #4 ($enclosure) must be a single character in index.php:5
  • Warning: fputcsv(): delimiter must be a single character in index.php on line 5

Cum o eviți pe viitor

  • Ține separatorul într-o constantă (const SEP = ';';) și folosește-l peste tot.
  • Scrie tab-ul cu ghilimele duble: "\t".
  • Dă toți parametrii CSV explicit: fputcsv($f, $rand, ';', '"', '') (PHP 8.4 cere $escape).
  • Deschide fișierul generat într-un editor text, nu doar în Excel, ca să vezi separatorul real.

Întrebări frecvente

Ce separator folosesc pentru Excel în română?

De obicei ;, pentru că în setările regionale românești virgula e separator zecimal. Pentru diacritice corecte în Excel, scrie la începutul fișierului BOM-ul UTF-8 ("\xEF\xBB\xBF").

Pot avea spații după separator în fișier?

Formatul CSV nu le prevede: spațiile ar face parte din valoare. Dacă le primești la citire, curăță valorile cu array_map('trim', $rand).

Erori înrudite

← Toate erorile PHP

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață PHP de la zero, cu exerciții la fiecare lecție

Curs PHP: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.