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';.
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
<?php
// src/db.php
require 'config.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
<?php
require __DIR__ . '/Config.php'; // fișierul e config.php<?php
require __DIR__ . '/config.php';Pe Linux numele fișierelor țin cont de majuscule, deci Config.php nu există.
3Fișier opțional
<?php
require __DIR__ . '/config.local.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ă 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.
<?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";Bază de date: magazin Mod: producție
Indiciu
is_file(__DIR__ . '/config.local.php') îți spune dacă fișierul există înainte de require.
Reparația
<?php
$config = ['db' => 'magazin', 'mod' => 'producție'];
$local = __DIR__ . '/config.local.php';
if (is_file($local)) {
$config = array_merge($config, require $local);
}
echo "Bază de date: {$config['db']}\n";
echo "Mod: {$config['mod']}\n";De ce merge
require cere ca fișierul să existe: dacă nu-l găsește, afișează Failed to open stream și apoi oprește scriptul cu eroare fatală. Pentru un fișier de setări locale, lipsa lui e normală, deci nu trebuie să oprească aplicația.
__DIR__ dă folderul scriptului curent, așa că $local e o cale absolută, corectă oricare ar fi folderul de lucru. is_file() verifică existența, iar require se execută doar dacă fișierul e acolo. Un fișier de configurare poate întoarce un tablou cu return [...], pe care array_merge îl combină cu valorile implicite.
Alte forme ale mesajului
Fatal error: Uncaught Error: Failed opening required 'config.php' (include_path='.:/usr/share/php') in index.php:2Warning: include(header.php): Failed to open stream: No such file or directory in index.php on line 5Warning: require(vendor/autoload.php): Failed to open stream: No such file or directory in index.php on line 3Warning: 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 installdupă 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
requirepentru fișiere indispensabile șiincludedoar 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
Warning: Cannot modify header information - headers already sent by (output started at index.php:3) in index.php on line 6 Apelezi header() (sau setcookie, session_start) după ce scriptul a trimis deja ceva către browser: un echo, HTML, un spațiu sau o linie goală înainte de <?php. Mută header() înaintea oricărei afișări; locul afișării e cel din output started at. Fatal error: Uncaught Error: Class "Produs" not found in index.php:9 PHP nu găsește definiția clasei: numele e scris greșit, fișierul clasei nu e inclus (sau autoload-ul Composer nu e configurat), ori clasa e într-un namespace și lipsește use. Verifică numele, require-ul sau use-ul. Fatal error: Cannot redeclare function calculeazaTva() (previously declared in index.php:2) in index.php on line 7 Aceeași funcție e definită de două ori: în același fișier sau, mai des, pentru că un fișier cu funcții e inclus de două ori. Folosește require_once în loc de require sau include, ori redenumește una dintre funcții. Î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.
