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

Fatal error: Uncaught UnexpectedValueException: RecursiveDirectoryIterator::__construct(/var/www/html/uploads): Failed to open directory: No such file or directory in index.php:4

Pe scurt

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ă

Greșit
PHP
<?php
$it = new RecursiveDirectoryIterator(__DIR__ . '/uploads');
Corect
PHP
<?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

Greșit
PHP
<?php
foreach (new DirectoryIterator('logs') as $f) {
    echo $f->getFilename();
}
Corect
PHP
<?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

Greșit
PHP
<?php
$it = new RecursiveIteratorIterator(new RecursiveDirectoryIterator('/var/www'));
Corect
PHP
<?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ă tu

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.

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

Construiește iteratorul doar dacă is_dir($dir) e adevărat.

Alte forme ale mesajului

  • Fatal error: Uncaught UnexpectedValueException: DirectoryIterator::__construct(logs): Failed to open directory: No such file or directory in index.php:3
  • Fatal error: Uncaught UnexpectedValueException: RecursiveDirectoryIterator::__construct(/var/www/html/privat): Failed to open directory: Permission denied in index.php:4
  • Fatal 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 prinde UnexpectedValueException.
  • Construiește căile cu __DIR__ sau o constantă a proiectului.
  • La parcurgeri recursive pe directoare mari, folosește CATCH_GET_CHILD și SKIP_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

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