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.
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
<?php
foreach (scandir(__DIR__ . '/uploads') as $f) {
echo $f;
}<?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ă
<?php
$fisiere = scandir('uploads');<?php
$fisiere = scandir(__DIR__ . '/uploads');__DIR__ face calea independentă de directorul din care rulezi scriptul.
3Directorul trebuie creat la nevoie
<?php
$fisiere = scandir(__DIR__ . '/cache');<?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ă 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ă.
<?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";
}ana: poza1.jpg mihai: nicio poză
Indiciu
Folosește is_dir înainte de scandir.
Reparația
<?php
function listaPoze(string $user): array
{
$dir = __DIR__ . "/uploads-$user";
if (!is_dir($dir)) {
return [];
}
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";
}De ce merge
Directorul uploads-mihai nu exista, deci scandir a afișat Warning-urile și a întors false. Apoi array_diff(false, ...) a aruncat TypeError, pentru că așteaptă un tablou.
Cu verificarea is_dir, utilizatorul fără director primește direct o listă goală, iar programul afișează „nicio poză”, fără avertismente.
Alte forme ale mesajului
Warning: scandir(): (errno 2): No such file or directory in index.php on line 3Warning: scandir(/var/www/html/uploads): Failed to open directory: Permission denied in index.php on line 3Warning: opendir(uploads): Failed to open directory: No such file or directory in index.php on line 3Warning: 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 descandir,opendirsauglobpe 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ă
scandirinclude.și..; scoate-le cuarray_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
Warning: foreach() argument must be of type array|object, null given in index.php on line 4 Dai lui foreach o valoare care nu e tablou sau obiect, de obicei null (o cheie lipsă sau o funcție care n-a întors nimic). Asigură-te că variabila e un tablou, de exemplu cu foreach ($x ?? [] as ...). 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); }. Warning: rmdir(arhiva): Directory not empty in index.php on line 7 rmdir() șterge doar directoare goale, iar al tău mai conține fișiere sau subdirectoare (uneori ascunse, ca .gitignore sau .DS_Store). Șterge întâi tot conținutul, apoi directorul, cu o funcție care parcurge directorul (scandir + unlink / rmdir recursiv). Î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.
