Fatal error: Uncaught ValueError: fputcsv(): Argument #3 ($separator) must be a single character in index.php:5
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
<?php
$f = fopen('php://memory', 'w');
fputcsv($f, ['101', '250'], ', ');<?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
<?php
$f = fopen('php://memory', 'w');
fputcsv($f, ['a', 'b'], '\t');<?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
<?php
$r = str_getcsv('a,b', ',', '""');<?php
$r = str_getcsv('a,b', ',', '"', '');Și $enclosure trebuie să fie un singur caracter.
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.
<?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);101;250 102;90
Indiciu
Separatorul e doar ';', iar apelul devine fputcsv($f, $rand, ';', '"', '').
Reparația
<?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);De ce merge
Formatul CSV desparte valorile printr-un singur caracter, deci '; ' (două caractere) a fost respins cu ValueError chiar la primul rând.
Cu ';', fiecare rând devine 101;250. Ghilimelele ('"') și escape-ul gol ('') sunt date explicit, așa cum cere PHP 8.4, ca să nu apară mesajul Deprecated despre $escape.
Alte forme ale mesajului
Fatal error: Uncaught ValueError: fgetcsv(): Argument #2 ($separator) must be a single character in index.php:6Fatal error: Uncaught ValueError: str_getcsv(): Argument #2 ($separator) must be a single character in index.php:3Fatal error: Uncaught ValueError: fputcsv(): Argument #4 ($enclosure) must be a single character in index.php:5Warning: 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
Deprecated: fgetcsv(): the $escape parameter must be provided as its default value will change in index.php on line 5 Din PHP 8.4, fgetcsv(), fputcsv() și str_getcsv() cer să dai explicit al cincilea argument, $escape, pentru că valoarea implicită ("\\") se va schimba. Pentru CSV standard (ca în Excel) dă un text gol: fgetcsv($f, null, ',', '"', ''). Fatal error: Uncaught ValueError: explode(): Argument #1 ($separator) cannot be empty in index.php:3 Ai apelat explode() cu separatorul '' (text gol), de obicei ca să împarți un cuvânt în litere. explode nu poate tăia „între” caractere. Folosește str_split($text) sau, pentru diacritice, mb_str_split($text). Fatal error: Uncaught TypeError: fwrite(): Argument #1 ($stream) must be of type resource, bool given in index.php:4 fopen() nu a putut deschide fișierul și a întors false, iar tu ai dat acel false mai departe lui fwrite() (sau fgets, fclose). Eroarea reală e mai sus, la fopen: de obicei folderul nu există sau lipsesc drepturile. Verifică rezultatul lui fopen și repară calea. Î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.
