...
Eroare PHP · Mesaje Deprecated la upgrade de versiune

Deprecated: fgetcsv(): the $escape parameter must be provided as its default value will change in index.php on line 5

Pe scurt

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

Greșit
PHP
<?php
while (($rand = fgetcsv($f)) !== false) {
    $randuri[] = $rand;
}
Corect
PHP
<?php
while (($rand = fgetcsv($f, null, ',', '"', '')) !== false) {
    $randuri[] = $rand;
}

Cu '', citirea urmează formatul CSV standard, iar mesajul dispare.

2str_getcsv pe o linie

Greșit
PHP
<?php
$campuri = str_getcsv('Ana,Cluj,"0722 111 222"');
Corect
PHP
<?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

Greșit
PHP
<?php
fputcsv($f, ['Cană', '29,90'], ';');
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?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";
După reparație, programul afișează
Comenzi: 3
Total: 224.4 lei
Indiciu

Apelul complet e fgetcsv($f, null, ',', '"', '').

Alte forme ale mesajului

  • Deprecated: fputcsv(): the $escape parameter must be provided as its default value will change in index.php on line 5
  • Deprecated: str_getcsv(): the $escape parameter must be provided as its default value will change in index.php on line 3
  • Deprecated: 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

← 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.