Fatal error: Uncaught TypeError: fwrite(): Argument #1 ($stream) must be of type resource, bool given in index.php:4
fopen() nu a putut deschide fișierul și a întors false, iar tu ai dat acel false mai departe lui fwrite() (sau fgets, fclose). Eroarea reală e mai sus, la fopen: de obicei folderul nu există sau lipsesc drepturile. Verifică rezultatul lui fopen și repară calea.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
fopen() întoarce un resource (un „mâner” spre fișierul deschis) când reușește și false când nu reușește. Mesajul spune că fwrite() a primit ca prim argument ($stream) un bool, adică acel false. În PHP 8 asta e TypeError; în PHP 7 era doar un warning (fwrite() expects parameter 1 to be resource, bool given), iar scriptul mergea mai departe fără să scrie nimic. Din PHP 8.5 mesajul spune false given.
Cauza adevărată e deci la fopen(), care a afișat înainte un warning de tipul Failed to open stream: No such file or directory sau Permission denied. Uită-te la primul mesaj, nu la ultimul.
Situații tipice: scrii un log sau un export într-un folder care nu există încă, calea e relativă și pornește din alt folder, sau serverul web nu are drept de scriere acolo.
De ce apare: cauzele frecvente
1Folderul pentru log nu există
<?php
$f = fopen(__DIR__ . '/loguri/app.log', 'a');
fwrite($f, "pornit\n");<?php
$dir = __DIR__ . '/loguri';
if (!is_dir($dir)) {
mkdir($dir, 0775, true);
}
$f = fopen($dir . '/app.log', 'a');
fwrite($f, "pornit\n");fopen cu modul a creează fișierul, dar nu și folderul. Îl creezi înainte cu mkdir.
2Rezultatul lui fopen neverificat
<?php
$f = fopen($cale, 'r');
while (($linie = fgets($f)) !== false) {
echo $linie;
}<?php
$f = fopen($cale, 'r');
if ($f === false) {
throw new RuntimeException("Nu pot deschide $cale");
}
while (($linie = fgets($f)) !== false) {
echo $linie;
}Verificarea transformă un TypeError confuz într-un mesaj care spune exact ce fișier lipsește.
3Fișierul deschis doar pentru citire
<?php
$f = fopen('php://memory', 'r');
fwrite($f, 'test');<?php
$f = fopen('php://memory', 'w+');
fwrite($f, 'test');Aici fopen reușește, dar modul r nu permite scrierea, iar fwrite întoarce false fără să scrie. Alege modul potrivit: w, a, w+.
Repară eroarea, direct în pagină
Funcția scrieLog adaugă o linie într-un fișier de log aflat într-un folder care încă nu există, iar programul se oprește cu Uncaught TypeError: fwrite(): Argument #1 ($stream) must be of type resource, bool given. Repară funcția, ca folderul să fie creat dacă lipsește, iar programul să afișeze Linii în log: 2.
<?php
function scrieLog(string $dir, string $mesaj): void
{
$f = fopen($dir . '/app.log', 'a');
fwrite($f, $mesaj . "\n");
fclose($f);
}
$dir = sys_get_temp_dir() . '/ap-log-' . getmypid();
scrieLog($dir, 'pornit');
scrieLog($dir, 'comandă nouă');
echo 'Linii în log: ' . count(file($dir . '/app.log')) . "\n";Linii în log: 2
Indiciu
Înainte de fopen, creează folderul cu mkdir($dir, 0775, true) dacă is_dir($dir) e false.
Reparația
<?php
function scrieLog(string $dir, string $mesaj): void
{
if (!is_dir($dir)) {
mkdir($dir, 0775, true);
}
$f = fopen($dir . '/app.log', 'a');
fwrite($f, $mesaj . "\n");
fclose($f);
}
$dir = sys_get_temp_dir() . '/ap-log-' . getmypid();
scrieLog($dir, 'pornit');
scrieLog($dir, 'comandă nouă');
echo 'Linii în log: ' . count(file($dir . '/app.log')) . "\n";De ce merge
fopen nu poate crea fișierul într-un folder inexistent: a afișat Failed to open stream și a întors false. fwrite(false, ...) a aruncat apoi TypeError, pentru că nu avea niciun fișier deschis în care să scrie.
Cu mkdir($dir, 0775, true), folderul (și eventualele foldere intermediare) e creat la primul apel. Al doilea apel îl găsește deja și doar adaugă linia, deci fișierul are două linii.
Alte forme ale mesajului
Fatal error: Uncaught TypeError: fwrite(): Argument #1 ($stream) must be of type resource, false given in index.php:4Fatal error: Uncaught TypeError: fgets(): Argument #1 ($stream) must be of type resource, bool given in index.php:4Fatal error: Uncaught TypeError: fclose(): Argument #1 ($stream) must be of type resource, bool given in index.php:6Warning: fwrite() expects parameter 1 to be resource, boolean given in index.php on line 4
Cum o eviți pe viitor
- Verifică mereu rezultatul lui
fopen()înainte să folosești fișierul. - Creează folderele necesare la instalare sau înainte de prima scriere (
mkdir($dir, 0775, true)). - Pentru scrieri simple,
file_put_contents($cale, $text, FILE_APPEND | LOCK_EX)face deschiderea, scrierea și închiderea într-un singur pas.
Întrebări frecvente
De ce eroarea e la fwrite, dacă problema e la fopen?
Pentru că fopen doar afișează un warning și întoarce false; scriptul merge mai departe. Eroarea fatală apare abia la prima funcție care are nevoie de fișierul deschis.
Ce înseamnă resource?
Un tip special care ține legătura cu o resursă externă: un fișier deschis, o conexiune. Îl primești de la fopen, opendir, curl_init (în versiunile vechi) și îl dai mai departe funcțiilor care lucrează cu acea resursă.
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. Fatal error: Uncaught TypeError: fclose(): supplied resource is not a valid stream resource in index.php:9 Fișierul a fost deja închis, iar acum încerci să-l folosești sau să-l închizi din nou, de obicei pentru că și o funcție ajutătoare, și codul principal apelează fclose(). Închide fișierul într-un singur loc (ideal în finally) și nu-l mai folosi după fclose(). 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); }. Î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.
