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

Fatal error: Uncaught ValueError: Path cannot be empty in index.php:4

Pe scurt

Ai dat unei funcții de fișiere (file_get_contents, fopen, file, file_put_contents) un text gol în loc de cale, de obicei pentru că variabila cu numele fișierului vine dintr-o setare, un câmp de formular sau o variabilă de mediu care lipsește. Verifică valoarea înainte: if ($cale === '') și folosește o cale implicită sau oprește-te cu un mesaj clar.

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

Ce înseamnă

Funcțiile care lucrează cu fișiere au nevoie de o cale. Un text gol nu indică niciun fișier, așa că din PHP 8 primești ValueError: Path cannot be empty (în PHP 7 era doar un warning, Filename cannot be empty, iar funcția întorcea false). În versiunile mai noi mesajul e Path must not be empty.

Calea nu e aproape niciodată scrisă gol direct în cod. Vine de obicei din:

  • o variabilă de mediu sau o setare lipsă: getenv('LOG_FILE') întoarce false, care devine '';
  • $_FILES['poza']['tmp_name'] gol, când upload-ul a eșuat;
  • un câmp de formular gol sau o cheie lipsă citită cu ?? '';
  • o concatenare în care toate bucățile sunt goale.

Mesajul arată linia apelului. Afișează valoarea căii (var_dump($cale)) chiar înainte, ca să vezi de unde vine golul.

De ce apare: cauzele frecvente

1Setare de mediu lipsă

Greșit
PHP
<?php
$log = (string) getenv('FISIER_LOG');
file_put_contents($log, "pornit\n", FILE_APPEND);
Corect
PHP
<?php
$log = getenv('FISIER_LOG') ?: sys_get_temp_dir() . '/app.log';
file_put_contents($log, "pornit\n", FILE_APPEND);

?: alege valoarea implicită când variabila de mediu lipsește sau e goală.

2Upload eșuat

Greșit
PHP
<?php
$tmp = $_FILES['poza']['tmp_name'] ?? '';
$continut = file_get_contents($tmp);
Corect
PHP
<?php
$f = $_FILES['poza'] ?? null;
if ($f === null || $f['error'] !== UPLOAD_ERR_OK) {
    exit('Upload eșuat');
}
$continut = file_get_contents($f['tmp_name']);

Când upload-ul eșuează (de ex. fișierul e prea mare), tmp_name e gol. Verifică întâi error.

Repară tu

Repară eroarea, direct în pagină

Funcția citesteSablon citește un fișier de șablon al cărui nume vine din setări, dar pentru setarea goală se oprește cu Uncaught ValueError: Path cannot be empty. Repară funcția, ca un nume gol să însemne șablonul implicit (textul Bună, {nume}!), iar programul să afișeze Bună, Ana! de două ori.

Codul care dă eroarea
PHP
<?php
function citesteSablon(string $fisier): string
{
    if ($fisier !== '' && !is_file($fisier)) {
        return 'Bună, {nume}!';
    }
    return file_get_contents($fisier);
}

$cale = sys_get_temp_dir() . '/sablon-ap-salut.txt';
file_put_contents($cale, 'Bună, {nume}!');

foreach ([$cale, ''] as $fisier) {
    echo str_replace('{nume}', 'Ana', citesteSablon($fisier)) . "\n";
}
După reparație, programul afișează
Bună, Ana!
Bună, Ana!
Indiciu

Verifică dacă $fisier e '' înainte de file_get_contents și întoarce șablonul implicit.

Alte forme ale mesajului

  • Fatal error: Uncaught ValueError: Path must not be empty in index.php:4
  • Warning: file_get_contents(): Filename cannot be empty in index.php on line 4
  • Warning: fopen(): Filename cannot be empty in index.php on line 4

Cum o eviți pe viitor

  • Citește setările (căi, nume de fișiere) într-un singur loc, la pornirea aplicației, și oprește-te cu un mesaj clar dacă lipsește ceva obligatoriu.
  • Dă valori implicite rezonabile pentru căile opționale.
  • La upload-uri, verifică mereu $_FILES[...]['error'] înainte să atingi fișierul.

Întrebări frecvente

De ce (string) getenv() dă un text gol?

getenv() întoarce false dacă variabila nu există, iar (string) false e ''. Folosește getenv('X') ?: 'implicit' sau verifică explicit === false.

Ce diferență e față de Failed to open stream?

Failed to open stream înseamnă că ai dat o cale, dar fișierul nu poate fi deschis (nu există, lipsesc drepturi). Path cannot be empty înseamnă că nu ai dat nicio cale.

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.