Fatal error: Uncaught UnexpectedValueException: RecursiveDirectoryIterator::__construct(/var/www/html/uploads): Failed to open directory: No such file or directory in index.php:4
RecursiveDirectoryIterator (sau DirectoryIterator, FilesystemIterator) nu poate deschide directorul dat: nu există, calea e greșită sau PHP nu are drept de citire. Spre deosebire de scandir(), aruncă excepție. Verifică cu is_dir() înainte sau prinde UnexpectedValueException.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Iteratoarele SPL pentru directoare (DirectoryIterator, FilesystemIterator, RecursiveDirectoryIterator) deschid directorul chiar în constructor. Dacă nu reușesc, aruncă UnexpectedValueException cu mesajul sistemului de operare: Failed to open directory: No such file or directory (nu există) sau Permission denied (nu ai drept de citire).
Calea din paranteză e exact cea primită, deci o poți compara direct cu structura de pe disc. Cauzele obișnuite: un director de upload-uri care se creează abia la primul upload, o cale relativă rulată din alt director (cron, CLI), un subdirector fără drepturi într-o parcurgere recursivă.
Atenție: o excepție în mijlocul unei parcurgeri recursive oprește tot. Pentru subdirectoare fără drept de citire există flagul RecursiveIteratorIterator::CATCH_GET_CHILD, care le sare.
De ce apare: cauzele frecvente
1Directorul nu a fost creat încă
<?php
$it = new RecursiveDirectoryIterator(__DIR__ . '/uploads');<?php
$dir = __DIR__ . '/uploads';
if (is_dir($dir)) {
$it = new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS);
}Construiești iteratorul doar dacă directorul există.
2Cale relativă în cron sau CLI
<?php
foreach (new DirectoryIterator('logs') as $f) {
echo $f->getFilename();
}<?php
foreach (new DirectoryIterator(__DIR__ . '/logs') as $f) {
echo $f->getFilename();
}Cronul rulează din alt director curent; __DIR__ dă calea scriptului.
3Subdirector fără drepturi
<?php
$it = new RecursiveIteratorIterator(new RecursiveDirectoryIterator('/var/www'));<?php
$it = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator('/var/www', FilesystemIterator::SKIP_DOTS),
RecursiveIteratorIterator::LEAVES_ONLY,
RecursiveIteratorIterator::CATCH_GET_CHILD
);CATCH_GET_CHILD sare subdirectoarele care nu pot fi deschise, în loc să oprească parcurgerea.
Repară eroarea, direct în pagină
Scriptul calculează spațiul ocupat de directorul uploads/, dar directorul nu există încă și programul se oprește cu UnexpectedValueException: RecursiveDirectoryIterator::__construct(...): Failed to open directory. Repară-l: dacă directorul lipsește, totalul e 0, iar programul afișează Total: 0 bytes.
<?php
$dir = __DIR__ . '/uploads';
$total = 0;
$it = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS));
foreach ($it as $fisier) {
$total += $fisier->getSize();
}
echo "Total: $total bytes\n";Total: 0 bytes
Indiciu
Construiește iteratorul doar dacă is_dir($dir) e adevărat.
Reparația
<?php
$dir = __DIR__ . '/uploads';
$total = 0;
if (is_dir($dir)) {
$it = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS));
foreach ($it as $fisier) {
$total += $fisier->getSize();
}
}
echo "Total: $total bytes\n";De ce merge
RecursiveDirectoryIterator deschide directorul chiar în constructor. Cum uploads/ nu exista, a aruncat UnexpectedValueException și scriptul s-a oprit.
Cu is_dir înainte, parcurgerea are loc doar când directorul există; altfel totalul rămâne 0, iar programul afișează rezultatul corect pentru un director gol sau inexistent.
Alte forme ale mesajului
Fatal error: Uncaught UnexpectedValueException: DirectoryIterator::__construct(logs): Failed to open directory: No such file or directory in index.php:3Fatal error: Uncaught UnexpectedValueException: RecursiveDirectoryIterator::__construct(/var/www/html/privat): Failed to open directory: Permission denied in index.php:4Fatal error: Uncaught UnexpectedValueException: FilesystemIterator::__construct(uploads): Failed to open directory: No such file or directory in index.php:3
Cum o eviți pe viitor
- Verifică
is_dir($dir)înainte să creezi iteratorul, sau prindeUnexpectedValueException. - Construiește căile cu
__DIR__sau o constantă a proiectului. - La parcurgeri recursive pe directoare mari, folosește
CATCH_GET_CHILDșiSKIP_DOTS. - Creează directoarele aplicației (uploads, cache, logs) la instalare sau deploy.
Întrebări frecvente
De ce scandir() dădea doar Warning, iar iteratorul oprește scriptul?
Funcțiile vechi întorc false și afișează Warning; clasele SPL aruncă excepții. Excepția e mai ușor de tratat corect, cu try/catch.
Cum calculez mărimea totală a unui director?
Parcurgi cu RecursiveIteratorIterator peste RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS) și aduni $fisier->getSize() pentru fiecare fișier.
Erori înrudite
Warning: scandir(uploads): Failed to open directory: No such file or directory in index.php on line 3 Directorul dat lui scandir() nu există la calea aceea (nume greșit, cale relativă la alt director, director încă necreat). scandir afișează Warning-ul și întoarce false, iar foreach pe false dă alt Warning. Verifică întâi cu is_dir($dir) și folosește __DIR__ în cale. Fatal error: Uncaught RuntimeException: SplFileObject::__construct(/var/www/html/comenzi.csv): Failed to open stream: No such file or directory in index.php:5 SplFileObject nu poate deschide fișierul dat: nu există la acea cale, numele e greșit sau lipsesc drepturile. Spre deosebire de fopen(), aruncă RuntimeException. Verifică calea (de obicei e greșit directorul) cu is_file() sau prinde excepția. Warning: mkdir(): File exists in index.php on line 4 Folderul pe care vrei să-l creezi există deja (sau există un fișier cu același nume). mkdir() nu suprascrie, ci afișează warning-ul și întoarce false. Creează folderul doar dacă lipsește: if (!is_dir($dir)) { mkdir($dir, 0775, true); }. Î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.
