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

Warning: unlink(poze/vechi.jpg): No such file or directory in index.php on line 4

Pe scurt

Ai încercat să ștergi un fișier care nu există la calea dată: a fost deja șters, numele sau directorul e greșit, ori calea e relativă la alt director decât crezi. Verifică întâi cu is_file($cale) și construiește calea cu __DIR__.

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

Ce înseamnă

unlink($cale) șterge un fișier. Dacă la calea respectivă nu e niciun fișier, afișează acest Warning și întoarce false. Calea din paranteze e exact cea primită, deci primul pas e să o compari cu ce există pe disc.

Cauze frecvente:

  • fișierul a fost deja șters (de alt proces, de un cron, de un clic dublu pe „Șterge”);
  • calea e relativă (poze/vechi.jpg), iar directorul curent al scriptului nu e cel pe care îl crezi (în CLI e directorul din care rulezi comanda, nu cel al scriptului);
  • numele din baza de date nu corespunde cu cel de pe disc (litere mari / mici pe Linux, extensie diferită);
  • ai trimis un director: pentru directoare se folosește rmdir.

Dacă fișierul există, dar nu ai drept să-l ștergi, mesajul e unlink(...): Permission denied.

De ce apare: cauzele frecvente

1Fișierul poate lipsi

Greșit
PHP
<?php
unlink(__DIR__ . '/poze/vechi.jpg');
Corect
PHP
<?php
$cale = __DIR__ . '/poze/vechi.jpg';
if (is_file($cale)) {
    unlink($cale);
}

Ștergi doar dacă fișierul există; altfel nu e nimic de făcut.

2Cale relativă la directorul greșit

Greșit
PHP
<?php
unlink('cache/pagina.html');
Corect
PHP
<?php
unlink(__DIR__ . '/cache/pagina.html');

__DIR__ e directorul fișierului PHP curent, indiferent de unde e rulat scriptul.

3Ai trimis un director

Greșit
PHP
<?php
unlink(__DIR__ . '/arhiva');
Corect
PHP
<?php
rmdir(__DIR__ . '/arhiva');

Pentru un director, unlink dă Is a directory sau Operation not permitted; folosește rmdir (după ce îl golești).

Repară tu

Repară eroarea, direct în pagină

Funcția stergeAvatar șterge poza veche a unui utilizator, dar pentru un utilizator care nu are poză afișează Warning: unlink(...): No such file or directory. Repară funcția (șterge doar dacă fișierul există și întoarce false altfel), ca programul să afișeze avatar-1.png: șters și avatar-2.png: nu exista.

Codul care dă eroarea
PHP
<?php
function stergeAvatar(string $fisier): bool
{
    $cale = __DIR__ . '/' . $fisier;
    return unlink($cale);
}

file_put_contents(__DIR__ . '/avatar-1.png', 'imagine');
foreach (['avatar-1.png', 'avatar-2.png'] as $f) {
    echo $f . ': ' . (stergeAvatar($f) ? 'șters' : 'nu exista') . "\n";
}
După reparație, programul afișează
avatar-1.png: șters
avatar-2.png: nu exista
Indiciu

Verifică întâi cu is_file($cale).

Alte forme ale mesajului

  • Warning: unlink(/var/www/html/uploads/avatar-15.png): No such file or directory in index.php on line 8
  • Warning: unlink(cache/pagina.html): Permission denied in index.php on line 4
  • Warning: unlink(arhiva): Is a directory in index.php on line 4

Cum o eviți pe viitor

  • Construiește căile cu __DIR__ sau cu o constantă de bază (BASE_PATH), nu relativ.
  • Înainte de ștergere, is_file($cale); după, poți verifica rezultatul lui unlink.
  • Nu folosi @unlink(...) ca să ascunzi Warning-ul: ascunde și erorile reale (permisiuni).
  • Când ștergi fișiere după nume venite din cereri, validează numele (basename) ca să nu poată ieși din director (../).

Întrebări frecvente

De ce merge în browser, dar nu din linia de comandă (sau invers)?

Directorul curent diferă: pe server web e de obicei directorul scriptului, în CLI e directorul din care rulezi php. Cu __DIR__ calea e aceeași în ambele cazuri.

E o problemă dacă fișierul nu există?

Depinde. La curățarea unui cache, „deja șters” e un rezultat bun: verifici cu is_file și treci mai departe. La ștergerea unui fișier pe care îl aștepți (de ex. un upload), lipsa lui indică un bug: loghează-l.

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.