Fatal error: Uncaught ValueError: Path cannot be empty in index.php:4
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')întoarcefalse, 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ă
<?php
$log = (string) getenv('FISIER_LOG');
file_put_contents($log, "pornit\n", FILE_APPEND);<?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
<?php
$tmp = $_FILES['poza']['tmp_name'] ?? '';
$continut = file_get_contents($tmp);<?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ă 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.
<?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";
}Bună, Ana! Bună, Ana!
Indiciu
Verifică dacă $fisier e '' înainte de file_get_contents și întoarce șablonul implicit.
Reparația
<?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";
}De ce merge
Condiția din codul stricat trata doar fișierele inexistente cu nume, iar textul gol ajungea la file_get_contents(''). O cale goală nu indică niciun fișier, așa că PHP 8 aruncă ValueError.
Cu $fisier === '' || !is_file($fisier), ambele cazuri (fără nume, sau numele unui fișier care nu există) duc la șablonul implicit. Primul apel citește șablonul scris pe disc, al doilea îl folosește pe cel implicit; rezultatul e același text.
Alte forme ale mesajului
Fatal error: Uncaught ValueError: Path must not be empty in index.php:4Warning: file_get_contents(): Filename cannot be empty in index.php on line 4Warning: 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
Warning: file_get_contents(produse.csv): Failed to open stream: No such file or directory in index.php on line 3 Fișierul pe care vrei să-l citești nu există la calea dată, de obicei pentru că o cale relativă e calculată față de folderul de lucru, nu față de script. Folosește o cale absolută cu __DIR__ (__DIR__ . '/date/produse.csv') și verifică is_file() înainte, ca să tratezi lipsa fișierului. Warning: require(config.php): Failed to open stream: No such file or directory in index.php on line 2 PHP nu găsește fișierul pe care îl incluzi cu require sau include, de obicei pentru că o cale relativă e rezolvată față de alt folder decât crezi. Folosește o cale absolută pornind de la __DIR__: require __DIR__ . '/config.php';. Fatal error: Uncaught ValueError: explode(): Argument #1 ($separator) cannot be empty in index.php:3 Ai apelat explode() cu separatorul '' (text gol), de obicei ca să împarți un cuvânt în litere. explode nu poate tăia „între” caractere. Folosește str_split($text) sau, pentru diacritice, mb_str_split($text). Î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.
