Fatal error: Uncaught ValueError: fread(): Argument #2 ($length) must be greater than 0 in index.php:5
Ai apelat fread($f, filesize($cale)) pe un fișier gol: filesize() a dat 0, iar fread() nu acceptă lungimea 0. Folosește file_get_contents($cale), care merge și pe fișiere goale, sau verifică mărimea înainte de fread().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
fread($stream, $lungime) citește cel mult $lungime bytes. Din PHP 8, lungimea trebuie să fie mai mare decât 0; altfel aruncă ValueError: fread(): Argument #2 ($length) must be greater than 0 și scriptul se oprește.
Combinația clasică din tutoriale vechi este fread($f, filesize($cale)). Merge cât timp fișierul are conținut, dar la un fișier gol (un log nou, un export fără rânduri) filesize dă 0, iar fread aruncă eroarea. Dacă fișierul lipsește, filesize dă false, care devine tot 0.
În PHP 7 aceeași situație dădea doar Warning: fread(): Length parameter must be greater than 0. Pentru citirea unui fișier întreg nu ai nevoie de fread: file_get_contents face totul într-un pas.
De ce apare: cauzele frecvente
1fread cu filesize pe un fișier gol
<?php
$f = fopen(__DIR__ . '/log.txt', 'w+');
echo fread($f, filesize(__DIR__ . '/log.txt'));<?php
file_put_contents(__DIR__ . '/log.txt', '');
echo file_get_contents(__DIR__ . '/log.txt');file_get_contents întoarce '' pentru un fișier gol, fără eroare.
2Lungime calculată care iese 0
<?php
$f = fopen('php://memory', 'r+');
$bucata = 0;
fread($f, $bucata);<?php
$f = fopen('php://memory', 'r+');
$bucata = 8192;
while (!feof($f)) {
$date = fread($f, $bucata);
break;
}Pentru citire pe bucăți folosești o mărime fixă, pozitivă, și te oprești la feof.
3Fișierul lipsește
<?php
$cale = __DIR__ . '/nu-exista.txt';
$f = @fopen($cale, 'r');
fread($f, filesize($cale));<?php
$cale = __DIR__ . '/nu-exista.txt';
$continut = is_file($cale) ? file_get_contents($cale) : '';Tratezi lipsa fișierului înainte de citire.
Repară eroarea, direct în pagină
Programul numără liniile unui log, dar logul e gol și fread($f, filesize($cale)) aruncă ValueError: fread(): Argument #2 ($length) must be greater than 0. Citește fișierul cu file_get_contents, ca programul să afișeze Linii: 0.
<?php
$cale = __DIR__ . '/log.txt';
file_put_contents($cale, '');
$f = fopen($cale, 'r');
$continut = fread($f, filesize($cale));
fclose($f);
echo 'Linii: ' . substr_count($continut, "\n") . "\n";Linii: 0
Indiciu
Înlocuiește fopen + fread + fclose cu un singur file_get_contents($cale).
Reparația
<?php
$cale = __DIR__ . '/log.txt';
file_put_contents($cale, '');
$continut = file_get_contents($cale);
echo 'Linii: ' . substr_count($continut, "\n") . "\n";De ce merge
Logul era gol, deci filesize a dat 0, iar fread nu acceptă lungimea 0 din PHP 8.
file_get_contents citește tot fișierul fără să ceară o lungime; pentru un fișier gol întoarce textul gol, iar substr_count dă 0 linii.
În plus, nu mai ai nevoie de fopen și fclose: funcția deschide și închide singură fișierul.
Alte forme ale mesajului
Warning: fread(): Length parameter must be greater than 0 in index.php on line 5Fatal error: Uncaught ValueError: fgets(): Argument #2 ($length) must be greater than 0 in index.php:5PHP Fatal error: Uncaught ValueError: fread(): Argument #2 ($length) must be greater than 0 in /var/www/html/import.php:22
Cum o eviți pe viitor
- Pentru a citi un fișier întreg folosește
file_get_contents; pentru linie cu linie,file()saufgetsîn buclă. - Dacă folosești
fread, dă-i o mărime fixă de bucată (de exemplu 8192) și citește până lafeof. - Testează codul și cu un fișier gol: e un caz real (log nou, export fără date).
Întrebări frecvente
De ce codul a mers luni de zile și acum dă eroare?
Pentru că până acum fișierul a avut mereu conținut. Prima dată când a fost gol, filesize a dat 0 și fread a aruncat ValueError.
fread sau file_get_contents?
Pentru fișiere mici și medii, file_get_contents. Pentru fișiere foarte mari, citire pe bucăți cu fread($f, 8192) sau fgets în buclă, ca să nu încarci totul în memorie.
Erori înrudite
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. Warning: filesize(): stat failed for /var/www/html/export.csv in index.php on line 3 filesize() (sau filemtime(), is_writable...) nu găsește fișierul de la calea dată: nu există încă, numele e greșit sau calea e relativă la alt director. Funcția întoarce false. Verifică întâi cu is_file($cale) și folosește căi absolute cu __DIR__. Fatal error: Uncaught ValueError: array_chunk(): Argument #2 ($length) must be greater than 0 in index.php:5 Ai cerut lui array_chunk() să împartă tabloul în bucăți de 0 elemente (sau mai puțin), de obicei pentru că numărul de elemente pe pagină vine din URL sau din setări și e 0, gol sau negativ. Validează valoarea și folosește un minim: max(1, (int) $pePagina). Î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.
