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

Fatal error: Uncaught TypeError: fwrite(): Argument #1 ($stream) must be of type resource, bool given in index.php:4

Pe scurt

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ă

Greșit
PHP
<?php
$f = fopen(__DIR__ . '/loguri/app.log', 'a');
fwrite($f, "pornit\n");
Corect
PHP
<?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

Greșit
PHP
<?php
$f = fopen($cale, 'r');
while (($linie = fgets($f)) !== false) {
    echo $linie;
}
Corect
PHP
<?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

Greșit
PHP
<?php
$f = fopen('php://memory', 'r');
fwrite($f, 'test');
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?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";
După reparație, programul afișează
Linii în log: 2
Indiciu

Înainte de fopen, creează folderul cu mkdir($dir, 0775, true) dacă is_dir($dir) e false.

Alte forme ale mesajului

  • Fatal error: Uncaught TypeError: fwrite(): Argument #1 ($stream) must be of type resource, false given in index.php:4
  • Fatal error: Uncaught TypeError: fgets(): Argument #1 ($stream) must be of type resource, bool given in index.php:4
  • Fatal error: Uncaught TypeError: fclose(): Argument #1 ($stream) must be of type resource, bool given in index.php:6
  • Warning: 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

← 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.