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

Warning: scandir(uploads): Failed to open directory: No such file or directory in index.php on line 3

Pe scurt

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.

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

Ce înseamnă

scandir($dir) întoarce lista de fișiere și directoare dintr-un director. Dacă nu poate deschide directorul, afișează două Warning-uri: scandir(uploads): Failed to open directory: No such file or directory și scandir(): (errno 2): No such file or directory, apoi întoarce false.

Problemele continuă pe liniile următoare: foreach (scandir(...) as $f) dă foreach() argument must be of type array|object, bool given, iar count(false) aruncă TypeError. De aceea e important să tratezi rezultatul.

Cauze: directorul încă nu a fost creat (prima rulare a aplicației, primul upload), calea e relativă la alt director curent, numele are altă capitalizare (pe Linux Uploads ≠ uploads) sau aplicația a fost mutată. Dacă directorul există, dar nu ai drept de citire, mesajul se termină cu Permission denied. La opendir() mesajul e asemănător: opendir(uploads): Failed to open directory.

De ce apare: cauzele frecvente

1Director care poate să nu existe

Greșit
PHP
<?php
foreach (scandir(__DIR__ . '/uploads') as $f) {
    echo $f;
}
Corect
PHP
<?php
$dir = __DIR__ . '/uploads';
$fisiere = is_dir($dir) ? array_diff(scandir($dir), ['.', '..']) : [];
foreach ($fisiere as $f) {
    echo $f;
}

Dacă directorul lipsește, lista e goală și codul merge mai departe.

2Cale relativă

Greșit
PHP
<?php
$fisiere = scandir('uploads');
Corect
PHP
<?php
$fisiere = scandir(__DIR__ . '/uploads');

__DIR__ face calea independentă de directorul din care rulezi scriptul.

3Directorul trebuie creat la nevoie

Greșit
PHP
<?php
$fisiere = scandir(__DIR__ . '/cache');
Corect
PHP
<?php
$dir = __DIR__ . '/cache';
if (!is_dir($dir)) {
    mkdir($dir, 0775, true);
}
$fisiere = scandir($dir);

Pentru directoare pe care aplicația le folosește mereu, le creezi la prima nevoie.

Repară tu

Repară eroarea, direct în pagină

Funcția listaPoze afișează pozele încărcate de un utilizator, dar pentru un utilizator nou (fără director) afișează Warning: scandir(...): Failed to open directory: No such file or directory. Repară funcția (dacă directorul nu există, întoarce tablou gol), ca programul să afișeze ana: poza1.jpg și mihai: nicio poză.

Codul care dă eroarea
PHP
<?php
function listaPoze(string $user): array
{
    $dir = __DIR__ . "/uploads-$user";
    return array_values(array_diff(scandir($dir), ['.', '..']));
}

$dirAna = __DIR__ . '/uploads-ana';
if (!is_dir($dirAna)) {
    mkdir($dirAna);
}
file_put_contents("$dirAna/poza1.jpg", 'imagine');
foreach (['ana', 'mihai'] as $u) {
    $poze = listaPoze($u);
    echo "$u: " . ($poze ? implode(', ', $poze) : 'nicio poză') . "\n";
}
După reparație, programul afișează
ana: poza1.jpg
mihai: nicio poză
Indiciu

Folosește is_dir înainte de scandir.

Alte forme ale mesajului

  • Warning: scandir(): (errno 2): No such file or directory in index.php on line 3
  • Warning: scandir(/var/www/html/uploads): Failed to open directory: Permission denied in index.php on line 3
  • Warning: opendir(uploads): Failed to open directory: No such file or directory in index.php on line 3
  • Warning: scandir(uploads): failed to open dir: No such file or directory in index.php on line 3

Cum o eviți pe viitor

  • Verifică is_dir înainte de scandir, opendir sau glob pe directoare care pot lipsi.
  • Pune căile de bază într-o constantă (const UPLOADS = __DIR__ . '/uploads';) și folosește-o peste tot.
  • Nu uita că scandir include . și ..; scoate-le cu array_diff.
  • Pentru căutare după tipar (*.jpg), glob întoarce un tablou gol când nu găsește nimic, fără Warning.

Întrebări frecvente

De ce primesc două Warning-uri pentru aceeași problemă?

Primul vine de la deschiderea directorului (cu calea), al doilea de la scandir însuși, cu codul de eroare al sistemului (errno 2 = fișier sau director inexistent). Cauza e aceeași.

glob sau scandir?

glob('uploads/*.jpg') e comod pentru filtrare după nume și nu dă Warning dacă directorul lipsește (întoarce []), dar ignoră fișierele ascunse. scandir arată tot și îți spune când directorul nu există.

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.