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

Fatal error: Uncaught ValueError: fread(): Argument #2 ($length) must be greater than 0 in index.php:5

Pe scurt

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

Greșit
PHP
<?php
$f = fopen(__DIR__ . '/log.txt', 'w+');
echo fread($f, filesize(__DIR__ . '/log.txt'));
Corect
PHP
<?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

Greșit
PHP
<?php
$f = fopen('php://memory', 'r+');
$bucata = 0;
fread($f, $bucata);
Corect
PHP
<?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

Greșit
PHP
<?php
$cale = __DIR__ . '/nu-exista.txt';
$f = @fopen($cale, 'r');
fread($f, filesize($cale));
Corect
PHP
<?php
$cale = __DIR__ . '/nu-exista.txt';
$continut = is_file($cale) ? file_get_contents($cale) : '';

Tratezi lipsa fișierului înainte de citire.

Repară tu

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.

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

Înlocuiește fopen + fread + fclose cu un singur file_get_contents($cale).

Alte forme ale mesajului

  • Warning: fread(): Length parameter must be greater than 0 in index.php on line 5
  • Fatal error: Uncaught ValueError: fgets(): Argument #2 ($length) must be greater than 0 in index.php:5
  • PHP 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() sau fgets în buclă.
  • Dacă folosești fread, dă-i o mărime fixă de bucată (de exemplu 8192) și citește până la feof.
  • 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

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