...
Eroare PHP · Headere, sesiuni și fișiere incluse

Warning: require(config.php): Failed to open stream: No such file or directory in index.php on line 2

Pe scurt

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';.

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

Ce înseamnă

Failed to open stream: No such file or directory înseamnă că fișierul cerut nu există la calea pe care a încercat-o PHP. La include scriptul continuă (doar avertisment), iar la require urmează imediat o eroare fatală, Failed opening required 'config.php' (include_path='.:/usr/share/php'), și scriptul se oprește.

Cea mai frecventă cauză este calea relativă. require 'config.php' nu caută neapărat lângă fișierul care face cererea: PHP încearcă folderele din include_path și folderul de lucru curent, adică folderul scriptului pornit inițial (de exemplu public/index.php). Când un fișier inclus include la rândul lui alt fișier, căile relative se strică.

Alte cauze: numele e scris greșit sau cu alte majuscule (Linux face diferența între Config.php și config.php), fișierul nu a fost urcat pe server, ori lipsește folderul vendor/ pentru că nu s-a rulat composer install. Dacă mesajul spune Permission denied, fișierul există, dar nu poate fi citit.

De ce apare: cauzele frecvente

1Cale relativă rezolvată din alt folder

Greșit
PHP
<?php
// src/db.php
require 'config.php';
Corect
PHP
<?php
// src/db.php
require __DIR__ . '/config.php';

__DIR__ este folderul fișierului curent, deci calea e corectă indiferent de unde e pornit scriptul.

2Majuscule diferite pe Linux

Greșit
PHP
<?php
require __DIR__ . '/Config.php'; // fișierul e config.php
Corect
PHP
<?php
require __DIR__ . '/config.php';

Pe Linux numele fișierelor țin cont de majuscule, deci Config.php nu există.

3Fișier opțional

Greșit
PHP
<?php
require __DIR__ . '/config.local.php';
Corect
PHP
<?php
$local = __DIR__ . '/config.local.php';
if (is_file($local)) {
    require $local;
}

Pentru fișiere care pot lipsi (setări locale), verifică existența înainte de includere.

Repară tu

Repară eroarea, direct în pagină

Scriptul încarcă setările dintr-un fișier config.local.php, care există doar pe unele calculatoare, și se oprește cu Warning: require(config.local.php): Failed to open stream urmat de Failed opening required. Încarcă fișierul doar dacă există (cu cale bazată pe __DIR__), iar altfel folosește setările implicite, ca programul să afișeze Bază de date: magazin și Mod: producție.

Codul care dă eroarea
PHP
<?php
$config = ['db' => 'magazin', 'mod' => 'producție'];

$config = array_merge($config, require 'config.local.php');

echo "Bază de date: {$config['db']}\n";
echo "Mod: {$config['mod']}\n";
După reparație, programul afișează
Bază de date: magazin
Mod: producție
Indiciu

is_file(__DIR__ . '/config.local.php') îți spune dacă fișierul există înainte de require.

Alte forme ale mesajului

  • Fatal error: Uncaught Error: Failed opening required 'config.php' (include_path='.:/usr/share/php') in index.php:2
  • Warning: include(header.php): Failed to open stream: No such file or directory in index.php on line 5
  • Warning: require(vendor/autoload.php): Failed to open stream: No such file or directory in index.php on line 3
  • Warning: require_once(config.php): Failed to open stream: Permission denied in index.php on line 2

Cum o eviți pe viitor

  • Include fișierele mereu cu cale absolută: require __DIR__ . '/../config.php';.
  • Pentru clase, folosește autoload-ul Composer în loc de zeci de require.
  • Rulează composer install după ce descarci proiectul sau îl urci pe server.
  • Scrie numele fișierelor cu litere mici și folosește exact aceeași formă în cod.
  • Folosește require pentru fișiere indispensabile și include doar pentru cele opționale.

Întrebări frecvente

Care e diferența dintre include și require?

Dacă fișierul lipsește, include dă un avertisment și scriptul continuă, iar require oprește scriptul cu eroare fatală. Variantele _once încarcă un fișier o singură dată, chiar dacă e cerut de mai multe ori.

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

Folderul de lucru curent diferă: serverul web pornește din folderul scriptului cerut, iar php script.php din terminal pornește din folderul în care te afli. Căile cu __DIR__ nu depind de folderul de lucru.

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.