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

Warning: filesize(): stat failed for /var/www/html/export.csv in index.php on line 3

Pe scurt

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

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

stat e apelul de sistem care citește informațiile unui fișier (mărime, dată, drepturi). Funcțiile filesize, filemtime, fileperms, fileowner îl folosesc, iar când fișierul nu există sau nu poate fi accesat afișează stat failed for <cale> și întorc false.

Calea din mesaj e exact cea pe care a primit-o funcția, deci compar-o cu ce există pe disc. Cauzele obișnuite:

  • fișierul nu a fost încă creat (ordinea operațiilor e greșită);
  • calea e relativă, iar directorul curent nu e cel la care te gândești (cron, CLI, include din alt director);
  • numele are altă literă mare/mică (pe Linux Export.csv ≠ export.csv).

Pentru că funcția întoarce false, un echo filesize(...) afișează nimic, iar un calcul cu rezultatul dă 0 în tăcere.

De ce apare: cauzele frecvente

1Citești mărimea înainte să scrii fișierul

Greșit
PHP
<?php
$f = __DIR__ . '/export.csv';
echo filesize($f);
file_put_contents($f, 'id,total');
Corect
PHP
<?php
$f = __DIR__ . '/export.csv';
file_put_contents($f, 'id,total');
echo filesize($f);

Fișierul există în momentul în care îi ceri mărimea.

2Cale relativă rulată din alt director

Greșit
PHP
<?php
echo filesize('uploads/poza.jpg');
Corect
PHP
<?php
$cale = __DIR__ . '/uploads/poza.jpg';
echo is_file($cale) ? filesize($cale) : 0;

__DIR__ face calea independentă de directorul curent, iar is_file tratează lipsa fișierului.

3Cache-ul stat după modificare

Greșit
PHP
<?php
$f = __DIR__ . '/log.txt';
file_put_contents($f, 'a');
filesize($f);
file_put_contents($f, 'abc', FILE_APPEND);
echo filesize($f);
Corect
PHP
<?php
$f = __DIR__ . '/log.txt';
file_put_contents($f, 'a');
filesize($f);
file_put_contents($f, 'abc', FILE_APPEND);
clearstatcache(true, $f);
echo filesize($f);

Nu e aceeași eroare, dar e problema-soră: PHP ține minte rezultatul stat; clearstatcache îl reîmprospătează.

Repară tu

Repară eroarea, direct în pagină

Programul afișează mărimea unui export CSV înainte să-l scrie și dă Warning: filesize(): stat failed for .... Repară ordinea și verifică existența fișierului cu is_file, ca programul să afișeze Mărime: 15 bytes.

Codul care dă eroarea
PHP
<?php
$fisier = __DIR__ . '/export.csv';
echo 'Mărime: ' . filesize($fisier) . " bytes\n";
file_put_contents($fisier, "id,total\n1,250\n");
După reparație, programul afișează
Mărime: 15 bytes
Indiciu

Scrie fișierul întâi, apoi citește-i mărimea.

Alte forme ale mesajului

  • Warning: filemtime(): stat failed for cache/pagina.html in index.php on line 5
  • Warning: fileperms(): stat failed for config.php in index.php on line 3
  • PHP Warning: filesize(): stat failed for /var/www/html/uploads/poza.jpg in /var/www/html/upload.php on line 18

Cum o eviți pe viitor

  • Verifică existența cu is_file($cale) înainte de filesize / filemtime.
  • Construiește căile cu __DIR__ sau o constantă de bază a proiectului.
  • Tratează rezultatul false explicit: $m = filesize($f); if ($m === false) { ... }.
  • După ce modifici un fișier în același script, apelează clearstatcache() înainte să-i citești din nou mărimea.

Întrebări frecvente

De ce filesize întoarce o valoare veche?

PHP păstrează în cache rezultatul stat pe durata scriptului. Apelează clearstatcache(true, $cale) după ce ai scris în fișier.

Fișierul există, dar tot primesc eroarea.

Verifică drepturile directoarelor de pe cale (procesul PHP trebuie să le poată parcurge) și open_basedir, care poate bloca accesul în afara directoarelor permise.

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.