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, ',', '"', '').
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Funcțiile CSV ale PHP au un parametru $escape, cu valoarea implicită "\\" (backslash). Formatul CSV standard (RFC 4180, folosit de Excel și Google Sheets) nu are caracter de escape: ghilimelele din text se dublează (""). Backslash-ul implicit al PHP face ca un text care se termină cu \ înaintea unei ghilimele să fie citit greșit, iar fișierele scrise de PHP să nu fie citite corect de alte programe.
Ca să poată schimba valoarea implicită în viitor, PHP 8.4 afișează acest Deprecated de fiecare dată când apelezi fgetcsv(), fputcsv(), str_getcsv() (sau SplFileObject::fgetcsv()) fără să dai $escape.
Ce dai:
''(text gol): comportamentul standard, recomandat pentru fișiere noi și pentru CSV din Excel;'\\': păstrezi exact comportamentul vechi, dacă ai fișiere create cu acest format.
Ordinea argumentelor: fgetcsv($f, $lungime, $separator, $ghilimele, $escape); str_getcsv($text, $separator, $ghilimele, $escape).
De ce apare: cauzele frecvente
1Citire fără escape explicit
<?php
while (($rand = fgetcsv($f)) !== false) {
$randuri[] = $rand;
}<?php
while (($rand = fgetcsv($f, null, ',', '"', '')) !== false) {
$randuri[] = $rand;
}Cu '', citirea urmează formatul CSV standard, iar mesajul dispare.
2str_getcsv pe o linie
<?php
$campuri = str_getcsv('Ana,Cluj,"0722 111 222"');<?php
$campuri = str_getcsv('Ana,Cluj,"0722 111 222"', ',', '"', '');str_getcsv are același parametru, pe poziția a patra.
3Scriere cu separator românesc
<?php
fputcsv($f, ['Cană', '29,90'], ';');<?php
fputcsv($f, ['Cană', '29,90'], ';', '"', '');Excel în română folosește des ; ca separator. Restul argumentelor trebuie date explicit până la $escape.
Repară eroarea, direct în pagină
Funcția totalCsv citește comenzile dintr-un CSV și adună totalul, dar la fiecare rând afișează Deprecated: fgetcsv(): the $escape parameter must be provided as its default value will change. Dă explicit toți parametrii lui fgetcsv (escape gol, formatul CSV standard), ca programul să afișeze Comenzi: 3 și Total: 224.4 lei, fără mesaje Deprecated.
<?php
function totalCsv($f): array
{
$comenzi = 0;
$total = 0;
while (($rand = fgetcsv($f)) !== false) {
$comenzi++;
$total += (float) $rand[1];
}
return [$comenzi, $total];
}
$f = fopen('php://temp', 'w+');
fwrite($f, "Ana,29.9\n\"Pop, Mihai\",149\nIon,45.5\n");
rewind($f);
[$n, $t] = totalCsv($f);
echo "Comenzi: $n\n";
echo "Total: $t lei\n";Comenzi: 3 Total: 224.4 lei
Indiciu
Apelul complet e fgetcsv($f, null, ',', '"', '').
Reparația
<?php
function totalCsv($f): array
{
$comenzi = 0;
$total = 0;
while (($rand = fgetcsv($f, null, ',', '"', '')) !== false) {
$comenzi++;
$total += (float) $rand[1];
}
return [$comenzi, $total];
}
$f = fopen('php://temp', 'w+');
fwrite($f, "Ana,29.9\n\"Pop, Mihai\",149\nIon,45.5\n");
rewind($f);
[$n, $t] = totalCsv($f);
echo "Comenzi: $n\n";
echo "Total: $t lei\n";De ce merge
Din PHP 8.4, apelul fgetcsv($f) fără $escape afișează Deprecated, pentru că valoarea implicită (backslash) nu corespunde formatului CSV standard și se va schimba.
Apelul complet dă lungimea (null = fără limită), separatorul, caracterul pentru ghilimele și escape-ul gol. Rezultatul e același: "Pop, Mihai" rămâne un singur câmp, chiar dacă are virgulă, iar suma celor trei prețuri e 224.4.
Alte forme ale mesajului
Deprecated: fputcsv(): the $escape parameter must be provided as its default value will change in index.php on line 5Deprecated: str_getcsv(): the $escape parameter must be provided as its default value will change in index.php on line 3Deprecated: SplFileObject::fgetcsv(): the $escape parameter must be provided as its default value will change in index.php on line 6
Cum o eviți pe viitor
- Scrie o funcție proprie
citesteCsv()care dă toate argumentele o singură dată. - Pentru fișiere noi, folosește
$escape = ''atât la scriere, cât și la citire. - Pentru
SplFileObject, setează o dată$file->setCsvControl(',', '"', ''). - Pentru CSV-uri mari sau complicate, ia în calcul o bibliotecă (de ex.
league/csv).
Întrebări frecvente
Ce valoare să aleg, '' sau '\\'?
Pentru fișiere din Excel, Google Sheets sau alte programe, ''. Alege '\\' doar dacă ai fișiere vechi scrise de PHP care folosesc backslash înaintea ghilimelelor.
Rezultatul se schimbă dacă pun ''?
Pentru majoritatea fișierelor, nu. Diferă doar câmpurile care conțin \ urmat de ghilimea, care acum sunt citite după standard.
Erori înrudite
Deprecated: Function utf8_encode() is deprecated since 8.2, visit the php.net documentation for various alternatives in index.php on line 3 utf8_encode() și utf8_decode() sunt învechite din PHP 8.2: convertesc doar din și în ISO-8859-1 (Latin-1), deși numele sugerează altceva. Folosește mb_convert_encoding($text, 'UTF-8', 'ISO-8859-1') sau, pentru diacritice românești, sursa corectă: 'Windows-1250' ori 'ISO-8859-2'. Warning: file_get_contents(produse.csv): Failed to open stream: No such file or directory in index.php on line 3 Fișierul pe care vrei să-l citești nu există la calea dată, de obicei pentru că o cale relativă e calculată față de folderul de lucru, nu față de script. Folosește o cale absolută cu __DIR__ (__DIR__ . '/date/produse.csv') și verifică is_file() înainte, ca să tratezi lipsa fișierului. Fatal error: Uncaught TypeError: fclose(): supplied resource is not a valid stream resource in index.php:9 Fișierul a fost deja închis, iar acum încerci să-l folosești sau să-l închizi din nou, de obicei pentru că și o funcție ajutătoare, și codul principal apelează fclose(). Închide fișierul într-un singur loc (ideal în finally) și nu-l mai folosi după fclose(). Î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.
